Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ServerConnection-Klasse

Das ServerConnection-Objekt stellt eine Verbindung mit einem Server dar.

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

public sealed class ServerConnection : ConnectionManager, 
	ISfcConnection

Der ServerConnection-Typ macht folgende Elemente verfügbar.

  NameBeschreibung
Öffentliche MethodeServerConnection()Initialisiert eine neue Instanz der ServerConnection-Klasse.
Öffentliche MethodeServerConnection(SqlConnection)Initialisiert eine neue Instanz der ServerConnection-Klasse mit den angegebenen Verbindungsparametern.
Öffentliche MethodeServerConnection(String)Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz.
Öffentliche MethodeServerConnection(SqlConnectionInfo)Initialisiert eine neue Instanz der ServerConnection-Klasse mit den angegebenen Verbindungsinformationen.
Öffentliche MethodeServerConnection(String, String, SecureString)Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz und den angegebenen Anmeldeinformationen.
Öffentliche MethodeServerConnection(String, String, String)Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz und den angegebenen Anmeldeinformationen.
Nach oben

  NameBeschreibung
Öffentliche EigenschaftApplicationNameRuft den Namen der Anwendung ab, die die Verbindung mit dem Server hergestellt hat, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftAutoDisconnectModeRuft den Modus zum automatischen Trennen der Verbindung, auf die verwiesen wird, von der SQL Server-Instanz ab oder legt ihn fest. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftBatchSeparatorRuft den Zeichenfolgenwert ab, mit dem Batches in der Verbindung, auf die verwiesen wird, getrennt werden, oder legt ihn fest.
Öffentliche EigenschaftCapturedSqlRuft die Transact-SQL-Anweisungen ab, die aufgezeichnet werden, wenn die Verbindung im Aufzeichnungsmodus ausgeführt wird. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftConnectAsUserRuft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung mit Identitätswechsel hergestellt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftConnectAsUserNameRuft beim Herstellen einer Verbindung mit Identitätswechsel den Namen des Benutzers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftConnectAsUserPasswordRuft beim Herstellen einer Verbindung mit Identitätswechsel das Kennwort für den Benutzer ab oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftConnectionStringRuft die zum Herstellen einer Verbindung mit einer angegebenen Datenquelle verwendete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftConnectionTypeRuft den Typ der für den Server zu verwendenden Verbindung ab.
Öffentliche EigenschaftConnectTimeoutRuft den Timeoutzeitraum für die Verbindung in Sekunden ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftDatabaseEngineTypeRuft den Typ des Datenbankmoduls ab. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftDatabaseNameRuft die für die Verbindung erforderliche Datenbank ab oder legt diese fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftEncryptConnectionRuft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verschlüsselt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftFixedServerRolesRuft die der Verbindung, auf die verwiesen wird, zugeordnete feste Serverrolle ab.
Öffentliche EigenschaftInUseRuft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verwendet wird, oder legt ihn fest. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftIsForceDisconnectedRuft einen Boolean-Wert ab, der angibt, ob die Trennung der Verbindung erzwungen wurde. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftIsOpenRuft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung derzeit geöffnet ist. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftLockTimeoutRuft die Zeit bis zum Verbindungstimeout in Sekunden ab, wenn die aktuelle Transaktion gesperrt ist, oder legt sie fest. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftLoginRuft den Anmeldenamen ab, der zum Herstellen einer Verbindung mit der Serverinstanz erforderlich ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftLoginSecureRuft 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 EigenschaftMaxPoolSizeRuft 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 EigenschaftMinPoolSizeRuft 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 EigenschaftMultipleActiveResultSetsRuft den Boolean-Eigenschaftswert ab, der angibt, ob mehr als ein aktives Resultset zulässig ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftNetworkProtocolRuft das Netzwerkprotokoll ab, das zum Herstellen der Verbindung mit dem Server verwendet wird, oder legt es fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftNonPooledConnectionRuft 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 EigenschaftPacketSizeRuft die zwischen Client und Server über das Netzwerk gesendeten Datenpakete in Bytes ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftStatisches ElementParameterizationModeRuft den Parametrisierungsmodus für die Serververbindung ab oder legt ihn fest.
Öffentliche EigenschaftPasswordRuft 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 EigenschaftPooledConnectionLifetimeRuft die Lebensdauer der in einem Pool enthaltenen Verbindung ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftProcessIDRuft den ID-Wert ab, durch den der Prozess eindeutig identifiziert wird, der der Serververbindung zugeordnet ist, auf die verwiesen wird.
Öffentliche EigenschaftSecureConnectionStringRuft eine verschlüsselte Version der Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftSecurePasswordRuft 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 EigenschaftServerInstanceRuft den Namen des Servers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
Öffentliche EigenschaftServerVersionRuft die Version der verbundenen SQL Server-Instanz ab. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftSqlConnectionObjectRuft das Verbindungsobjekt ab. (Geerbt von ConnectionManager.)
Öffentliche EigenschaftSqlExecutionModesRuft den der Serververbindung, auf die verwiesen wird, zugeordneten Ausführungsmodus ab oder legt ihn fest.
Öffentliche EigenschaftStatementTimeoutRuft die Ausführungsdauer für eine Anweisung in Sekunden ab, bis die Anweisung mit einem Timeoutfehler fehlschlägt, oder legt sie fest.
Öffentliche EigenschaftTransactionDepthRuft die aktuelle Transaktionstiefe für die Verbindung ab, auf die verwiesen wird.
Öffentliche EigenschaftTrueLoginRuft den aktuellen Namen des Anmeldedatensatzes ab, der von der Verbindung verwendet wird, auf die verwiesen wird.
Öffentliche EigenschaftTrueNameRuft den Namen des Servers ab.
Öffentliche EigenschaftStatisches ElementUseModeRuft die Serververbindung mithilfe eines angegebenen Modus ab oder legt sie fest.
Öffentliche EigenschaftUserProfileRuft das der Verbindung, auf die verwiesen wird, zugeordnete Benutzerprofil ab.
Öffentliche EigenschaftWorkstationIdRuft den ID-Wert ab, durch den die Arbeitsstation eindeutig identifiziert wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
Nach oben

  NameBeschreibung
