Freigeben über


ConnectionManager-Klasse

Die ConnectionManager-Klasse verwaltet die Verbindung mit einer SQL Server-Instanz.

Vererbungshierarchie

Object
  Microsoft.SqlServer.Management.Common.ConnectionSettings
    Microsoft.SqlServer.Management.Common.ConnectionManager
      Microsoft.SqlServer.Management.Common.ServerConnection

Namespace:  Microsoft.SqlServer.Management.Common
Assembly:  Microsoft.SqlServer.ConnectionInfo (in Microsoft.SqlServer.ConnectionInfo.dll)

Syntax

'Declaration
Public MustInherit Class ConnectionManager _
    Inherits ConnectionSettings
'Usage
Dim instance As ConnectionManager
public abstract class ConnectionManager : ConnectionSettings
public ref class ConnectionManager abstract : public ConnectionSettings
[<AbstractClassAttribute>]
type ConnectionManager =  
    class 
        inherit ConnectionSettings 
    end
public abstract class ConnectionManager extends ConnectionSettings

Der ConnectionManager-Typ macht folgende Elemente verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft ApplicationName Ruft den Namen der Anwendung ab, die die Verbindung mit dem Server hergestellt hat, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft AutoDisconnectMode Ruft den Modus zum automatischen Trennen der Verbindung, auf die verwiesen wird, von der SQL Server-Instanz ab oder legt ihn fest.
Öffentliche Eigenschaft CapturedSql Ruft die Transact-SQL-Anweisungen ab, die aufgezeichnet werden, wenn die Verbindung im Aufzeichnungsmodus ausgeführt wird.
Öffentliche Eigenschaft ConnectAsUser Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung mit Identitätswechsel hergestellt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ConnectAsUserName Ruft beim Herstellen einer Verbindung mit Identitätswechsel den Namen des Benutzers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ConnectAsUserPassword Ruft beim Herstellen einer Verbindung mit Identitätswechsel das Kennwort für den Benutzer ab oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ConnectionString Ruft die zum Herstellen einer Verbindung mit einer angegebenen Datenquelle verwendete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ConnectTimeout Ruft den Timeoutzeitraum für die Verbindung in Sekunden ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft DatabaseEngineType Ruft den Typ des Datenbankmoduls ab.
Öffentliche Eigenschaft DatabaseName Ruft die für die Verbindung erforderliche Datenbank ab oder legt diese fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft EncryptConnection Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verschlüsselt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft InUse Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verwendet wird, oder legt ihn fest.
Öffentliche Eigenschaft IsForceDisconnected Ruft einen Boolean-Wert ab, der angibt, ob die Trennung der Verbindung erzwungen wurde.
Öffentliche Eigenschaft IsOpen Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung derzeit geöffnet ist.
Öffentliche Eigenschaft LockTimeout Ruft die Zeit bis zum Verbindungstimeout in Sekunden ab, wenn die aktuelle Transaktion gesperrt ist, oder legt sie fest.
Öffentliche Eigenschaft Login Ruft den Anmeldenamen ab, der zum Herstellen einer Verbindung mit der Serverinstanz erforderlich ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft LoginSecure Ruft die Boolean-Eigenschaft ab, die angibt, ob die Verbindung mit dem Server unter Verwendung der Windows-Authentifizierung oder der SQL Server-Authentifizierung hergestellt wird, oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft MaxPoolSize Ruft die maximale Anzahl von Verbindungen in einem Verbindungspool ab, die die angegebene Verbindung beim Herstellen einer Verbindung mit einem Server akzeptiert, oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft MinPoolSize Ruft die Mindestanzahl von Verbindungen in einem Verbindungspool ab, die die angegebene Verbindung beim Herstellen einer Verbindung mit einem Server akzeptiert, oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft MultipleActiveResultSets Ruft den Boolean-Eigenschaftswert ab, der angibt, ob mehr als ein aktives Resultset zulässig ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft NetworkProtocol Ruft das Netzwerkprotokoll ab, das zum Herstellen der Verbindung mit dem Server verwendet wird, oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft NonPooledConnection Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung in einem Pool enthalten sein darf oder nicht, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft PacketSize Ruft die zwischen Client und Server über das Netzwerk gesendeten Datenpakete in Bytes ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft Password Ruft das bei Verwendung der SQL Server-Authentifizierung zum Herstellen einer Serververbindung mit dem Anmeldenamen verwendete Kennwort ab oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft PooledConnectionLifetime Ruft die Lebensdauer der in einem Pool enthaltenen Verbindung ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Geschützte Eigenschaft ResetConnectionString Ruft einen Boolean-Wert ab, der angibt, ob ein Knoten in der Verbindungszeichenfolge geändert wurde, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft SecureConnectionString Ruft eine verschlüsselte Version der Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft SecurePassword Ruft das bei Verwendung der SQL Server-Authentifizierung zum Herstellen einer Serververbindung mit dem Anmeldenamen verwendete sichere Kennwort ab oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ServerInstance Ruft den Namen des Servers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche Eigenschaft ServerVersion Ruft die Version der verbundenen SQL Server-Instanz ab.
Öffentliche Eigenschaft SqlConnectionObject Ruft das Verbindungsobjekt ab.
Öffentliche Eigenschaft WorkstationId Ruft den ID-Wert ab, durch den die Arbeitsstation eindeutig identifiziert wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)

