Classe ServerConnection

  • Artigo

O objeto ServerConnection representa uma conexão com um servidor.

Hierarquia de herança

Object
  Microsoft.SqlServer.Management.Common.ConnectionSettings
    Microsoft.SqlServer.Management.Common.ConnectionManager
      Microsoft.SqlServer.Management.Common.ServerConnection

Namespace:  Microsoft.SqlServer.Management.Common
Assembly:  Microsoft.SqlServer.ConnectionInfo (em Microsoft.SqlServer.ConnectionInfo.dll)

Sintaxe

'Declaração
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'Uso
Dim instance As ServerConnection

public sealed class ServerConnection : ConnectionManager, 
    ISfcConnection

public ref class ServerConnection sealed : public ConnectionManager, 
    ISfcConnection

[<SealedAttribute>]
type ServerConnection =  
    class 
        inherit ConnectionManager 
        interface ISfcConnection 
    end

public final class ServerConnection extends ConnectionManager implements ISfcConnection

O tipo ServerConnection expõe os membros a seguir.

Construtores

  Nome Descrição
Método público ServerConnection() Inicializa uma nova instância da classe ServerConnection.
Método público ServerConnection(SqlConnection) Inicializa uma nova instância da classe ServerConnection com os parâmetros de conexão especificados.
Método público ServerConnection(String) Inicializa uma nova instância da classe ServerConnection com a instância do servidor especificada.
Método público ServerConnection(SqlConnectionInfo) Inicializa uma nova instância da classe ServerConnection com as informações de conexão especificadas.
Método público ServerConnection(String, String, SecureString) Inicializa uma nova instância da classe ServerConnection com a instância do servidor e as credenciais de logon especificadas.
Método público ServerConnection(String, String, String) Inicializa uma nova instância da classe ServerConnection com a instância do servidor e as credenciais de logon especificadas.

Início

Propriedades

  Nome Descrição
