ConnectionManager Classe

Définition

Espace de noms:: Microsoft.SqlServer.Management.Common

Assembly:: Microsoft.SqlServer.ConnectionInfo.dll

Paquet:: Microsoft.Data.Tools.Msbuild v10.0.61804.210

Paquet:: Microsoft.Data.Tools.Msbuild v16.0.62004.28040

Paquet:: Microsoft.SqlServer.SqlManagementObjects v150.18208.0

Paquet:: Microsoft.SqlServer.SqlManagementObjects v160.2004021.0

Paquet:: Microsoft.SqlServer.SqlManagementObjects v172.64.0

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

paramètres de connexion et création

public abstract class ConnectionManager : Microsoft.SqlServer.Management.Common.ConnectionSettings

type ConnectionManager = class
    inherit ConnectionSettings

Public MustInherit Class ConnectionManager
Inherits ConnectionSettings

Héritage: Object

ConnectionSettings
ConnectionManager

Dérivé: Microsoft.SqlServer.Management.Common.ServerConnection

Champs

Nom	Description
NoConnectionTimeout	Attente infinie (Hérité de ConnectionSettings)

Propriétés

Nom	Description
AcceptsLogin	Retourne true si les valeurs actuelles de LoginSecure et d’authentification utilisent la propriété Login (Hérité de ConnectionSettings)
AccessToken	paramètres de connexion et création (Hérité de ConnectionSettings)
ApplicationIntent	L’intention de l’application des valeurs valides de connexion est ReadWrite et ReadOnly (Hérité de ConnectionSettings)
ApplicationName	Nom de l’application. « Gestion SQL » si aucun nom d’application n’a été fourni. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
Authentication	Type d’authentification de la connexion (Hérité de ConnectionSettings)
AutoDisconnectMode	paramètres de connexion et création
CapturedSql	paramètres de connexion et création
ConnectAsUser	Si la valeur est true, la connexion est établie avec les informations d’identification de l’utilisateur spécifié. Cela suppose l’emprunt d’identité, mais les indicateurs LoginSecure et les champs Connexion et Mot de passe ne seront pas affectés. Ce paramètre est utilisable uniquement sur Windows. (Hérité de ConnectionSettings)
ConnectAsUserName	Spécifie l’utilisateur Windows utilisé lors de la création d’une connexion emprunt d’identité. L’utilisateur doit disposer de privilèges d’ouverture de session interactifs. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Hérité de ConnectionSettings)
ConnectAsUserPassword	Spécifie le mot de passe de l’utilisateur Windows utilisé lors de la création d’une connexion emprunt d’identité. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Hérité de ConnectionSettings)
ConnectionProtocol	Protocole de connexion.
ConnectionString	La propriété retourne le chaîne de connexion spécifié par l’utilisateur ou renvoie l’chaîne de connexion calculée en fonction des paramètres de l’objet. Si elle est définie explicitement, toutes les propriétés de l’objet ServerConnection sont remplies pour refléter le chaîne de connexion passé. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
ConnectTimeout	Durée (en secondes) d’attente d’une connexion au serveur avant de terminer la tentative et de lever une exception. La valeur par défaut est de 30 secondes (identique à Shiloh). Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
CurrentDatabase	Retourne le contexte de base de données actuel.
DatabaseEngineEdition	L’édition du Moteur de base de données
DatabaseEngineType	Retourne le type de moteur de base de données de SQL Server. Exceptions : ConnectionFailureException
DatabaseName	À déterminer (Hérité de ConnectionSettings)
EncryptConnection	indique si « encrypt=true » est spécifié dans le chaîne de connexion (Hérité de ConnectionSettings)
HostNameInCertificate	Nom d’hôte fourni dans le certificat à utiliser pour la validation de certificat. (Hérité de ConnectionSettings)
HostPlatform	Plateforme hôte du serveur (Linux/Windows/etc)
InUse	Retourne true si l’objet a été connecté au serveur au moins une fois. Si la valeur est true, les modifications de propriété ne sont plus autorisées et ConnectionCannotBeChangedException est levée lorsqu’une propriété a été modifiée.
IsContainedAuthentication	Retourne true si le moteur de base de données s’authentifie à l’aide de l’authentification autonome. Exceptions : ConnectionFailureException
IsForceDisconnected	Indique que la connexion a été déconnectée avec force
IsOpen	Retourne true si l’objet SqlConnection est connecté au serveur. Cela ne peut retourner true que pour les connexions non mises en pool, car les connexions mises en pool sont toujours fermées directement après une opération.
LockTimeout	LockTimeout est le délai d’expiration du verrouillage en secondes. La -1 par défaut est indéfinie. InvalidPropertyValueException est levée pour tous les autres nombres négatifs. Le paramètre LockTimeout positif est multiplié par 1 000, puis utilisé pour le paramètre « SET LOCK_TIMEOUT ».
Login	Nom de connexion SQL Server utilisé pour se connecter au serveur. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Hérité de ConnectionSettings)
LoginSecure	Si la valeur est true, Windows sécurité intégrée est utilisée et la connexion et le mot de passe sont ignorés. Si elle n’est pas définie, l’authentification Sql Server est utilisée. Exceptions : ConnectionCannotBeChangedException (Hérité de ConnectionSettings)
MaxPoolSize	Nombre maximal de connexions autorisées dans le pool. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
MinPoolSize	Nombre minimal de connexions conservées dans le pool. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
MultipleActiveResultSets	Activez MARS à partir de la connexion. La valeur par défaut est false. (Hérité de ConnectionSettings)
NetworkProtocol	Identifie le protocole réseau client utilisé pour se connecter à SQL Server. Si vous ne spécifiez pas de réseau et que vous utilisez un serveur local, la mémoire partagée est utilisée. Si vous ne spécifiez pas de réseau et que vous utilisez un serveur distant, l’un des protocoles clients configurés est utilisé. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
NonPooledConnection	Par défaut, toutes les connexions à SQL Server sont extraites d’un pool de connexions ADO.NET. Si la valeur est true, cela permet aux utilisateurs de créer une connexion non mise en pool (ne sera pas réutilisée lors de la fermeture). Exceptions : ConnectionCannotBeChangedException (Hérité de ConnectionSettings)
PacketSize	Taille en octets des paquets réseau utilisés pour communiquer avec une instance de SQL Server. La valeur par défaut est 8192. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
Password	Mot de passe utilisé avec connexion pour se connecter au serveur. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Hérité de ConnectionSettings)
PooledConnectionLifetime	Lorsqu’une connexion est retournée au pool, son heure de création est comparée à l’heure actuelle et la connexion est détruite si cette période (en secondes) dépasse la valeur spécifiée par la durée de vie de la connexion. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
ProductVersion	Obtient la propriété du serveur ProductVersion de cette connexion
RequiresLogin	Retourne true si les valeurs actuelles de LoginSecure et d’authentification nécessitent la définition d’une propriété Login (Hérité de ConnectionSettings)
ResetConnectionString	Indique si ConnectionString doit être réinitialisé dans la propriété SqlConnectionObject de ConnectionManager ou non. (Hérité de ConnectionSettings)
SecureConnectionString	La propriété retourne une version SecureString de l’utilisateur spécifié chaîne de connexion ou retourne la chaîne de connexion calculée en fonction des paramètres d’objet. Si elle est définie explicitement, toutes les propriétés de l’objet ServerConnection sont remplies pour refléter le chaîne de connexion passé. Exceptions : ConnectionCannotBeChangedException (Hérité de ConnectionSettings)
SecurePassword	Mot de passe utilisé avec connexion pour se connecter au serveur. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Hérité de ConnectionSettings)
ServerCertificate	Chemin d’accès au certificat de serveur à utiliser pour la validation de certificat. (Hérité de ConnectionSettings)
ServerInstance	Nom de l’SQL Server l’objet se connecte. S’il n’est pas défini, le serveur local est implicite. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)
ServerVersion	Retourne le numéro de version principal de SQL Server. C’est-à-dire 8 pour SQL Server 2000. Exceptions : ConnectionFailureException
SqlConnectionObject	Renvoie une référence à l’objet SqlConnection utilisé par l’objet ConnectionContext. Cela doit toujours retourner l’objet sqlConnection valide avec le dernier jeu ConnectionString valide. Exceptions : PropertyNotAvailableException
StrictEncryption	Indique si « encrypt=strict » est spécifié dans la chaîne de connexion. Lorsque la valeur est true, la valeur de celle-ci EncryptConnection est ignorée. (Hérité de ConnectionSettings)
TrustServerCertificate	Indiquer si le client approuve le certificat de serveur (Hérité de ConnectionSettings)
WorkstationId	Nom de la station de travail qui se connecte à SQL Server. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings)