Öffentliche MethodeBeginTransactionStartet eine Transaktion über die Verbindung, auf die verwiesen wird.
Öffentliche MethodeCancelBricht die Verbindung ab.
Öffentliche MethodeChangePassword(SecureString)Ändert das Anmeldekennwort, das mit Standardauthentifizierung verwendet wird.
Öffentliche MethodeChangePassword(String)Ändert das Anmeldekennwort, das mit Standardauthentifizierung verwendet wird.
Öffentliche MethodeCommitTransactionFührt einen Commit für die aktuelle Transaktion über die Verbindung aus, auf die verwiesen wird.
Öffentliche MethodeConnectStellt eine Verbindung mit der SQL Server-Instanz her. (Geerbt von ConnectionManager.)
Öffentliche MethodeCopyGibt eine Kopie des ServerConnection-Objekts zurück.
Öffentliche MethodeDisconnectTrennt die Verbindung mit der SQL Server-Instanz. (Geerbt von ConnectionManager.)
Öffentliche MethodeEquals (Geerbt von Object.)
Öffentliche MethodeExecuteNonQuery(StringCollection)Führt einen Batch von Anweisungen aus, die kein Resultset zurückgeben.
Öffentliche MethodeExecuteNonQuery(String)Führt eine Anweisung aus, die kein Resultset zurückgibt.
Öffentliche MethodeExecuteNonQuery(StringCollection, ExecutionTypes)Führt einen Batch von Anweisungen, die kein Resultset zurückgeben, mit den angegebenen Ausführungsoptionen aus.
Öffentliche MethodeExecuteNonQuery(String, ExecutionTypes)Führt eine Anweisung, die kein Resultset zurückgibt, mit den angegebenen Ausführungsoptionen aus.
Öffentliche MethodeExecuteReader(String)Führt Transact-SQL-Anweisungen aus, die mindestens ein Resultset zurückgeben.
Öffentliche MethodeExecuteReader(String, SqlCommand)Führt einen Leser mithilfe eines SqlDataReader-Objektwerts aus, der mindestens ein Resultset enthält.
Öffentliche MethodeExecuteScalar(StringCollection)Führt einen Batch von Transact-SQL-Anweisungen aus und gibt die erste Spalte der ersten Zeile als Objektwert zurück.
Öffentliche MethodeExecuteScalar(String)Führt eine Transact-SQL-Anweisung aus und gibt die erste Spalte der ersten Zeile als Objektwert zurück.
Öffentliche MethodeExecuteWithResults(StringCollection)Führt einen Batch von Transact-SQL-Anweisungen aus, die mehrere Resultsets zurückgeben.
Öffentliche MethodeExecuteWithResults(String)Führt eine Transact-SQL-Anweisung aus, die ein Resultset zurückgibt.
Öffentliche MethodeForceDisconnectedErzwingt, dass die SQL Server-Instanz getrennt wird. (Geerbt von ConnectionManager.)
Öffentliche MethodeGetHashCode (Geerbt von Object.)
Öffentliche MethodeGetType (Geerbt von Object.)
Öffentliche MethodeIsInFixedServerRoleTestet, ob der Anmeldename, der der Verbindung zugeordnet ist, auf die verwiesen wird, Mitglied der angegebenen festen Serverrolle ist.
Öffentliche MethodeStatisches ElementNormalizeQuery(String)Verwendet eine Zeichenfolgeneingabe, die den Abfragetext darstellt.
Öffentliche MethodeStatisches ElementNormalizeQuery(String, Boolean)Normalisiert die Abfrage, durch die die Serververbindung gesteuert wird.
Öffentliche MethodeRollBackTransactionFührt ein Rollback für die aktuelle Transaktion aus.
Öffentliche MethodeToStringGibt den Objektnamen, auf den verwiesen wird, als Zeichenfolge zurück. (Geerbt von ConnectionSettings.)
Nach oben

  NameBeschreibung
