ServerConnection Clase

Definición

Espacio de nombres:

Microsoft.SqlServer.Management.Common

Ensamblado:

Microsoft.SqlServer.ConnectionInfo.dll

Paquete:

Microsoft.SqlServer.SqlManagementObjects v172.64.0

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

Herencia

Object

ConnectionSettings

ConnectionManager

ServerConnection

Implementaciones

ISfcConnection

Constructores

Nombre	Description
ServerConnection()
ServerConnection(IRenewableToken)	Crea un objeto ServerConnection que toma el token. El booleano adicional se usa para sobrecargar este constructor como otro constructor con cadena está presente.
ServerConnection(SqlConnection, IRenewableToken)	Construye un nuevo objeto ServerConnection
ServerConnection(SqlConnection)	Construye un nuevo objeto ServerConnection a partir del objeto SqlConnection especificado.
ServerConnection(SqlConnectionInfo)
ServerConnection(String, String, SecureString)
ServerConnection(String, String, String)
ServerConnection(String)

Campos

Nombre	Description
NoConnectionTimeout	Espera infinita (Heredado de ConnectionSettings)

Propiedades

Nombre	Description
AcceptsLogin	Devuelve true si los valores actuales de LoginSecure y Authentication usan la propiedad Login. (Heredado de ConnectionSettings)
AccessToken	(Heredado de ConnectionSettings)
ApplicationIntent	La intención de la aplicación de los valores válidos de conexión son ReadWrite y ReadOnly. (Heredado de ConnectionSettings)
ApplicationName	El nombre de la aplicación. "Administración de SQL" si no se ha proporcionado ningún nombre de aplicación. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
Authentication	Tipo de autenticación de la conexión (Heredado de ConnectionSettings)
AutoDisconnectMode	(Heredado de ConnectionManager)
BatchSeparator	Define el separador de lotes utilizado por los métodos ExecuteNonQuery. El valor predeterminado es "GO". El separador de lotes no distingue mayúsculas de minúsculas.
CachedQueries	Obtiene o establece un valor que indica si las instancias de ServerConnection deben almacenar en caché los resultados de la consulta.
CapturedSql	(Heredado de ConnectionManager)
ConnectAsUser	Si se establece en true, la conexión se realizará con las credenciales del usuario especificado. Se supone que la suplantación, sin embargo, los campos LoginSecure y Login y Password no se verán afectados. Esta configuración solo se puede usar en Windows. (Heredado de ConnectionSettings)
ConnectAsUserName	Especifica el Windows usuario que se usa al crear una conexión suplantada. El usuario debe tener privilegios de inicio de sesión interactivos. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Heredado de ConnectionSettings)
ConnectAsUserPassword	Especifica la contraseña del usuario de Windows que se usa al crear una conexión suplantada. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Heredado de ConnectionSettings)
ConnectionProtocol	Protocolo de conexión. (Heredado de ConnectionManager)
ConnectionString	La propiedad devolverá el usuario especificado cadena de conexión o devolverá el cadena de conexión calculado en función de la configuración del objeto. Si se establece explícitamente, todas las propiedades del objeto ServerConnection se rellenarán para reflejar el pasado en cadena de conexión. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
ConnectionType
ConnectTimeout	El período de tiempo (en segundos) para esperar una conexión al servidor antes de finalizar el intento e iniciar una excepción. El valor predeterminado es de 30 segundos (igual que Shiloh). Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
CurrentDatabase	Devuelve el contexto de base de datos actual. (Heredado de ConnectionManager)
DatabaseEngineEdition	Edición del Motor de base de datos (Heredado de ConnectionManager)
DatabaseEngineType	Devuelve el tipo de motor de base de datos de SQL Server. Excepciones: ConnectionFailureException (Heredado de ConnectionManager)
DatabaseName	TBD (Heredado de ConnectionSettings)
EncryptConnection	si se especifica "encrypt=true" en el cadena de conexión (Heredado de ConnectionSettings)
FixedServerRoles	Devuelve una enumeración que especificó el rol fijo de servidor del que es miembro el inicio de sesión.
HostNameInCertificate	Nombre de host proporcionado en el certificado que se usará para la validación de certificados. (Heredado de ConnectionSettings)
HostPlatform	La plataforma host del servidor (Linux/Windows/etc.) (Heredado de ConnectionManager)
InUse	Devuelve true si el objeto se ha conectado al servidor al menos una vez. Si es true, los cambios de propiedad no se permiten más y ConnectionCannotBeChangedException se producirá cuando se haya cambiado una propiedad. (Heredado de ConnectionManager)
IsContainedAuthentication	Devuelve true si el motor de base de datos se autentica mediante la autenticación independiente. Excepciones: ConnectionFailureException (Heredado de ConnectionManager)
IsForceDisconnected	Indica que la conexión se ha desconectado de forma forzada. (Heredado de ConnectionManager)
IsOpen	Devuelve true si el objeto SqlConnection está conectado con el servidor. Esto solo puede devolver true para las conexiones no agrupadas, ya que las conexiones agrupadas siempre se cierran directamente después de una operación. (Heredado de ConnectionManager)
LockTimeout	LockTimeout es el tiempo de espera de bloqueo en segundos. La -1 predeterminada es indefinida. InvalidPropertyValueException se produce para todos los demás números negativos. LockTimeout positivo se multiplicará por 1000 y, a continuación, se usará para la configuración "SET LOCK_TIMEOUT". (Heredado de ConnectionManager)
Login	El SQL Server nombre de inicio de sesión que se usa para conectarse al servidor. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Heredado de ConnectionSettings)
LoginSecure	Si se establece en true, se usa Windows seguridad integrada y se omite el inicio de sesión y la contraseña. Si no se establece, se usa la autenticación de Sql Server. Excepciones: ConnectionCannotBeChangedException (Heredado de ConnectionSettings)
MaxPoolSize	El número máximo de conexiones permitido en el grupo. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
MinPoolSize	El número mínimo de conexiones mantenidas en el grupo. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
MultipleActiveResultSets	Habilite MARS desde la conexión. El valor predeterminado es falso. (Heredado de ConnectionSettings)
NetworkProtocol	Identifica el protocolo de red de cliente que se usa para conectarse a SQL Server. Si no especifica una red y usa un servidor local, se usa la memoria compartida. Si no especifica una red y usa un servidor remoto, se usa uno de los protocolos de cliente configurados. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
NonPooledConnection	De forma predeterminada, todas las conexiones a SQL Server se toman de un grupo de conexiones ADO.NET. Si se establece en true, esto permite a los usuarios crear una conexión no agrupada (no se reutilizará cuando se cierre). Excepciones: ConnectionCannotBeChangedException (Heredado de ConnectionSettings)
PacketSize	Tamaño en bytes de los paquetes de red usados para comunicarse con una instancia de SQL Server. El valor predeterminado es 8192. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
ParameterizationMode	Obtiene o establece un valor que indica queryParameterizationMode QueryParameterizationMode todas las instancias de ServerConnection que usan.
Password	Contraseña que se usa con inicio de sesión para conectarse al servidor. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Heredado de ConnectionSettings)
PooledConnectionLifetime	Cuando se devuelve una conexión al grupo, su tiempo de creación se compara con la hora actual y la conexión se destruye si ese intervalo de tiempo (en segundos) supera el valor especificado por la duración de la conexión. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
ProcessID	La propiedad ProcessID devuelve el identificador de proceso SQL Server para la conexión utilizada por el objeto ServerConnection.
ProductVersion	Obtiene la propiedad de servidor ProductVersion de esta conexión. (Heredado de ConnectionManager)
RequiresLogin	Devuelve true si los valores actuales de LoginSecure y Authentication requieren que se establezca una propiedad Login. (Heredado de ConnectionSettings)
ResetConnectionString	Indica si ConnectionString debe restablecerse en la propiedad SqlConnectionObject de ConnectionManager o no. (Heredado de ConnectionSettings)
SecureConnectionString	La propiedad devolverá una versión SecureString del usuario especificado cadena de conexión o devolverá el cadena de conexión calculado en función de la configuración del objeto. Si se establece explícitamente, todas las propiedades del objeto ServerConnection se rellenarán para reflejar el pasado en cadena de conexión. Excepciones: ConnectionCannotBeChangedException (Heredado de ConnectionSettings)
SecurePassword	Contraseña que se usa con inicio de sesión para conectarse al servidor. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Heredado de ConnectionSettings)
ServerCertificate	Ruta de acceso al certificado de servidor que se va a usar para la validación de certificados. (Heredado de ConnectionSettings)
ServerInstance	Nombre del SQL Server al que se conectará el objeto. Si no se establece, el servidor local está implícito. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)
ServerVersion	Devuelve el número de versión principal de SQL Server. Es decir, 8 para SQL Server 2000. Excepciones: ConnectionFailureException (Heredado de ConnectionManager)
SqlConnectionObject	Devuelve una referencia al objeto SqlConnection utilizado por el objeto ConnectionContext. Esto siempre debe devolver el objeto sqlConnection válido con el conjunto ConnectionString válido más reciente. Excepciones: PropertyNotAvailableException (Heredado de ConnectionManager)
SqlExecutionModes	Determina si se capturan o envían instrucciones SQL al servidor.
StatementTimeout	Este es el número de segundos que se intenta enviar una instrucción al servidor antes de que se produzca un error. El valor predeterminado es 600 segundos (igual que Shiloh). Excepciones: InvalidPropertyValueException
StrictEncryption	Indica si se especifica "encrypt=strict" en el cadena de conexión. Cuando es true, se omite el valor de EncryptConnection . (Heredado de ConnectionSettings)
TransactionDepth	Proporciona la profundidad de transacción que cuenta el modelo de objetos. Esto no incluye ninguna transacción que se haya iniciado en el servidor o emitiendo BEGIN TRAN con el método ExecuteNonQuery.
TrueLogin	La propiedad TrueLogin devuelve el nombre del registro de inicio de sesión utilizado por la conexión actual.
TrueName	La propiedad TrueName devuelve el conjunto de resultados del Microsoft ® SQL Server función global @@INSTANCENAME.
TrustServerCertificate	Indica si el cliente confía en el certificado de servidor. (Heredado de ConnectionSettings)
UseMode	Obtiene o establece el uso de DeferredUseMode todas las instancias de ServerConnection de UseMode.
UserProfile	La propiedad UserProfile devuelve una descripción de rol de alto nivel para el inicio de sesión de Microsoft SQL Server usado por la conexión actual.
WorkstationId	Nombre de la estación de trabajo que se conecta a SQL Server. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings)

