ServerConnection-Klasse

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

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 NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'Usage
Dim instance As ServerConnection

public sealed class ServerConnection : ConnectionManager, 
    ISfcConnection

public ref class ServerConnection sealed : public ConnectionManager, 
    ISfcConnection

[<SealedAttribute>]
type ServerConnection =  
    class 
        inherit ConnectionManager 
        interface ISfcConnection 
    end

public final class ServerConnection extends ConnectionManager implements ISfcConnection

Der ServerConnection-Typ macht folgende Elemente verfügbar.

Konstruktoren

	Name	Beschreibung
	ServerConnection()	Initialisiert eine neue Instanz der ServerConnection-Klasse.
	ServerConnection(SqlConnection)	Initialisiert eine neue Instanz der ServerConnection-Klasse mit den angegebenen Verbindungsparametern.
	ServerConnection(String)	Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz.
	ServerConnection(SqlConnectionInfo)	Initialisiert eine neue Instanz der ServerConnection-Klasse mit den angegebenen Verbindungsinformationen.
	ServerConnection(String, String, SecureString)	Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz und den angegebenen Anmeldeinformationen.
	ServerConnection(String, String, String)	Initialisiert eine neue Instanz der ServerConnection-Klasse mit der angegebenen Serverinstanz und den angegebenen Anmeldeinformationen.

Nach oben