Propriedade pública ApplicationName Obtém ou define o nome do aplicativo que estabeleceu a conexão com o servidor. (Herdado de ConnectionSettings.)
Propriedade pública AutoDisconnectMode Obtém ou define o modo de desconexão automático da conexão referenciada com a instância do SQL Server. (Herdado de ConnectionManager.)
Propriedade pública BatchSeparator Obtém ou define o valor da cadeia de caracteres usado para separar lotes na conexão referenciada.
Propriedade pública CapturedSql Obtém as instruções Transact-SQL capturadas quando a conexão está executando em modo de captura. (Herdado de ConnectionManager.)
Propriedade pública ConnectAsUser Obtém ou define o valor da propriedade Boolean que especifica se a conexão é estabelecida usando representação. (Herdado de ConnectionSettings.)
Propriedade pública ConnectAsUserName Obtém ou define o nome do usuário ao conectar-se usando a representação. (Herdado de ConnectionSettings.)
Propriedade pública ConnectAsUserPassword Obtém ou define a senha do usuário ao conectar-se usando a representação. (Herdado de ConnectionSettings.)
Propriedade pública ConnectionString Obtém ou define a cadeia de conexão usada para estabelecer uma conexão com a fonte de dados especificada. (Herdado de ConnectionSettings.)
Propriedade pública ConnectionType Obtém o tipo de conexão a ser usado no servidor.
Propriedade pública ConnectTimeout Obtém ou define o período de tempo limite da conexão em segundos. (Herdado de ConnectionSettings.)
Propriedade pública DatabaseEngineType Obtém o tipo do mecanismo de banco de dados. (Herdado de ConnectionManager.)
Propriedade pública DatabaseName Obtém ou define o banco de dados exigido pela conexão. (Herdado de ConnectionSettings.)
Propriedade pública EncryptConnection Obtém ou define o valor da propriedade Boolean que especifica se a conexão é criptografada. (Herdado de ConnectionSettings.)
Propriedade pública FixedServerRoles Obtém a função de servidor fixa associada à conexão referenciada.
Propriedade pública InUse Obtém ou define o valor da propriedade Boolean que especifica se a conexão está sendo usada. (Herdado de ConnectionManager.)
Propriedade pública IsForceDisconnected Obtém um valor Boolean que especifica se a conexão foi desconectada de maneira forçada. (Herdado de ConnectionManager.)
Propriedade pública IsOpen Obtém o valor da propriedade Boolean que especifica se a conexão está aberta no momento. (Herdado de ConnectionManager.)
Propriedade pública LockTimeout Obtém ou define o tempo, em segundos, necessário para esgotar o tempo limite da conexão quando a transação atual é bloqueada. (Herdado de ConnectionManager.)
Propriedade pública Login Obtém ou define o logon necessário para estabelecer uma conexão com a instância do servidor. (Herdado de ConnectionSettings.)
Propriedade pública LoginSecure Obtém ou define o valor da propriedade Boolean que especifica se a conexão é estabelecida com o servidor usando a Autenticação do Windows ou a Autenticação do SQL Server. (Herdado de ConnectionSettings.)
Propriedade pública MaxPoolSize Obtém ou define o número máximo de conexões em um pool de conexão que a conexão especificada aceita ao estabelecer uma conexão com um servidor. (Herdado de ConnectionSettings.)
Propriedade pública MinPoolSize Obtém ou define o número mínimo de conexões em um pool de conexão que a conexão especificada aceita ao estabelecer uma conexão com um servidor. (Herdado de ConnectionSettings.)
Propriedade pública MultipleActiveResultSets Obtém ou define o valor da propriedade Boolean que especifica se mais de um conjunto de resultados ativo é permitido. (Herdado de ConnectionSettings.)
Propriedade pública NetworkProtocol Obtém ou define o protocolo de rede usado para estabelecer a conexão com o servidor. (Herdado de ConnectionSettings.)
Propriedade pública NonPooledConnection Obtém ou define o valor da propriedade Boolean que especifica se a conexão pode ser agrupada ou não. (Herdado de ConnectionSettings.)
Propriedade pública PacketSize Obtém ou define os pacotes de dados enviados entre o cliente e o servidor pela rede em bytes. (Herdado de ConnectionSettings.)
Propriedade públicaMembro estático ParameterizationMode Obtém ou define o modo de parametrização para a conexão do servidor.
Propriedade pública Password Obtém ou define a senha usada com o logon para estabelecer uma conexão com o servidor quando a Autenticação do SQL Server é usada. (Herdado de ConnectionSettings.)
Propriedade pública PooledConnectionLifetime Obtém ou define o tempo de vida da conexão agrupada. (Herdado de ConnectionSettings.)
Propriedade pública ProcessID Obtém o valor da ID que identifica exclusivamente o processo associado à conexão referenciada ao servidor.
Propriedade pública SecureConnectionString Obtém ou define uma versão criptografada da cadeia de conexão. (Herdado de ConnectionSettings.)
Propriedade pública SecurePassword Obtém ou define a senha segura usada com o logon para estabelecer uma conexão com o servidor quando a Autenticação do SQL Server é utilizada. (Herdado de ConnectionSettings.)
Propriedade pública ServerInstance Obtém ou define o nome do servidor. (Herdado de ConnectionSettings.)
Propriedade pública ServerVersion Obtém a versão da instância conectada do SQL Server. (Herdado de ConnectionManager.)
Propriedade pública SqlConnectionObject Obtém o objeto de conexão. (Herdado de ConnectionManager.)
Propriedade pública SqlExecutionModes Obtém ou define o modo de execução associado à conexão referenciada ao servidor.
Propriedade pública StatementTimeout Obtém ou define o número de segundos atribuído a uma instrução para execução antes que ela apresente falha com um erro de tempo limite.
Propriedade pública TransactionDepth Obtém a profundidade da transação atual para a conexão referenciada.
Propriedade pública TrueLogin Obtém o nome do registro de logon atual usado pela conexão referenciada.
Propriedade pública TrueName Obtém o nome do servidor.
Propriedade públicaMembro estático UseMode Obtém ou define a conexão do servidor usando um modo especificado.
Propriedade pública UserProfile Obtém o perfil de usuário associado à conexão referenciada.
Propriedade pública WorkstationId Obtém ou define o valor da ID que identifica exclusivamente a estação de trabalho. (Herdado de ConnectionSettings.)

Início

Métodos

  Nome Descrição
Método público BeginTransaction Inicia uma transação na conexão referenciada.
Método público Cancel Cancela a conexão.
Método público ChangePassword(SecureString) Altera a senha de logon que é usada com a autenticação padrão.
Método público ChangePassword(String) Altera a senha de logon que é usada com a autenticação padrão.
Método público CommitTransaction Confirma a transação atual na conexão referenciada.
Método público Connect Conecta-se à instância do SQL Server. (Herdado de ConnectionManager.)
Método público Copy Retorna uma cópia do objeto ServerConnection.
Método público Disconnect Desconecta-se da instância do SQL Server. (Herdado de ConnectionManager.)
Método público Equals (Herdado de Object.)
Método público ExecuteNonQuery(StringCollection) Executa um lote de instruções que não retornam um conjunto de resultados.
Método público ExecuteNonQuery(String) Executa uma instrução que não retorna um conjunto de resultados.
Método público ExecuteNonQuery(StringCollection, ExecutionTypes) Executa um lote de instruções com as opções de execução especificadas que não retorna um conjunto de resultados.
Método público ExecuteNonQuery(String, ExecutionTypes) Executa uma instrução com as opções de execução especificadas que não retorna um conjunto de resultados.
Método público ExecuteReader(String) Executa instruções Transact-SQL que retornam um ou vários conjuntos de resultados.
Método público ExecuteReader(String, SqlCommand%) Executa um leitor usando um valor do objeto SqlDataReader que contém um ou mais conjuntos de resultados.
Método público ExecuteScalar(StringCollection) Executa um lote de instruções Transact-SQL e retorna a primeira coluna da primeira linha como um valor de objeto.
Método público ExecuteScalar(String) Executa uma instrução Transact-SQL e retorna a primeira coluna da primeira linha como um valor de objeto.
Método público ExecuteWithResults(StringCollection) Executa um lote de instruções Transact-SQL que retornam vários conjuntos de resultados.
Método público ExecuteWithResults(String) Executa uma instrução Transact-SQL que retorna um conjunto de resultados.
Método público ForceDisconnected Força uma desconexão da instância do SQL Server. (Herdado de ConnectionManager.)
Método público GetHashCode (Herdado de Object.)
Método público GetType (Herdado de Object.)
Método público IsInFixedServerRole Testa se o logon associado à conexão referenciada é membro da função de servidor fixo especificada.
Método públicoMembro estático NormalizeQuery(String) Usa uma entrada de cadeia de caracteres que representa o texto da consulta.
Método públicoMembro estático NormalizeQuery(String, Boolean) Normaliza a consulta que controla a conexão do servidor.
Método público RollBackTransaction Reverte a transação atual.
Método público ToString Retorna o nome do objeto referenciado como uma cadeia de caracteres. (Herdado de ConnectionSettings.)