Métodos

Nombre	Description
BeginTransaction()	Inicia una nueva transacción. Si CaptureMode es true, la instrucción transaction se agregará al búfer de captura. Es posible anidar transacciones. Es responsabilidad del usuario confirmar o revertir todas las transacciones abiertas. No se garantiza que una transacción pueda encapsular todas las T-SQL emitidas por el modelo de objetos. Además, el estado de los objetos que se han cambiado no reflejará el estado real de la base de datos hasta que se haya confirmado una transacción o después de que se haya revertido una transacción. Es responsabilidad del usuario actualizar los objetos afectados. Úselo con cuidado.
Cancel()
ChangePassword(SecureString)
ChangePassword(String)
CheckServerVersion(ServerVersion)	Compruebe si estamos conectando a una versión de servidor compatible. block off <= 7.0 en ServerConnection. (Heredado de ConnectionManager)
CommitTransaction()	Confirma una transacción. Si CaptureMode es true, el comando de transacción se agregará al búfer de captura. Excepciones: NotInTransactionException
Connect()	Crea la conexión real a SQL Server. Se omite si ya está conectado. Es opcional llamar a este método, ya que la conexión se abrirá cuando sea necesario. Excepciones: ConnectionFailureException (Heredado de ConnectionManager)
Copy()	Esta función realiza una copia en profundidad
Disconnect()	Cierra la conexión con SQL Server. Se omite si ya está desconectado. Excepciones: ConnectionFailureException (Heredado de ConnectionManager)
ExecuteNonQuery(String, ExecutionTypes, Boolean)	Ejecuta una instrucción T-SQL. ExecuteNonQuery reconoce el término de comando ('GO'). Los lotes se enviarán y ejecutarán individualmente. La instrucción se registra y no se ejecuta si CaptureMode se ha establecido en true. Se devuelve un valor int que contiene los números de filas afectadas. Si se ejecutan varios lotes, se devuelven los números totales de filas afectadas de todos los lotes. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String, ExecutionTypes)	Ejecuta una instrucción T-SQL. ExecuteNonQuery reconoce el término de comando ('GO'). Los lotes se enviarán y ejecutarán individualmente. La instrucción se registra y no se ejecuta si CaptureMode se ha establecido en true. Se devuelve un valor int que contiene los números de filas afectadas. Si se ejecutan varios lotes, se devuelven los números totales de filas afectadas de todos los lotes. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String)
ExecuteNonQuery(StringCollection, ExecutionTypes, Boolean)	Ejecuta las instrucciones T-SQL en StringCollection. ExecuteNonQuery reconoce el término de comando ('GO'). Los lotes separados con la instrucción GO se enviarán y ejecutarán individualmente. La instrucción se registra y no se ejecuta si CaptureMode se ha establecido en true. Se devuelve una matriz de valores int que contienen los números de filas afectadas por cada instrucción de StringCollection. Si se ejecutan varios lotes, se devuelven los números totales de filas afectadas de todos los lotes. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection, ExecutionTypes)	Ejecuta las instrucciones T-SQL en StringCollection. ExecuteNonQuery reconoce el término de comando ('GO'). Los lotes separados con la instrucción GO se enviarán y ejecutarán individualmente. La instrucción se registra y no se ejecuta si CaptureMode se ha establecido en true. Se devuelve una matriz de valores int que contienen los números de filas afectadas por cada instrucción de StringCollection. Si se ejecutan varios lotes, se devuelven los números totales de filas afectadas de todos los lotes. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection)
ExecuteReader(String, SqlCommand)	Ejecuta instrucciones T-SQL. Se devuelve un objeto SqlDataReader que se puede usar para leer la secuencia de filas devueltas por SQL Server. También se devuelve un objeto SqlCommand que se puede usar para cancelar la canalización del lector de datos si se necesita una anulación de una consulta de larga duración. no desconecta automáticamente excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteReader(String)	Ejecuta instrucciones T-SQL. Se devuelve un objeto SqlDataReader que se puede usar para leer la secuencia de filas devueltas por SQL Server. Se llamará al método Connect() si la conexión con el servidor no está abierta. no desconecta automáticamente excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(String)	Ejecuta una instrucción T-SQL. Se devuelve un objeto que contiene la primera columna de la primera fila del conjunto de resultados. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(StringCollection)	Ejecuta las instrucciones T-SQL en StringCollection. Se devuelve una matriz de objetos que contienen la primera columna de la primera fila del conjunto de resultados de cada instrucción ejecutada. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	Ejecuta T-SQL mediante los métodos adecuados en función de la información de acción que se pasa como parámetro. (Heredado de ConnectionManager)
ExecuteWithResults(String, Boolean)	Ejecuta las instrucciones T-SQL en sqlCommand. Se devuelve un dataSet que contiene los resultados. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(String)	Ejecuta las instrucciones T-SQL en sqlCommand. Se devuelve un dataSet que contiene los resultados. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(StringCollection)	Ejecuta las instrucciones T-SQL en StringCollection. Se devuelve una matriz de Conjuntos de datos que contienen los resultados de cada instrucción de StringCollection. Se llamará al método Connect() si la conexión con el servidor no está abierta. Excepciones: ConnectionFailureException ExecutionFailureExeception
ForceDisconnected()	Aplica una desconexión y garantiza que la conexión no se pueda volver a abrir de nuevo. (Heredado de ConnectionManager)
GetDatabaseConnection(String, Boolean, IRenewableToken)	Devuelve una conexión que tiene el nombre de base de datos especificado en el cadena de conexión Si la conexión actual ya hace referencia a la base de datos especificada, se devuelve la conexión actual.
GetDatabaseConnection(String, Boolean)	Devuelve una conexión que tiene el nombre de base de datos especificado en el cadena de conexión. Si la conexión actual ya hace referencia a la base de datos determinada, se devuelve la conexión actual.
IsInFixedServerRole(FixedServerRoles)	Comprueba si el inicio de sesión es miembro de cualquiera de los roles de servidor especificados.
NormalizeQuery(String, Boolean)	Traducir una consulta con literales incrustados a un formulario normalizado (todos los literales reemplazados por un token estándar)
NormalizeQuery(String)	Sobrecarga de la función anterior: consulte para obtener más información.
RollBackTransaction()	Anula una transacción (todos los cambios realizados no se guardarán en la base de datos). Si CaptureMode es true, el comando de transacción se agregará al búfer de captura. Excepciones: NotInTransactionException
ThrowIfPropertyNotSet(String, String, Boolean)	(Heredado de ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	(Heredado de ConnectionSettings)
ToString()	(Heredado de ConnectionSettings)

Eventos

Nombre	Description
InfoMessage	Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia. Usa SqlClient.SqlInfoMessageEventHandler. (Heredado de ConnectionManager)
RemoteLoginFailed	Se llama cuando el servidor necesita conectarse a servidores remotos y se produce un error en el inicio de sesión. (Heredado de ConnectionManager)
ServerMessage	Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia. Usa SqlClient.SqlInfoMessageEventHandler. (Heredado de ConnectionManager)
StateChange	Se produce cuando cambia el estado de la conexión. Usa System.Data.StateChangeEventHandler. (Heredado de ConnectionManager)
StatementExecuted	(Heredado de ConnectionManager)

Implementaciones de interfaz explícitas

Nombre	Description
ISfcConnection.Connect()
ISfcConnection.Copy()
ISfcConnection.Disconnect()
ISfcConnection.ServerVersion
ISfcConnection.ToEnumeratorObject()