ConnectionManager Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
configuración y creación de conexiones
public abstract class ConnectionManager : Microsoft.SqlServer.Management.Common.ConnectionSettings
type ConnectionManager = class
inherit ConnectionSettings
Public MustInherit Class ConnectionManager
Inherits ConnectionSettings
- Herencia
- Derivado
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 |
configuración y creación de conexiones (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 |
configuración y creación de conexiones |
| CapturedSql |
configuración y creación de conexiones |
| 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. |
| 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) |
| 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. |
| DatabaseEngineEdition |
Edición del Motor de base de datos |
| DatabaseEngineType |
Devuelve el tipo de motor de base de datos de SQL Server. Excepciones: ConnectionFailureException |
| DatabaseName |
TBD (Heredado de ConnectionSettings) |
| EncryptConnection |
si se especifica "encrypt=true" en el cadena de conexión (Heredado de ConnectionSettings) |
| 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.) |
| 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. |
| IsContainedAuthentication |
Devuelve true si el motor de base de datos se autentica mediante la autenticación independiente. Excepciones: ConnectionFailureException |
| IsForceDisconnected |
Indica que la conexión se ha desconectado de forma forzada. |
| 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. |
| 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". |
| 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) |
| 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) |
| ProductVersion |
Obtiene la propiedad de servidor ProductVersion de esta conexión. |
| 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 |
| 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 |
| 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) |
| TrustServerCertificate |
Indica si el cliente confía en el certificado de servidor. (Heredado de ConnectionSettings) |
| WorkstationId |
Nombre de la estación de trabajo que se conecta a SQL Server. Excepciones: ConnectionCannotBeChangedException InvalidPropertyValueException (Heredado de ConnectionSettings) |
Métodos
| Nombre | Description |
|---|---|
| CheckServerVersion(ServerVersion) |
Compruebe si estamos conectando a una versión de servidor compatible. block off <= 7.0 en ServerConnection. |
| 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 |
| Disconnect() |
Cierra la conexión con SQL Server. Se omite si ya está desconectado. Excepciones: ConnectionFailureException |
| 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. |
| ForceDisconnected() |
Aplica una desconexión y garantiza que la conexión no se pueda volver a abrir de nuevo. |
| ThrowIfPropertyNotSet(String, String, Boolean) |
configuración y creación de conexiones (Heredado de ConnectionSettings) |
| ThrowIfPropertyNotSet(String, String) |
configuración y creación de conexiones (Heredado de ConnectionSettings) |
| ToString() |
configuración y creación de conexiones (Heredado de ConnectionSettings) |
Eventos
| Nombre | Description |
|---|---|
| InfoMessage |
Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia. Usa SqlClient.SqlInfoMessageEventHandler. |
| RemoteLoginFailed |
Se llama cuando el servidor necesita conectarse a servidores remotos y se produce un error en el inicio de sesión. |
| ServerMessage |
Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia. Usa SqlClient.SqlInfoMessageEventHandler. |
| StateChange |
Se produce cuando cambia el estado de la conexión. Usa System.Data.StateChangeEventHandler. |
| StatementExecuted |
configuración y creación de conexiones |