Öffentliches EreignisInfoMessageDas Ereignis, das auftritt, wenn die SQL Server-Instanz eine Informationsmeldung generiert.  (Geerbt von ConnectionManager.)
Öffentliches EreignisRemoteLoginFailedDieses Ereignis tritt auf, wenn bei einer Remoteanmeldung keine Verbindung mit der SQL Server-Instanz hergestellt werden kann. (Geerbt von ConnectionManager.)
Öffentliches EreignisServerMessageDas Ereignis, das auftritt, wenn SQL Server eine Warnung oder Informationsmeldung über die aktuelle Verbindung zurückgibt. (Geerbt von ConnectionManager.)
Öffentliches EreignisStateChangeDas Ereignis, das auftritt, wenn sich der Status der SQL Server-Instanz ändert.  (Geerbt von ConnectionManager.)
Öffentliches EreignisStatementExecutedDas Ereignis, das auftritt, wenn die SQL Server-Instanz eine Anweisung über die aktuelle Verbindung ausführt.  (Geerbt von ConnectionManager.)
Nach oben

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeISfcConnection.ConnectGibt einen Wert zurück, der angibt, dass der Server eine SFC-Verbindung herstellen soll.
Explizite SchnittstellenimplementierungPrivate MethodeISfcConnection.CopyVerwendet die SFC-Verbindung, um die Serververbindung zu kopieren.
Explizite SchnittstellenimplementierungPrivate MethodeISfcConnection.DisconnectTrennt die Verbindung.
Explizite SchnittstellenimplementierungPrivate EigenschaftISfcConnection.ServerVersionRuft die Version des Servers ab.
Explizite SchnittstellenimplementierungPrivate MethodeISfcConnection.ToEnumeratorObjectRendert ein Enumeratorobjekt für die Serververbindung.
Nach oben

Die ServerConnection-Klasse wird von der Server -Replikationsklassen Klassen- und wie die ReplicationServer-Klasse behandelt.

In der Regel müssen Sie eine Instanz des ServerConnection-Objekts nicht deklarieren, da automatisch mit dem Serverobjekt erstellt wird. Deklarieren Sie eine ServerConnection-Objektvariable, wenn Sie die Verbindungseinstellungen für die Wiederverwendung speichern möchten. Die ConnectionContext-Eigenschaft der Serverobjektpunkte zu einem ServerConnections-Objekt. Das ServerConnection-Objekt enthält Eigenschaften, die für die Verbindung zwischen dem Serverobjekt und der Instanz von SQL Server herstellen. Sie können es verwenden, um bestimmte Aspekte der Verbindung, wie die Prozess-ID anzuzeigen oder zu ändern und Transaktionen, den Authentifizierungsmodus, Ausführungsmodus verarbeiten, und Transact-SQL, Befehle auch direkt auszuführen.

Mit dem ServerConnection-Objekt verwenden, können Sie folgende Aufgaben ausführen:

  • Führen Sie Transact-SQL-Anweisungen direkt über die Verbindung zur Instanz von SQL Server aus.

  • Ändern Sie die Verbindungseinstellungen, wie die Authentifizierungsmethode.

  • Starten Sie, führen Sie einen Commit oder Rollback von Transaktionen aus.

  • Zeichnen Sie die Transact-SQL-Anweisungen auf, die von der SMO-Anwendung generiert werden.

Ein weiteres Beispiel dieser Methode mit dem Database-Objekt finden Sie unter [M:Microsoft.SqlServer.Management.Smo.Database.ExecuteNonQuery(System.String].

VB

'Declare a ServerConnection object variable to specify SQL authentication, login and password.
Dim conn As New ServerConnection
conn.LoginSecure = False
conn.Login = vlogin
conn.Password = vpassword
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server(conn)
'The actual connection is made when a property is retrieved.
Console.WriteLine(srv.Information.Version)
'The connection is automatically disconnected when the Server variable goes out of scope.

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.LoginSecure = $FALSE
$conn.Login = vlogin
$conn.Password = vpassword
#Connect to the local, default instance of SQL Server
$srv = new-object Microsoft.SqlServer.Management.Smo.Server($conn)
Write-Host $srv.Information.Version

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft