Clase ServerConnection

  • Artículo

El objeto ServerConnection representa una conexión a un servidor.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.SqlServer.Management.Common
Ensamblado:  Microsoft.SqlServer.ConnectionInfo (en Microsoft.SqlServer.ConnectionInfo.dll)

Sintaxis

'Declaración
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

El tipo ServerConnection expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público ServerConnection() Inicializa una nueva instancia de la clase ServerConnection.
Método público ServerConnection(SqlConnection) Inicializa una nueva instancia de la clase ServerConnection con los parámetros de conexión especificados.
Método público ServerConnection(String) Inicializa una nueva instancia de la clase ServerConnection con la instancia de servidor especificada.
Método público ServerConnection(SqlConnectionInfo) Inicializa una nueva instancia de la clase ServerConnection con la información de conexión especificada.
Método público ServerConnection(String, String, SecureString) Inicializa una nueva instancia de la clase ServerConnection con la instancia de servidor y las credenciales de inicio de sesión especificadas.
Método público ServerConnection(String, String, String) Inicializa una nueva instancia de la clase ServerConnection con la instancia de servidor y las credenciales de inicio de sesión especificadas.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública ApplicationName Obtiene o establece el nombre de la aplicación que ha establecido la conexión con el servidor. (Se hereda de ConnectionSettings.)
Propiedad pública AutoDisconnectMode Obtiene o establece el modo de desconexión automática de la conexión a la instancia de SQL Server a la que se referencia. (Se hereda de ConnectionManager.)
Propiedad pública BatchSeparator Obtiene o establece el valor de cadena utilizado para separar los lotes en la conexión a la que se hace referencia.
Propiedad pública CapturedSql Obtiene las instrucciones Transact-SQL que se capturan cuando la conexión se está ejecutando en modo de captura. (Se hereda de ConnectionManager.)
Propiedad pública ConnectAsUser Obtiene o establece el valor de propiedad Boolean que especifica si la conexión se establece con suplantación. (Se hereda de ConnectionSettings.)
Propiedad pública ConnectAsUserName Obtiene o establece el nombre del usuario al conectar con suplantación. (Se hereda de ConnectionSettings.)
Propiedad pública ConnectAsUserPassword Obtiene o establece la contraseña del usuario al conectar con suplantación. (Se hereda de ConnectionSettings.)
Propiedad pública ConnectionString Obtiene o establece la cadena de conexión que se usa para establecer una conexión con un origen de datos especificado. (Se hereda de ConnectionSettings.)
Propiedad pública ConnectionType Obtiene o establece el tipo de conexión que se va a utilizar en el servidor.
Propiedad pública ConnectTimeout Obtiene o establece el tiempo de espera de conexión en segundos. (Se hereda de ConnectionSettings.)
Propiedad pública DatabaseEngineType Obtiene el tipo de motor de base de datos. (Se hereda de ConnectionManager.)
Propiedad pública DatabaseName Obtiene o establece la base de datos que requiere la conexión. (Se hereda de ConnectionSettings.)
Propiedad pública EncryptConnection Obtiene o establece el valor de propiedad Boolean que especifica si se cifra la conexión. (Se hereda de ConnectionSettings.)
Propiedad pública FixedServerRoles Obtiene el rol fijo de servidor asociado a la conexión a la que se hace referencia.
Propiedad pública InUse Obtiene o establece el valor de propiedad Boolean que especifica si se usa la conexión. (Se hereda de ConnectionManager.)
Propiedad pública IsForceDisconnected Obtiene un valor Boolean que especifica si la conexión se cerró forzosamente. (Se hereda de ConnectionManager.)
Propiedad pública IsOpen Obtiene el valor de propiedad Boolean que especifica si la conexión está abierta. (Se hereda de ConnectionManager.)
Propiedad pública LockTimeout Obtiene o establece el tiempo en segundos necesario para que la conexión agote el tiempo de espera cuando la transacción actual está bloqueada. (Se hereda de ConnectionManager.)
Propiedad pública Login Obtiene o establece el inicio de sesión que se requiere para establecer una conexión con la instancia del servidor. (Se hereda de ConnectionSettings.)
Propiedad pública LoginSecure Obtiene o establece la propiedad Boolean que especifica si la conexión con el servidor se establece mediante autenticación de Windows o autenticación de SQL Server. (Se hereda de ConnectionSettings.)
Propiedad pública MaxPoolSize Obtiene o establece el número máximo de conexiones de un grupo de conexiones que la conexión especificada acepta al establecer una conexión con un servidor. (Se hereda de ConnectionSettings.)
Propiedad pública MinPoolSize Obtiene o establece el número mínimo de conexiones de un grupo de conexiones que la conexión especificada acepta al establecer una conexión con un servidor. (Se hereda de ConnectionSettings.)
Propiedad pública MultipleActiveResultSets Obtiene o establece el valor de la propiedad Boolean que especifica si se permite más de un conjunto de resultados activo. (Se hereda de ConnectionSettings.)
Propiedad pública NetworkProtocol Obtiene o establece el protocolo de red que se usa para establecer la conexión al servidor. (Se hereda de ConnectionSettings.)
Propiedad pública NonPooledConnection Obtiene o establece el valor de propiedad Boolean que especifica si la conexión puede estar agrupada o no. (Se hereda de ConnectionSettings.)
Propiedad pública PacketSize Obtiene o establece los paquetes de datos enviados entre el cliente y el servidor a través de la red en bytes. (Se hereda de ConnectionSettings.)
Propiedad públicaMiembro estático ParameterizationMode Obtiene o establece el modo de parametrización para la conexión al servidor.
Propiedad pública Password Obtiene o establece la contraseña utilizada con el inicio de sesión para establecer una conexión con el servidor cuando se utiliza autenticación de SQL Server. (Se hereda de ConnectionSettings.)
Propiedad pública PooledConnectionLifetime Obtiene o establece la duración de la conexión agrupada. (Se hereda de ConnectionSettings.)
Propiedad pública ProcessID Obtiene el valor de identificador que identifica de forma exclusiva el proceso asociado a la conexión al servidor a la que se hace referencia.
Propiedad pública SecureConnectionString Obtiene o establece una versión cifrada de la cadena de conexión. (Se hereda de ConnectionSettings.)
Propiedad pública SecurePassword Obtiene o establece la contraseña segura utilizada con el inicio de sesión para establecer una conexión con el servidor cuando se utiliza autenticación de SQL Server. (Se hereda de ConnectionSettings.)
Propiedad pública ServerInstance Obtiene o establece el nombre del servidor. (Se hereda de ConnectionSettings.)
Propiedad pública ServerVersion Obtiene la versión de la instancia conectada de SQL Server. (Se hereda de ConnectionManager.)
Propiedad pública SqlConnectionObject Obtiene el objeto de conexión. (Se hereda de ConnectionManager.)
Propiedad pública SqlExecutionModes Obtiene o establece el modo de ejecución asociado a la conexión al servidor a la que se hace referencia.
Propiedad pública StatementTimeout Obtiene o establece el número de segundos de que dispone una instrucción para ejecutarse antes de que se produzca un error de tiempo de espera.
Propiedad pública TransactionDepth Obtiene la profundidad de transacción actual de la conexión a la que se hace referencia.
Propiedad pública TrueLogin Obtiene el nombre de registro de inicio de sesión actual que usa la conexión a la que se hace referencia.
Propiedad pública TrueName Obtiene el nombre del servidor.
Propiedad públicaMiembro estático UseMode Obtiene o establece la conexión al servidor mediante un modo especificado.
Propiedad pública UserProfile Obtiene el perfil de usuario asociado a la conexión a la que se hace referencia.
Propiedad pública WorkstationId Obtiene o establece el valor de identificador que identifica de forma única la estación de trabajo. (Se hereda de ConnectionSettings.)

Arriba

Métodos

  Nombre Descripción
Método público BeginTransaction Inicia una transacción en la conexión a la que se hace referencia.
Método público Cancel Cancela la conexión.
Método público ChangePassword(SecureString) Cambia la contraseña de inicio de sesión que se utiliza con autenticación estándar.
Método público ChangePassword(String) Cambia la contraseña de inicio de sesión que se utiliza con autenticación estándar.
Método público CommitTransaction Confirma la transacción actual en la conexión a la que se hace referencia.
Método público Connect Conecta con la instancia de SQL Server. (Se hereda de ConnectionManager.)
Método público Copy Devuelve una copia del objeto ServerConnection.
Método público Disconnect Desconecta de la instancia de SQL Server. (Se hereda de ConnectionManager.)
Método público Equals (Se hereda de Object.)
Método público ExecuteNonQuery(StringCollection) Ejecuta un lote de instrucciones que no devuelven ningún conjunto de resultados.
Método público ExecuteNonQuery(String) Ejecuta una instrucción que no devuelve ningún conjunto de resultados.
Método público ExecuteNonQuery(StringCollection, ExecutionTypes) Ejecuta un lote de instrucciones con las opciones de ejecución especificadas que no devuelve ningún conjunto de resultados.
Método público ExecuteNonQuery(String, ExecutionTypes) Ejecuta una instrucción con las opciones de ejecución especificadas que no devuelve ningún conjunto de resultados.
Método público ExecuteReader(String) Ejecuta instrucciones Transact-SQL que devuelven uno o varios conjuntos de resultados.
Método público ExecuteReader(String, SqlCommand%) Ejecuta un lector utilizando un valor de objeto SqlDataReader que contiene uno o varios conjuntos de resultados.
Método público ExecuteScalar(StringCollection) Ejecuta un lote de instrucciones Transact-SQL y devuelve la primera columna de la primera fila como valor de objeto.
Método público ExecuteScalar(String) Ejecuta una instrucción Transact-SQL y devuelve la primera columna de la primera fila como valor de objeto.
Método público ExecuteWithResults(StringCollection) Ejecuta un lote de instrucciones Transact-SQL que devuelven varios conjuntos de resultados.
Método público ExecuteWithResults(String) Ejecuta una instrucción Transact-SQL que devuelve un conjunto de resultados.
Método público ForceDisconnected Fuerza una desconexión de la instancia de SQL Server. (Se hereda de ConnectionManager.)
Método público GetHashCode (Se hereda de Object.)
Método público GetType (Se hereda de Object.)
Método público IsInFixedServerRole Prueba si el inicio de sesión asociado a la conexión a la que se hace referencia es un miembro del rol fijo de servidor especificado.
Método públicoMiembro estático NormalizeQuery(String) Utiliza una entrada de cadena que representa el texto de la consulta.
Método públicoMiembro estático NormalizeQuery(String, Boolean) Normaliza la consulta que controla la conexión al servidor.
Método público RollBackTransaction Revierte la transacción actual.
Método público ToString Devuelve el nombre de objeto al que se hace referencia como una cadena. (Se hereda de ConnectionSettings.)