Início

Eventos

  Nome Descrição
Evento público InfoMessage O evento que ocorre quando a instância do SQL Server gera uma mensagem informativa.  (Herdado de ConnectionManager.)
Evento público RemoteLoginFailed O evento ocorre quando há falha em um logon remoto ao conectar-se com a instância do SQL Server. (Herdado de ConnectionManager.)
Evento público ServerMessage O evento que ocorre quando o SQL Server retorna um aviso ou mensagem informativa na conexão atual. (Herdado de ConnectionManager.)
Evento público StateChange O evento que ocorre quando o estado da instância do SQL Server é alterado.  (Herdado de ConnectionManager.)
Evento público StatementExecuted O evento que ocorre quando a instância do SQL Server executa uma instrução na conexão atual.  (Herdado de ConnectionManager.)

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasMétodo privado ISfcConnection.Connect Retorna um valor que indica o servidor ao qual conectar usando uma conexão SFC.
Implementações de interfaces explícitasMétodo privado ISfcConnection.Copy Usa a conexão SFC para copiar a conexão do servidor.
Implementações de interfaces explícitasMétodo privado ISfcConnection.Disconnect Desconecta a conexão.
Implementações de interfaces explícitasPropriedade privada ISfcConnection.ServerVersion Obtém a versão do servidor.
Implementações de interfaces explícitasMétodo privado ISfcConnection.ToEnumeratorObject Renderiza um objeto enumerador para a conexão do servidor.

Início

Comentários

A classe de ServerConnection é fornecida pela classe de Server e classes de replicação como ReplicationServer classe.

Normalmente, você não precisa declarar uma instância do objeto de ServerConnection porque é criado automaticamente com o objeto do servidor. Declare uma variável do objeto de ServerConnection se deseja armazenar as configurações de conexão para reutilização. A propriedade de ConnectionContext de pontos de objeto de servidor para um objeto ServerConnection. O objeto de ServerConnection contém as propriedades relacionadas à conexão entre o objeto de servidor e a instância de SQL Server. Você pode usá-lo para exibir ou modificar alguns aspectos da conexão, como a ID do processo, o processamento de transações, o modo de autenticação, o modo de execução, e mesmo para executar diretamente comandos de Transact-SQL .

Usando o objeto de ServerConnection , você pode fazer o seguinte:

  • Executar instruções de Transact-SQL diretamente na conexão com a instância de SQL Server.

  • Alterar as configurações de conexão, como o método de autenticação.

  • Inicie o, confirme e reverter transações.

  • Capturar as instruções de Transact-SQL geradas pelo aplicativo de SMO.

Exemplos

Para obter outro exemplo desse método com o objeto de Database , consulte [M:Microsoft.SqlServer.Management.Smo.Database.ExecuteNonQuery(System.String].

VB

'Declare a ServerConnection object variable to specify SQL authentication, login and password.
Dim conn As New ServerConnection
conn.LoginSecure = False
conn.Login = vlogin
conn.Password = vpassword
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server(conn)
'The actual connection is made when a property is retrieved.
Console.WriteLine(srv.Information.Version)
'The connection is automatically disconnected when the Server variable goes out of scope.

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.LoginSecure = $FALSE
$conn.Login = vlogin
$conn.Password = vpassword
#Connect to the local, default instance of SQL Server
$srv = new-object Microsoft.SqlServer.Management.Smo.Server($conn)
Write-Host $srv.Information.Version

Segurança de thread

Qualquer membro público static (Shared no Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.

Consulte também

Referência

Namespace Microsoft.SqlServer.Management.Common

Outros recursos

Conectando-se a uma instância do SQL Server

Conectando-se a uma instância do SQL Server