ServerConnection Classe
Définition
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.
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
- Héritage
- Implémente
Constructeurs
| Nom | Description |
|---|---|
| ServerConnection() | |
| ServerConnection(IRenewableToken) |
Crée un objet ServerConnection prenant dans le jeton. Le booléen supplémentaire est utilisé pour surcharger ce constructeur comme un autre constructeur avec une chaîne est présent. |
| ServerConnection(SqlConnection, IRenewableToken) |
Construit un nouvel objet ServerConnection |
| ServerConnection(SqlConnection, IRenewableToken) |
Construit un nouvel objet ServerConnection |
| ServerConnection(SqlConnection) |
Construit un nouvel objet ServerConnection à partir de sqlConnection donné |
| ServerConnection(SqlConnection) |
Construit un nouvel objet ServerConnection à partir de sqlConnection donné |
| ServerConnection(SqlConnectionInfo) | |
| ServerConnection(String, String, SecureString) | |
| ServerConnection(String, String, String) | |
| ServerConnection(String) | |
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 | (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 | (Hérité de ConnectionManager) |
| BatchSeparator |
Définit le séparateur de lots utilisé par les méthodes ExecuteNonQuery. La valeur par défaut est « GO ». Le séparateur de lots ne respecte pas la casse. |
| CachedQueries |
Obtient ou définit une valeur indiquant si les instances ServerConnection doivent mettre en cache les résultats des requêtes |
| CapturedSql | (Hérité de ConnectionManager) |
| 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. (Hérité de ConnectionManager) |
| 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) |
| ConnectionType | |
| 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. (Hérité de ConnectionManager) |
| DatabaseEngineEdition |
L’édition du Moteur de base de données (Hérité de ConnectionManager) |
| DatabaseEngineType |
Retourne le type de moteur de base de données de SQL Server. Exceptions : ConnectionFailureException (Hérité de ConnectionManager) |
| 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) |
| FixedServerRoles |
Retourne une énumération qui a spécifié le rôle serveur fixe dont la connexion est membre. |
| 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) (Hérité de ConnectionManager) |
| 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. (Hérité de ConnectionManager) |
| IsContainedAuthentication |
Retourne true si le moteur de base de données s’authentifie à l’aide de l’authentification autonome. Exceptions : ConnectionFailureException (Hérité de ConnectionManager) |
| IsForceDisconnected |
Indique que la connexion a été déconnectée avec force (Hérité de ConnectionManager) |
| 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. (Hérité de ConnectionManager) |
| 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 ». (Hérité de ConnectionManager) |
| 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) |
| ParameterizationMode |
Obtient ou définit une valeur indiquant que les QueryParameterizationMode instances QueryParameterizationMode toutes les instances ServerConnection utilisent |
| 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) |
| ProcessID |
La propriété ProcessID retourne l’identificateur de processus SQL Server pour la connexion utilisée par l’objet ServerConnection. |
| ProductVersion |
Obtient la propriété du serveur ProductVersion de cette connexion (Hérité de ConnectionManager) |
| 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 (Hérité de ConnectionManager) |
| 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 (Hérité de ConnectionManager) |
| SqlExecutionModes |
Détermine si les instructions SQL sont capturées ou envoyées au serveur. |
| StatementTimeout |
Il s’agit du nombre de secondes qu’une instruction a tenté d’être envoyée au serveur avant qu’elle ne échoue. La valeur par défaut est de 600 secondes (identique à Shiloh). Exceptions : InvalidPropertyValueException |
| 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) |
| TransactionDepth |
Fournit la profondeur de transaction telle que comptée par le modèle objet. Cela n’inclut aucune transaction qui a pu être démarrée sur le serveur ou en émettant BEGIN TRAN avec la méthode ExecuteNonQuery. |
| TrueLogin |
La propriété TrueLogin retourne le nom de l’enregistrement de connexion utilisé par la connexion actuelle. |
| TrueName |
La propriété TrueName retourne le jeu de résultats de la @@INSTANCENAME de fonction globale Microsoft ® SQL Server. |
| TrustServerCertificate |
Indiquer si le client approuve le certificat de serveur (Hérité de ConnectionSettings) |
| UseMode |
Obtient ou définit l’utilisation des DeferredUseMode instances UseMode all ServerConnection |
| UserProfile |
La propriété UserProfile retourne une description de rôle de haut niveau pour la connexion Microsoft SQL Server utilisée par la connexion actuelle. |
| WorkstationId |
Nom de la station de travail qui se connecte à SQL Server. Exceptions : ConnectionCannotBeChangedException InvalidPropertyValueException (Hérité de ConnectionSettings) |
Méthodes
| Nom | Description |
|---|---|
| BeginTransaction() |
Démarre une nouvelle transaction. Si CaptureMode a la valeur true, l’instruction de transaction est ajoutée à la mémoire tampon de capture. Il est possible d’imbriquer des transactions. Il incombe à l’utilisateur de valider ou de restaurer chaque transaction ouverte. Il n’est pas garanti que tous les T-SQL émis par le modèle objet peuvent être encapsulés par une transaction. En outre, l’état des objets qui ont été modifiés ne reflète pas l’état réel de la base de données tant qu’une transaction n’a pas été validée ou après la restauration d’une transaction. Il incombe à l’utilisateur d’actualiser les objets affectés. Utilisez avec soin. |
| Cancel() | |
| ChangePassword(SecureString) | |
| ChangePassword(String) | |
| CheckServerVersion(ServerVersion) |
Vérifiez si nous nous connectons à une version de serveur prise en charge. block off <= 7.0 dans ServerConnection. (Hérité de ConnectionManager) |
| CommitTransaction() |
Valide une transaction. Si CaptureMode est true, la commande de transaction est ajoutée à la mémoire tampon de capture. Exceptions : NotInTransactionException |
| 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 (Hérité de ConnectionManager) |
| Copy() |
Cette fonction effectue une copie approfondie |
| Disconnect() |
Ferme la connexion avec SQL Server. Ignoré si déjà déconnecté. Exceptions : ConnectionFailureException (Hérité de ConnectionManager) |
| ExecuteNonQuery(String, ExecutionTypes, Boolean) |
Exécute une instruction T-SQL. Le termininateur de commande ('GO') est reconnu par ExecuteNonQuery. Les lots seront envoyés et exécutés individuellement. L’instruction est enregistrée et n’est pas exécutée si CaptureMode a été défini sur true. Une valeur int est retournée qui contient le nombre de lignes affectées. Si plusieurs lots sont exécutés, le nombre total de lignes affectées de tous les lots est retourné. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(String, ExecutionTypes) |
Exécute une instruction T-SQL. Le termininateur de commande ('GO') est reconnu par ExecuteNonQuery. Les lots seront envoyés et exécutés individuellement. L’instruction est enregistrée et n’est pas exécutée si CaptureMode a été défini sur true. Une valeur int est retournée qui contient le nombre de lignes affectées. Si plusieurs lots sont exécutés, le nombre total de lignes affectées de tous les lots est retourné. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(String) | |
| ExecuteNonQuery(StringCollection, ExecutionTypes, Boolean) |
Exécute les instructions T-SQL dans StringCollection. Le termininateur de commande ('GO') est reconnu par ExecuteNonQuery. Les lots séparés par l’instruction GO sont envoyés et exécutés individuellement. L’instruction est enregistrée et n’est pas exécutée si CaptureMode a été défini sur true. Un tableau de valeurs int est retourné qui contient le nombre de lignes affectées pour chaque instruction dans StringCollection. Si plusieurs lots sont exécutés, le nombre total de lignes affectées de tous les lots est retourné. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(StringCollection, ExecutionTypes) |
Exécute les instructions T-SQL dans StringCollection. Le termininateur de commande ('GO') est reconnu par ExecuteNonQuery. Les lots séparés par l’instruction GO sont envoyés et exécutés individuellement. L’instruction est enregistrée et n’est pas exécutée si CaptureMode a été défini sur true. Un tableau de valeurs int est retourné qui contient le nombre de lignes affectées pour chaque instruction dans StringCollection. Si plusieurs lots sont exécutés, le nombre total de lignes affectées de tous les lots est retourné. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteNonQuery(StringCollection) | |
| ExecuteReader(String, SqlCommand) |
Exécute des instructions T-SQL. Un objet SqlDataReader est retourné qui peut être utilisé pour lire le flux de lignes retournées par SQL Server. Un objet SqlCommand est également retourné qui peut être utilisé pour annuler le canal de lecteur de données si une abandon d’une requête de longue durée est nécessaire. elle ne déconnecte pas automatiquement les exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteReader(String, SqlCommand) |
Exécute des instructions T-SQL. Un objet SqlDataReader est retourné qui peut être utilisé pour lire le flux de lignes retournées par SQL Server. Un objet SqlCommand est également retourné qui peut être utilisé pour annuler le canal de lecteur de données si une abandon d’une requête de longue durée est nécessaire. elle ne déconnecte pas automatiquement les exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteReader(String) |
Exécute des instructions T-SQL. Un objet SqlDataReader est retourné qui peut être utilisé pour lire le flux de lignes retournées par SQL Server. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. elle ne déconnecte pas automatiquement les exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteScalar(String) |
Exécute une instruction T-SQL. Un objet est retourné qui contient la première colonne de la première ligne du jeu de résultats. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteScalar(StringCollection) |
Exécute les instructions T-SQL dans StringCollection. Un tableau d’objets est retourné qui contient chacune la première colonne de la première ligne du jeu de résultats de chaque instruction exécutée. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| 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. (Hérité de ConnectionManager) |
| ExecuteWithResults(String, Boolean) |
Exécute les instructions T-SQL dans sqlCommand. Un DataSet est retourné qui contient les résultats. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteWithResults(String) |
Exécute les instructions T-SQL dans sqlCommand. Un DataSet est retourné qui contient les résultats. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ExecuteWithResults(StringCollection) |
Exécute les instructions T-SQL dans StringCollection. Un tableau de DataSets est retourné qui contient les résultats de chaque instruction dans StringCollection. La méthode Connect() est appelée si la connexion avec le serveur n’est pas ouverte. Exceptions : ConnectionFailureException ExecutionFailureExeception |
| ForceDisconnected() |
Applique une déconnexion et garantit que la connexion ne peut pas être rouverte (Hérité de ConnectionManager) |
| GetDatabaseConnection(String, Boolean, IRenewableToken) |
Retourne une connexion qui a le nom de base de données spécifié dans l’chaîne de connexion Si la connexion actuelle fait déjà référence à la base de données donnée, la connexion actuelle est retournée. |
| GetDatabaseConnection(String, Boolean) |
Retourne une connexion qui a le nom de base de données spécifié dans la chaîne de connexion. Si la connexion actuelle fait déjà référence à la base de données donnée, la connexion actuelle est retournée. |
| IsInFixedServerRole(FixedServerRoles) |
Teste si la connexion est membre de l’un des rôles serveur spécifiés. |
| NormalizeQuery(String, Boolean) |
Traduire une requête avec des littéraux incorporés en formulaire normalisé (tous les littéraux remplacés par un jeton standard) |
| NormalizeQuery(String) |
Surcharge de la fonction ci-dessus : consultez-le pour plus d’informations |
| RollBackTransaction() |
Abandonne une transaction (toutes les modifications apportées ne seront pas enregistrées dans la base de données). Si CaptureMode est true, la commande de transaction est ajoutée à la mémoire tampon de capture. Exceptions : NotInTransactionException |
| ThrowIfPropertyNotSet(String, String, Boolean) | (Hérité de ConnectionSettings) |
| ThrowIfPropertyNotSet(String, String) | (Hérité de ConnectionSettings) |
| ToString() | (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. (Hérité de ConnectionManager) |
| RemoteLoginFailed |
Appelé lorsque le serveur doit se connecter à des serveurs distants et que la connexion échoue (Hérité de ConnectionManager) |
| ServerMessage |
Se produit lorsque SQL Server retourne un message d’avertissement ou d’information. Utilise SqlClient.SqlInfoMessageEventHandler. (Hérité de ConnectionManager) |
| StateChange |
Se produit lorsque l’état de la connexion change. Utilise System.Data.StateChangeEventHandler. (Hérité de ConnectionManager) |
| StatementExecuted | (Hérité de ConnectionManager) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| ISfcConnection.Connect() | |
| ISfcConnection.Copy() | |
| ISfcConnection.Disconnect() | |
| ISfcConnection.ServerVersion | |
| ISfcConnection.ToEnumeratorObject() | |