ServerConnection Classe

Définition

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()

S’applique à