Méthodes

Nom	Description
CheckServerVersion(ServerVersion)	Vérifiez si nous nous connectons à une version de serveur prise en charge. block off <= 7.0 dans ServerConnection.
Connect()	Crée la connexion réelle à SQL Server. Ignoré si déjà connecté. Il est facultatif d’appeler cette méthode, car la connexion est ouverte lorsque nécessaire. Exceptions : ConnectionFailureException
Disconnect()	Ferme la connexion avec SQL Server. Ignoré si déjà déconnecté. Exceptions : ConnectionFailureException
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	Exécute T-SQL à l’aide des méthodes appropriées en fonction des informations d’action passées en tant que paramètre.
ForceDisconnected()	Applique une déconnexion et garantit que la connexion ne peut pas être rouverte
ThrowIfPropertyNotSet(String, String, Boolean)	paramètres de connexion et création (Hérité de ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	paramètres de connexion et création (Hérité de ConnectionSettings)
ToString()	paramètres de connexion et création (Hérité de ConnectionSettings)

Événements

Nom	Description
InfoMessage	Se produit lorsque SQL Server retourne un message d’avertissement ou d’information. Utilise SqlClient.SqlInfoMessageEventHandler.
RemoteLoginFailed	Appelé lorsque le serveur doit se connecter à des serveurs distants et que la connexion échoue
ServerMessage	Se produit lorsque SQL Server retourne un message d’avertissement ou d’information. Utilise SqlClient.SqlInfoMessageEventHandler.
StateChange	Se produit lorsque l’état de la connexion change. Utilise System.Data.StateChangeEventHandler.
StatementExecuted	paramètres de connexion et création

S’applique à