Eigenschaften

	Name	Beschreibung
	ApplicationName	Ruft den Namen der Anwendung ab, die die Verbindung mit dem Server hergestellt hat, oder legt ihn fest. (Geerbt von ConnectionSettings.)
	AutoDisconnectMode	Ruft den Modus zum automatischen Trennen der Verbindung, auf die verwiesen wird, von der SQL Server-Instanz ab oder legt ihn fest. (Geerbt von ConnectionManager.)
	BatchSeparator	Ruft den Zeichenfolgenwert ab, mit dem Batches in der Verbindung, auf die verwiesen wird, getrennt werden, oder legt ihn fest.
	CapturedSql	Ruft die Transact-SQL-Anweisungen ab, die aufgezeichnet werden, wenn die Verbindung im Aufzeichnungsmodus ausgeführt wird. (Geerbt von ConnectionManager.)
	ConnectAsUser	Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung mit Identitätswechsel hergestellt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
	ConnectAsUserName	Ruft beim Herstellen einer Verbindung mit Identitätswechsel den Namen des Benutzers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
	ConnectAsUserPassword	Ruft beim Herstellen einer Verbindung mit Identitätswechsel das Kennwort für den Benutzer ab oder legt es fest. (Geerbt von ConnectionSettings.)
	ConnectionString	Ruft die zum Herstellen einer Verbindung mit einer angegebenen Datenquelle verwendete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
	ConnectionType	Ruft den Typ der für den Server zu verwendenden Verbindung ab.
	ConnectTimeout	Ruft den Timeoutzeitraum für die Verbindung in Sekunden ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
	DatabaseEngineType	Ruft den Typ des Datenbankmoduls ab. (Geerbt von ConnectionManager.)
	DatabaseName	Ruft die für die Verbindung erforderliche Datenbank ab oder legt diese fest. (Geerbt von ConnectionSettings.)
	EncryptConnection	Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verschlüsselt wird, oder legt ihn fest. (Geerbt von ConnectionSettings.)
	FixedServerRoles	Ruft die der Verbindung, auf die verwiesen wird, zugeordnete feste Serverrolle ab.
	InUse	Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung verwendet wird, oder legt ihn fest. (Geerbt von ConnectionManager.)
	IsForceDisconnected	Ruft einen Boolean-Wert ab, der angibt, ob die Trennung der Verbindung erzwungen wurde. (Geerbt von ConnectionManager.)
	IsOpen	Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Verbindung derzeit geöffnet ist. (Geerbt von ConnectionManager.)
	LockTimeout	Ruft die Zeit bis zum Verbindungstimeout in Sekunden ab, wenn die aktuelle Transaktion gesperrt ist, oder legt sie fest. (Geerbt von ConnectionManager.)
	Login	Ruft den Anmeldenamen ab, der zum Herstellen einer Verbindung mit der Serverinstanz erforderlich ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
	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.)
	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.)
	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.)
	MultipleActiveResultSets	Ruft den Boolean-Eigenschaftswert ab, der angibt, ob mehr als ein aktives Resultset zulässig ist, oder legt ihn fest. (Geerbt von ConnectionSettings.)
	NetworkProtocol	Ruft das Netzwerkprotokoll ab, das zum Herstellen der Verbindung mit dem Server verwendet wird, oder legt es fest. (Geerbt von ConnectionSettings.)
	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.)
	PacketSize	Ruft die zwischen Client und Server über das Netzwerk gesendeten Datenpakete in Bytes ab oder legt sie fest. (Geerbt von ConnectionSettings.)
	ParameterizationMode	Ruft den Parametrisierungsmodus für die Serververbindung ab oder legt ihn fest.
	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.)
	PooledConnectionLifetime	Ruft die Lebensdauer der in einem Pool enthaltenen Verbindung ab oder legt sie fest. (Geerbt von ConnectionSettings.)
	ProcessID	Ruft den ID-Wert ab, durch den der Prozess eindeutig identifiziert wird, der der Serververbindung zugeordnet ist, auf die verwiesen wird.
	SecureConnectionString	Ruft eine verschlüsselte Version der Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von ConnectionSettings.)
	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.)
	ServerInstance	Ruft den Namen des Servers ab oder legt ihn fest. (Geerbt von ConnectionSettings.)
	ServerVersion	Ruft die Version der verbundenen SQL Server-Instanz ab. (Geerbt von ConnectionManager.)
	SqlConnectionObject	Ruft das Verbindungsobjekt ab. (Geerbt von ConnectionManager.)
	SqlExecutionModes	Ruft den der Serververbindung, auf die verwiesen wird, zugeordneten Ausführungsmodus ab oder legt ihn fest.
	StatementTimeout	Ruft die Ausführungsdauer für eine Anweisung in Sekunden ab, bis die Anweisung mit einem Timeoutfehler fehlschlägt, oder legt sie fest.
	TransactionDepth	Ruft die aktuelle Transaktionstiefe für die Verbindung ab, auf die verwiesen wird.
	TrueLogin	Ruft den aktuellen Namen des Anmeldedatensatzes ab, der von der Verbindung verwendet wird, auf die verwiesen wird.
	TrueName	Ruft den Namen des Servers ab.
	UseMode	Ruft die Serververbindung mithilfe eines angegebenen Modus ab oder legt sie fest.
	UserProfile	Ruft das der Verbindung, auf die verwiesen wird, zugeordnete Benutzerprofil ab.
	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
	BeginTransaction	Startet eine Transaktion über die Verbindung, auf die verwiesen wird.
	Cancel	Bricht die Verbindung ab.
	ChangePassword(SecureString)	Ändert das Anmeldekennwort, das mit Standardauthentifizierung verwendet wird.
	ChangePassword(String)	Ändert das Anmeldekennwort, das mit Standardauthentifizierung verwendet wird.
	CommitTransaction	Führt einen Commit für die aktuelle Transaktion über die Verbindung aus, auf die verwiesen wird.
	Connect	Stellt eine Verbindung mit der SQL Server-Instanz her. (Geerbt von ConnectionManager.)
	Copy	Gibt eine Kopie des ServerConnection-Objekts zurück.
	Disconnect	Trennt die Verbindung mit der SQL Server-Instanz. (Geerbt von ConnectionManager.)
	Equals	(Geerbt von Object.)
	ExecuteNonQuery(StringCollection)	Führt einen Batch von Anweisungen aus, die kein Resultset zurückgeben.
	ExecuteNonQuery(String)	Führt eine Anweisung aus, die kein Resultset zurückgibt.
	ExecuteNonQuery(StringCollection, ExecutionTypes)	Führt einen Batch von Anweisungen, die kein Resultset zurückgeben, mit den angegebenen Ausführungsoptionen aus.
	ExecuteNonQuery(String, ExecutionTypes)	Führt eine Anweisung, die kein Resultset zurückgibt, mit den angegebenen Ausführungsoptionen aus.
	ExecuteReader(String)	Führt Transact-SQL-Anweisungen aus, die mindestens ein Resultset zurückgeben.
	ExecuteReader(String, SqlCommand%)	Führt einen Leser mithilfe eines SqlDataReader-Objektwerts aus, der mindestens ein Resultset enthält.
	ExecuteScalar(StringCollection)	Führt einen Batch von Transact-SQL-Anweisungen aus und gibt die erste Spalte der ersten Zeile als Objektwert zurück.
	ExecuteScalar(String)	Führt eine Transact-SQL-Anweisung aus und gibt die erste Spalte der ersten Zeile als Objektwert zurück.
	ExecuteWithResults(StringCollection)	Führt einen Batch von Transact-SQL-Anweisungen aus, die mehrere Resultsets zurückgeben.
	ExecuteWithResults(String)	Führt eine Transact-SQL-Anweisung aus, die ein Resultset zurückgibt.
	ForceDisconnected	Erzwingt, dass die SQL Server-Instanz getrennt wird. (Geerbt von ConnectionManager.)
	GetHashCode	(Geerbt von Object.)
	GetType	(Geerbt von Object.)
	IsInFixedServerRole	Testet, ob der Anmeldename, der der Verbindung zugeordnet ist, auf die verwiesen wird, Mitglied der angegebenen festen Serverrolle ist.
	NormalizeQuery(String)	Verwendet eine Zeichenfolgeneingabe, die den Abfragetext darstellt.
	NormalizeQuery(String, Boolean)	Normalisiert die Abfrage, durch die die Serververbindung gesteuert wird.
	RollBackTransaction	Führt ein Rollback für die aktuelle Transaktion aus.
	ToString	Gibt den Objektnamen, auf den verwiesen wird, als Zeichenfolge zurück. (Geerbt von ConnectionSettings.)

Nach oben

Ereignisse

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

Nach oben

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	ISfcConnection.Connect	Gibt einen Wert zurück, der angibt, dass der Server eine SFC-Verbindung herstellen soll.
	ISfcConnection.Copy	Verwendet die SFC-Verbindung, um die Serververbindung zu kopieren.
	ISfcConnection.Disconnect	Trennt die Verbindung.
	ISfcConnection.ServerVersion	Ruft die Version des Servers ab.
	ISfcConnection.ToEnumeratorObject	Rendert ein Enumeratorobjekt für die Serververbindung.

Nach oben

Hinweise

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.

Beispiele

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

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

Andere Ressourcen

Herstellen einer Verbindung zu einer Instanz von SQL Server

Herstellen einer Verbindung zu einer Instanz von SQL Server