Nach oben

Methoden

  Name Beschreibung
Geschützte Methode CheckServerVersion Überprüft die Version der SQL Server-Zielinstanz.
Öffentliche Methode Connect Stellt eine Verbindung mit der SQL Server-Instanz her.
Öffentliche Methode Disconnect Trennt die Verbindung mit der SQL Server-Instanz.
Öffentliche Methode Equals (Geerbt von Object.)
Geschützte Methode ExecuteTSql Führt einen Transact-SQL-Befehl aus.
Geschützte Methode Finalize (Geerbt von Object.)
Öffentliche Methode ForceDisconnected Erzwingt, dass die SQL Server-Instanz getrennt wird.
Öffentliche Methode GetHashCode (Geerbt von Object.)
Öffentliche Methode GetType (Geerbt von Object.)
Geschützte Methode MemberwiseClone (Geerbt von Object.)
Geschützte Methode ThrowIfPropertyNotSet(String, String) Löst eine Ausnahme aus, wenn die angegebene Verbindungseigenschaft NULL oder leer ist. (Geerbt von ConnectionSettings.)
Geschützte Methode ThrowIfPropertyNotSet(String, String, Boolean) Löst eine Ausnahme aus, wenn die angegebene Verbindungseigenschaft NULL oder (optional) leer ist. (Geerbt von ConnectionSettings.)
Öffentliche Methode ToString Gibt den Objektnamen, auf den verwiesen wird, als Zeichenfolge zurück. (Geerbt von ConnectionSettings.)

Nach oben

Ereignisse

  Name Beschreibung
Öffentliches Ereignis InfoMessage Das Ereignis, das auftritt, wenn die SQL Server-Instanz eine Informationsmeldung generiert. 
Öffentliches Ereignis RemoteLoginFailed Dieses Ereignis tritt auf, wenn bei einer Remoteanmeldung keine Verbindung mit der SQL Server-Instanz hergestellt werden kann.
Öffentliches Ereignis ServerMessage Das Ereignis, das auftritt, wenn SQL Server eine Warnung oder Informationsmeldung über die aktuelle Verbindung zurückgibt.
Öffentliches Ereignis StateChange Das Ereignis, das auftritt, wenn sich der Status der SQL Server-Instanz ändert. 
Öffentliches Ereignis StatementExecuted Das Ereignis, das auftritt, wenn die SQL Server-Instanz eine Anweisung über die aktuelle Verbindung ausführt. 

Nach oben

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.SqlServer.Management.Common-Namespace