Arriba

Eventos

  Nombre Descripción
Evento público InfoMessage El evento que se produce cuando la instancia de SQL Server genera un mensaje informativo.  (Se hereda de ConnectionManager.)
Evento público RemoteLoginFailed Este evento se produce cuando un inicio de sesión remoto no se puede conectar a la instancia de SQL Server. (Se hereda de ConnectionManager.)
Evento público ServerMessage El evento que se produce cuando SQL Server devuelve una advertencia o un mensaje informativo en la conexión actual. (Se hereda de ConnectionManager.)
Evento público StateChange El evento que se produce cuando la instancia de SQL Server cambia el estado.  (Se hereda de ConnectionManager.)
Evento público StatementExecuted El evento que se produce cuando la instancia de SQL Server ejecuta una instrucción en la conexión actual.  (Se hereda de ConnectionManager.)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado ISfcConnection.Connect Devuelve un valor que indica el servidor al que se debe conectar mediante una conexión SFC.
Implementación de interfaces explícitasMétodo privado ISfcConnection.Copy Utiliza la conexión SFC para copiar la conexión al servidor.
Implementación de interfaces explícitasMétodo privado ISfcConnection.Disconnect Desconecta la conexión.
Implementación de interfaces explícitasPropiedad privada ISfcConnection.ServerVersion Obtiene la versión del servidor.
Implementación de interfaces explícitasMétodo privado ISfcConnection.ToEnumeratorObject Representa un objeto de enumerador para la conexión al servidor.

Arriba

Comentarios

La clase de ServerConnection es servida por la clase de Server y clases de replicación como ReplicationServer ordenan.

Normalmente, no es necesario declarar una instancia del objeto de ServerConnection porque se crea automáticamente al objeto de servidor. Declare una variable de objeto de ServerConnection si desea almacenar la configuración de conexión para su reutilización. La propiedad de ConnectionContext de objeto de servidor a un objeto ServerConnection. El objeto de ServerConnection contiene propiedades relacionadas con la conexión entre el objeto de servidor y la instancia de SQL Server. Puede utilizarlo para ver o modificar algunos aspectos de conexión, como el identificador de proceso, procesando transacciones, el modo de autenticación, el modo de ejecución, e incluso para ejecutar los comandos de Transact-SQL directamente.

Con el objeto de ServerConnection , puede hacer lo siguiente:

  • Ejecute las instrucciones de Transact-SQL directamente en la conexión a la instancia de SQL Server.

  • Cambie la configuración de conexión, como el método de autenticación.

  • En inicio, confirmación y revierte revertir las transacciones.

  • Capture las instrucciones de Transact-SQL generadas por la aplicación SMO.

Ejemplos

Para otro ejemplo de este método con el objeto de Database , vea [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

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres Microsoft.SqlServer.Management.Common

Otros recursos

Conectarse a una instancia de SQL Server

Conectarse a una instancia de SQL Server