ServerConnection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public sealed class ServerConnection : Microsoft.SqlServer.Management.Common.ConnectionManager, Microsoft.SqlServer.Management.Common.ISfcConnection
type ServerConnection = class
inherit ConnectionManager
interface ISfcConnection
Public NotInheritable Class ServerConnection
Inherits ConnectionManager
Implements ISfcConnection
- Herança
- Implementações
Construtores
| Nome | Description |
|---|---|
| ServerConnection() | |
| ServerConnection(IRenewableToken) |
Cria um objeto ServerConnection que está recebendo o token. O booliano extra é usado para sobrecarregar esse construtor, pois outro construtor com cadeia de caracteres está presente. |
| ServerConnection(SqlConnection, IRenewableToken) |
Constrói um novo objeto ServerConnection |
| ServerConnection(SqlConnection, IRenewableToken) |
Constrói um novo objeto ServerConnection |
| ServerConnection(SqlConnection) |
Constrói um novo objeto ServerConnection do SqlConnection fornecido |
| ServerConnection(SqlConnection) |
Constrói um novo objeto ServerConnection do SqlConnection fornecido |
| ServerConnection(SqlConnectionInfo) | |
| ServerConnection(String, String, SecureString) | |
| ServerConnection(String, String, String) | |
| ServerConnection(String) | |
Campos
| Nome | Description |
|---|---|
| NoConnectionTimeout |
Espera infinita (Herdado de ConnectionSettings) |
Propriedades
| Nome | Description |
|---|---|
| AcceptsLogin |
Retornará true se os valores atuais de LoginSecure e Autenticação usarem a propriedade Login (Herdado de ConnectionSettings) |
| AccessToken | (Herdado de ConnectionSettings) |
| ApplicationIntent |
A intenção do aplicativo dos valores válidos da conexão é ReadWrite e ReadOnly (Herdado de ConnectionSettings) |
| ApplicationName |
O nome do aplicativo. "Gerenciamento de SQL" se nenhum nome de aplicativo tiver sido fornecido. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| Authentication |
O tipo de autenticação da conexão (Herdado de ConnectionSettings) |
| AutoDisconnectMode | (Herdado de ConnectionManager) |
| BatchSeparator |
Define o separador de lote usado pelos métodos ExecuteNonQuery. O padrão é "GO". O separador de lote não diferencia maiúsculas de minúsculas. |
| CachedQueries |
Obtém ou define um valor que indica se as instâncias de ServerConnection devem armazenar em cache os resultados da consulta |
| CapturedSql | (Herdado de ConnectionManager) |
| ConnectAsUser |
Se definido como true, a conexão será feita com as credenciais do usuário especificado. Isso assumirá a representação, no entanto, os sinalizadores do LoginSecure e os campos Logon e Senha não serão afetados. Essa configuração só é utilizável em Windows. (Herdado de ConnectionSettings) |
| ConnectAsUserName |
Especifica o usuário Windows que é usado ao criar uma conexão representada. O usuário deve ter privilégios de logon interativos. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Herdado de ConnectionSettings) |
| ConnectAsUserPassword |
Especifica a senha do usuário Windows usado ao criar uma conexão representada. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Herdado de ConnectionSettings) |
| ConnectionProtocol |
Protocolo de conexão. (Herdado de ConnectionManager) |
| ConnectionString |
A propriedade retornará o usuário especificado cadeia de conexão ou retornará o cadeia de conexão computado com base nas configurações do objeto. Se definido explicitamente, todas as propriedades no objeto ServerConnection serão preenchidas para refletir o cadeia de conexão passado. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| ConnectionType | |
| ConnectTimeout |
O tempo (em segundos) para aguardar uma conexão com o servidor antes de encerrar a tentativa e gerar uma exceção. O padrão é 30 segundos (o mesmo que Shiloh). Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| CurrentDatabase |
Retorna o contexto atual do banco de dados. (Herdado de ConnectionManager) |
| DatabaseEngineEdition |
A edição do Mecanismo de Banco de Dados (Herdado de ConnectionManager) |
| DatabaseEngineType |
Retorna o tipo de mecanismo de banco de dados de SQL Server. Exceções: ConnectionFailureException (Herdado de ConnectionManager) |
| DatabaseName |
TBD (Herdado de ConnectionSettings) |
| EncryptConnection |
se "encrypt=true" é especificado no cadeia de conexão (Herdado de ConnectionSettings) |
| FixedServerRoles |
Retorna uma enumeração que especificou a função de servidor fixa da qual o logon é membro. |
| HostNameInCertificate |
O nome do host fornecido no certificado a ser usado para validação de certificado. (Herdado de ConnectionSettings) |
| HostPlatform |
A plataforma host do servidor (Linux/Windows/etc) (Herdado de ConnectionManager) |
| InUse |
Retornará true se o objeto tiver sido conectado ao servidor pelo menos uma vez. Se for true, as alterações de propriedade não serão mais permitidas e ConnectionCannotBeChangedException será gerada quando uma propriedade for alterada. (Herdado de ConnectionManager) |
| IsContainedAuthentication |
Retornará true se o mecanismo de banco de dados for autenticado usando a autenticação contida. Exceções: ConnectionFailureException (Herdado de ConnectionManager) |
| IsForceDisconnected |
Indica que a conexão foi desconectada à força (Herdado de ConnectionManager) |
| IsOpen |
Retornará true se o objeto SqlConnection estiver conectado ao servidor. Isso só pode retornar true para conexões não em pool, pois as conexões em pool são sempre fechadas diretamente após uma operação. (Herdado de ConnectionManager) |
| LockTimeout |
LockTimeout é o tempo limite de bloqueio em segundos. O -1 padrão é por tempo indeterminado. InvalidPropertyValueException é gerado para todos os outros números negativos. O LockTimeout Positivo será multiplicado por 1000 e, em seguida, usado para a configuração "SET LOCK_TIMEOUT". (Herdado de ConnectionManager) |
| Login |
O SQL Server nome de logon usado para se conectar ao servidor. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Herdado de ConnectionSettings) |
| LoginSecure |
Se definido como true, Windows segurança integrada será usada e Logon e Senha serão ignorados. Se não estiver definido, a Autenticação do Sql Server será usada. Exceções: ConnectionCannotBeChangedException (Herdado de ConnectionSettings) |
| MaxPoolSize |
O número máximo de conexões permitidas no pool. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| MinPoolSize |
O número mínimo de conexões mantidas no pool. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| MultipleActiveResultSets |
Habilite o MARS por meio da conexão. O padrão é false. (Herdado de ConnectionSettings) |
| NetworkProtocol |
Identifica o protocolo de rede do cliente usado para se conectar ao SQL Server. Se você não especificar uma rede e usar um servidor local, a memória compartilhada será usada. Se você não especificar uma rede e usar um servidor remoto, um dos protocolos de cliente configurados será usado. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| NonPooledConnection |
Por padrão, todas as conexões com SQL Server são retiradas de um pool de conexões .NET ADO. Se definido como true, isso permite que os usuários criem uma conexão não em pool (não será reutilizado quando fechado). Exceções: ConnectionCannotBeChangedException (Herdado de ConnectionSettings) |
| PacketSize |
Tamanho em bytes dos pacotes de rede usados para se comunicar com uma instância do SQL Server. O padrão é 8192. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| ParameterizationMode |
Obtém ou define um valor que indica o QueryParameterizationMode QueryParameterizationMode que todas as instâncias do ServerConnection usam |
| Password |
A senha usada com Logon para se conectar ao servidor. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Herdado de ConnectionSettings) |
| PooledConnectionLifetime |
Quando uma conexão é retornada ao pool, seu tempo de criação é comparado com o tempo atual e a conexão é destruída se esse período de tempo (em segundos) excede o valor especificado pelo tempo de vida da conexão. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| ProcessID |
A propriedade ProcessID retorna o identificador de processo SQL Server para a conexão usada pelo objeto ServerConnection. |
| ProductVersion |
Obtém a propriedade do servidor ProductVersion dessa conexão (Herdado de ConnectionManager) |
| RequiresLogin |
Retornará true se os valores atuais de LoginSecure e Autenticação exigirem que uma propriedade de logon seja definida (Herdado de ConnectionSettings) |
| ResetConnectionString |
Informa se ConnectionString precisa ser redefinido na propriedade SqlConnectionObject do ConnectionManager ou não. (Herdado de ConnectionSettings) |
| SecureConnectionString |
A propriedade retornará uma versão SecureString do usuário especificado cadeia de conexão ou retornará o cadeia de conexão computado com base nas configurações do objeto. Se definido explicitamente, todas as propriedades no objeto ServerConnection serão preenchidas para refletir o cadeia de conexão passado. Exceções: ConnectionCannotBeChangedException (Herdado de ConnectionSettings) |
| SecurePassword |
A senha usada com Logon para se conectar ao servidor. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Herdado de ConnectionSettings) |
| ServerCertificate |
O caminho para o certificado do servidor a ser usado para validação de certificado. (Herdado de ConnectionSettings) |
| ServerInstance |
O nome do SQL Server ao qual o objeto se conectará. Se não estiver definido, o servidor local estará implícito. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
| ServerVersion |
Retorna o número de versão principal de SQL Server. Ou seja, 8 por SQL Server 2000. Exceções: ConnectionFailureException (Herdado de ConnectionManager) |
| SqlConnectionObject |
Retorna uma referência ao objeto SqlConnection usado pelo objeto ConnectionContext. Isso sempre deve retornar o objeto sqlConnection válido com o conjunto ConnectionString válido mais recente. Exceções: PropertyNotAvailableException (Herdado de ConnectionManager) |
| SqlExecutionModes |
Determina se as instruções SQL são capturadas ou enviadas para o servidor. |
| StatementTimeout |
Esse é o número de segundos que uma instrução tenta ser enviada ao servidor antes de falhar. O padrão é 600 segundos (o mesmo que Shiloh). Exceções: InvalidPropertyValueException |
| StrictEncryption |
Se "encrypt=strict" é especificado no cadeia de conexão. Quando verdadeiro, o valor é EncryptConnection ignorado. (Herdado de ConnectionSettings) |
| TransactionDepth |
Fornece a profundidade da transação conforme contado pelo modelo de objeto. Isso não inclui nenhuma transação que possa ter sido iniciada no servidor ou emitindo BEGIN TRAN com o método ExecuteNonQuery. |
| TrueLogin |
A propriedade TrueLogin retorna o nome do registro de logon usado pela conexão atual. |
| TrueName |
A propriedade TrueName retorna o conjunto de resultados do Microsoft ® SQL Server @@INSTANCENAME de função global. |
| TrustServerCertificate |
Indicar se o cliente confia no certificado do servidor (Herdado de ConnectionSettings) |
| UseMode |
Obtém ou define o DeferredUseMode uso de todas as instâncias do ServerConnection do UseMode |
| UserProfile |
A propriedade UserProfile retorna uma descrição de função de alto nível para o logon Microsoft SQL Server usado pela conexão atual. |
| WorkstationId |
O nome da estação de trabalho que se conecta ao SQL Server. Exceções: ConnectionCannotBeChangedException InvalidPropertyValueException (Herdado de ConnectionSettings) |
Métodos
| Nome | Description |
|---|---|
| BeginTransaction() |
Inicia uma nova transação. Se CaptureMode for true, a instrução de transação será adicionada ao buffer de captura. É possível aninhar transações. É responsabilidade do usuário confirmar ou reverter cada transação aberta. Não é garantido que todos os T-SQL emitidos pelo modelo de objeto possam ser encapsulados por uma transação. Além disso, o estado dos objetos que foram alterados não refletirá o estado real do banco de dados até que uma transação tenha sido confirmada ou depois que uma transação tiver sido revertida. É responsabilidade do usuário atualizar os objetos afetados. Use com cuidado. |
| Cancel() | |
| ChangePassword(SecureString) | |
| ChangePassword(String) | |
| CheckServerVersion(ServerVersion) |
Verifique se estamos nos conectando a uma versão do servidor com suporte. block off <= 7.0 in ServerConnection. (Herdado de ConnectionManager) |
| CommitTransaction() |
Confirma uma transação. Se CaptureMode for true, o comando de transação será adicionado ao buffer de captura. Exceções: NotInTransactionException |
| Connect() |
Cria a conexão real com SQL Server. Ignorado se já estiver conectado. É opcional chamar esse método, pois a conexão será aberta quando necessário. Exceções: ConnectionFailureException (Herdado de ConnectionManager) |
| Copy() |
Essa função executa uma cópia profunda |
| Disconnect() |
Fecha a conexão com SQL Server. Ignorado se já estiver desconectado. Exceções: ConnectionFailureException (Herdado de ConnectionManager) |
| ExecuteNonQuery(String, ExecutionTypes, Boolean) |
Executa uma instrução T-SQL. O termininator de comando ('GO') é reconhecido por ExecuteNonQuery. Os lotes serão enviados e executados individualmente. A instrução é gravada e não executada se CaptureMode tiver sido definido como true. Um valor int é retornado que contém o número de linhas afetadas. Se vários lotes forem executados, o número total de linhas afetadas de todos os lotes será retornado. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(String, ExecutionTypes) |
Executa uma instrução T-SQL. O termininator de comando ('GO') é reconhecido por ExecuteNonQuery. Os lotes serão enviados e executados individualmente. A instrução é gravada e não executada se CaptureMode tiver sido definido como true. Um valor int é retornado que contém o número de linhas afetadas. Se vários lotes forem executados, o número total de linhas afetadas de todos os lotes será retornado. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(String) | |
| ExecuteNonQuery(StringCollection, ExecutionTypes, Boolean) |
Executa as instruções T-SQL no StringCollection. O termininator de comando ('GO') é reconhecido por ExecuteNonQuery. Os lotes separados com a instrução GO serão enviados e executados individualmente. A instrução é gravada e não executada se CaptureMode tiver sido definido como true. Uma matriz de valores int é retornada que contém o número de linhas afetadas para cada instrução no StringCollection. Se vários lotes forem executados, o número total de linhas afetadas de todos os lotes será retornado. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(StringCollection, ExecutionTypes) |
Executa as instruções T-SQL no StringCollection. O termininator de comando ('GO') é reconhecido por ExecuteNonQuery. Os lotes separados com a instrução GO serão enviados e executados individualmente. A instrução é gravada e não executada se CaptureMode tiver sido definido como true. Uma matriz de valores int é retornada que contém o número de linhas afetadas para cada instrução no StringCollection. Se vários lotes forem executados, o número total de linhas afetadas de todos os lotes será retornado. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(StringCollection) | |
| ExecuteReader(String, SqlCommand) |
Executa instruções T-SQL. Um objeto SqlDataReader é retornado que pode ser usado para ler o fluxo de linhas retornadas por SQL Server. Um objeto SqlCommand também é retornado que pode ser usado para cancelar o pipe do leitor de dados se uma anulação de uma consulta de longa execução for necessária. ele não desconecta automaticamente Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteReader(String, SqlCommand) |
Executa instruções T-SQL. Um objeto SqlDataReader é retornado que pode ser usado para ler o fluxo de linhas retornadas por SQL Server. Um objeto SqlCommand também é retornado que pode ser usado para cancelar o pipe do leitor de dados se uma anulação de uma consulta de longa execução for necessária. ele não desconecta automaticamente Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteReader(String) |
Executa instruções T-SQL. Um objeto SqlDataReader é retornado que pode ser usado para ler o fluxo de linhas retornadas por SQL Server. O método Connect() será chamado se a conexão com o servidor não estiver aberta. ele não desconecta automaticamente Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteScalar(String) |
Executa uma instrução T-SQL. Um objeto é retornado que contém a primeira coluna da primeira linha do conjunto de resultados. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteScalar(StringCollection) |
Executa as instruções T-SQL no StringCollection. Uma matriz de objetos é retornada que cada um contém a primeira coluna da primeira linha do conjunto de resultados de cada instrução executada. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean) |
Executa o T-SQL usando os métodos apropriados, dependendo das informações de ação passadas como o parâmetro. (Herdado de ConnectionManager) |
| ExecuteWithResults(String, Boolean) |
Executa as instruções T-SQL no sqlCommand. Um Conjunto de Dados é retornado que contém os resultados. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteWithResults(String) |
Executa as instruções T-SQL no sqlCommand. Um Conjunto de Dados é retornado que contém os resultados. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ExecuteWithResults(StringCollection) |
Executa as instruções T-SQL no StringCollection. Uma matriz de Conjuntos de Dados é retornada que contém os resultados de cada instrução no StringCollection. O método Connect() será chamado se a conexão com o servidor não estiver aberta. Exceções: ConnectionFailureException ExecutionFailureExeception |
| ForceDisconnected() |
Impõe uma desconexão e garante que a conexão não possa ser aberta novamente (Herdado de ConnectionManager) |
| GetDatabaseConnection(String, Boolean, IRenewableToken) |
Retorna uma conexão que tem o nome do banco de dados especificado no cadeia de conexão Se a conexão atual já estiver fazendo referência ao banco de dados fornecido, a conexão atual será retornada. |
| GetDatabaseConnection(String, Boolean) |
Retorna uma conexão que tem o nome do banco de dados especificado no cadeia de conexão. Se a conexão atual já estiver fazendo referência ao banco de dados especificado, a conexão atual será retornada. |
| IsInFixedServerRole(FixedServerRoles) |
Testa se o logon é membro de qualquer uma das funções de servidor especificadas. |
| NormalizeQuery(String, Boolean) |
Traduzir uma consulta com literais inseridos para uma forma normalizada (todos os literais substituídos por um token padrão) |
| NormalizeQuery(String) |
Sobrecarga para a função acima – consulte-a para obter detalhes |
| RollBackTransaction() |
Anula uma transação (todas as alterações feitas não serão salvas no banco de dados). Se CaptureMode for true, o comando de transação será adicionado ao buffer de captura. Exceções: NotInTransactionException |
| ThrowIfPropertyNotSet(String, String, Boolean) | (Herdado de ConnectionSettings) |
| ThrowIfPropertyNotSet(String, String) | (Herdado de ConnectionSettings) |
| ToString() | (Herdado de ConnectionSettings) |
Eventos
| Nome | Description |
|---|---|
| InfoMessage |
Ocorre quando SQL Server retorna um aviso ou mensagem informativa. Usa SqlClient.SqlInfoMessageEventHandler. (Herdado de ConnectionManager) |
| RemoteLoginFailed |
Chamado quando o servidor precisa se conectar a servidores remotos e o logon falha (Herdado de ConnectionManager) |
| ServerMessage |
Ocorre quando SQL Server retorna um aviso ou mensagem informativa. Usa SqlClient.SqlInfoMessageEventHandler. (Herdado de ConnectionManager) |
| StateChange |
Ocorre quando o estado da conexão é alterado. Usa System.Data.StateChangeEventHandler. (Herdado de ConnectionManager) |
| StatementExecuted | (Herdado de ConnectionManager) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| ISfcConnection.Connect() | |
| ISfcConnection.Copy() | |
| ISfcConnection.Disconnect() | |
| ISfcConnection.ServerVersion | |
| ISfcConnection.ToEnumeratorObject() | |