Klasa ServerConnection

ServerConnection Obiekt reprezentuje połączenie z serwerem.

Hierarchia dziedziczenia

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

Przestrzeń nazw:  Microsoft.SqlServer.Management.Common
Zestaw:  Microsoft.SqlServer.ConnectionInfo (w Microsoft.SqlServer.ConnectionInfo.dll)

Składnia

'Deklaracja
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'Użycie
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

Typ ServerConnection uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	ServerConnection()	Inicjuje nowe wystąpienie ServerConnection klasy
	ServerConnection(SqlConnection)	Inicjuje nowe wystąpienie ServerConnection klasy z parametry określonego połączenia.
	ServerConnection(String)	Inicjuje nowe wystąpienie ServerConnection klasy z wystąpienia określonego serwera.
	ServerConnection(SqlConnectionInfo)	Inicjuje nowe wystąpienie ServerConnection klasy z informacji określonego połączenia.
	ServerConnection(String, String, SecureString)	Inicjuje nowe wystąpienie ServerConnection klasy z wystąpienia określonego serwera i poświadczenia logowania.
	ServerConnection(String, String, String)	Inicjuje nowe wystąpienie ServerConnection klasy z wystąpienia określonego serwera i poświadczenia logowania.

Do góry

Właściwości

	Nazwa	Opis
	ApplicationName	Pobiera lub ustawia nazwę aplikacji, która ustanowieniu połączenia z serwerem. (Dziedziczony z ConnectionSettings).
	AutoDisconnectMode	Pobiera lub ustawia tryb Automatyczne rozłączenie połączenia odwołania do wystąpienie SQL Server. (Dziedziczony z ConnectionManager).
	BatchSeparator	Pobiera lub ustawia wartość ciąg używany do oddzielania partii w związku z odwołania.
	CapturedSql	Pobiera Transact-SQL przechwytywania instrukcje, które są przechwytywane, gdy połączenie jest uruchomiony w trybie. (Dziedziczony z ConnectionManager).
	ConnectAsUser	Pobiera lub ustawia Boolean wartości właściwość, który określa, czy połączenie jest nawiązywane przy użyciu personifikacji. (Dziedziczony z ConnectionSettings).
	ConnectAsUserName	Pobiera lub ustawia nazwę użytkownika podczas łączenia przy użyciu personifikacji. (Dziedziczony z ConnectionSettings).
	ConnectAsUserPassword	Pobiera lub ustawia hasło dla użytkownika podczas łączenia przy użyciu personifikacji. (Dziedziczony z ConnectionSettings).
	ConnectionString	Pobiera lub ustawia połączenie ciąg używany do ustanawiania połączenia z określonym źródłem danych. (Dziedziczony z ConnectionSettings).
	ConnectionType	Pobiera typ połączenia do korzystania z serwera.
	ConnectTimeout	Pobiera lub ustawia połączenie czas-okresu w sekundach. (Dziedziczony z ConnectionSettings).
	DatabaseEngineType	Pobiera typ aparat bazy danych. (Dziedziczony z ConnectionManager).
	DatabaseName	Pobiera lub ustawia bazy danych wymaganych przez połączenie. (Dziedziczony z ConnectionSettings).
	EncryptConnection	Pobiera lub ustawia Boolean wartości właściwość, która określa, czy połączenie jest szyfrowany. (Dziedziczony z ConnectionSettings).
	FixedServerRoles	Pobiera stała rola serwera związanych z połączeniem odwołanie.
	InUse	Pobiera lub ustawia Boolean wartości właściwość, która określa, czy połączenie jest używane. (Dziedziczony z ConnectionManager).
	IsForceDisconnected	Pobiera Boolean wartość określająca, czy połączenie zostało rozłączone przymusowo. (Dziedziczony z ConnectionManager).
	IsOpen	Pobiera Boolean wartości właściwość, który określa, czy połączenie jest aktualnie otwarty. (Dziedziczony z ConnectionManager).
	LockTimeout	Pobiera lub ustawia czas w sekundach, wymagane dla limitu czasu połączenia, gdy bieżąca transakcja jest zablokowana. (Dziedziczony z ConnectionManager).
	Login	Pobiera lub ustawia logowania wymagane do nawiązania połączenia z wystąpienie serwera. (Dziedziczony z ConnectionSettings).
	LoginSecure	Pobiera lub ustawia Boolean właściwość, która określa, czy ustanawiane jest połączenie z serwerem przy użyciu uwierzytelniania systemu Windows lub SQL Server uwierzytelniania. (Dziedziczony z ConnectionSettings).
	MaxPoolSize	Pobiera lub ustawia maksymalną liczbę połączeń w puli połączeń, która akceptuje określonego połączenia, podczas ustanawiania połączenia z serwerem. (Dziedziczony z ConnectionSettings).
	MinPoolSize	Pobiera lub Ustawia minimalną liczbę połączeń w puli połączeń, która akceptuje określonego połączenia, podczas ustanawiania połączenia z serwerem. (Dziedziczony z ConnectionSettings).
	MultipleActiveResultSets	Pobiera lub ustawia Boolean wartości właściwość, która określa, czy jest dozwolone więcej niż jeden zestaw wyników active. (Dziedziczony z ConnectionSettings).
	NetworkProtocol	Pobiera lub ustawia protokół sieciowy używany do ustanawiania połączenia z serwerem. (Dziedziczony z ConnectionSettings).
	NonPooledConnection	Pobiera lub ustawia Boolean Określa, czy połączenie może być puli lub nieobsługiwanych przez wartość właściwość. (Dziedziczony z ConnectionSettings).
	PacketSize	Pobiera lub ustawia pakiety danych przesyłanych między klient i serwera w sieci, w bajtach. (Dziedziczony z ConnectionSettings).
	ParameterizationMode	Pobiera lub ustawia tryb parametryzacja dla połączenia z serwerem.
	Password	Pobiera lub ustawia hasło używane z logowanie do nawiązania połączenia z serwerem podczas SQL Server jest używane uwierzytelnianie. (Dziedziczony z ConnectionSettings).
	PooledConnectionLifetime	Pobiera lub ustawia okres istnienia puli połączeń. (Dziedziczony z ConnectionSettings).
	ProcessID	Pobiera wartość Identyfikatora, który unikatowo identyfikuje proces skojarzony z wskazane połączenie z serwerem.
	ResetConnectionString	Pobiera lub ustawia Boolean wartość określająca, czy węzeł w połączeniu z ciąg została zmieniona. (Dziedziczony z ConnectionSettings).
	SecureConnectionString	Pobiera lub ustawia zaszyfrowana wersja połączenia ciąg. (Dziedziczony z ConnectionSettings).
	SecurePassword	Pobiera lub ustawia bezpieczne hasło używane z logowanie do nawiązania połączenia z serwerem podczas SQL Server jest używane uwierzytelnianie. (Dziedziczony z ConnectionSettings).
	ServerInstance	Pobiera lub ustawia nazwę serwera. (Dziedziczony z ConnectionSettings).
	ServerVersion	Pobiera wersja połączonych wystąpienie z SQL Server. (Dziedziczony z ConnectionManager).
	SqlConnectionObject	Pobiera obiekt połączenia. (Dziedziczony z ConnectionManager).
	SqlExecutionModes	Pobiera lub ustawia tryb wykonywania skojarzonych z tym połączeniem odwołanie do serwera.
	StatementTimeout	Pobiera lub ustawia liczbę sekund, oświadczenie do uruchomienia przed z czas-brak błędu.
	TransactionDepth	Pobiera bieżący głębokość transakcji odwołanie połączenia.
	TrueLogin	Pobiera bieżący rekord nazwy logowania używane przez połączenie odwołania.
	TrueName	Pobiera nazwę serwera.
	UseMode	Pobiera lub ustawia połączenie z serwerem przy użyciu określonego trybu.
	UserProfile	Pobiera profilu użytkownika, skojarzone z połączeniem odwołanie.
	WorkstationId	Pobiera lub ustawia wartość Identyfikatora, który unikatowo identyfikuje stacja robocza. (Dziedziczony z ConnectionSettings).

Do góry

Metody

	Nazwa	Opis
	BeginTransaction	Rozpoczyna transakcję odwołanie połączenia.
	Cancel	Przerywa połączenie.
	ChangePassword(SecureString)	Zmienia hasło logowania używany standard uwierzytelnianie.
	ChangePassword(String)	Zmienia hasło logowania używany standard uwierzytelnianie.
	CheckServerVersion	Sprawdza wersja miejsce docelowe wystąpienie z SQL Server. (Dziedziczony z ConnectionManager).
	CommitTransaction	Zatwierdza połączenia odwołania bieżącej transakcji.
	Connect	Łączy do wystąpienie SQL Server. (Dziedziczony z ConnectionManager).
	Copy	Zwraca kopię ServerConnection obiektu.
	Disconnect	Odłącza od wystąpienie SQL Server. (Dziedziczony z ConnectionManager).
	Equals	(Dziedziczony z Object).
	ExecuteNonQuery(StringCollection)	Wykonuje partia sprawozdań, które nie zwraca zestaw wyników.
	ExecuteNonQuery(String)	Wykonuje instrukcja nie zwraca zestaw wyników.
	ExecuteNonQuery(StringCollection, ExecutionTypes)	Wykonuje partia sprawozdania z opcjami wykonanie określonego nie zwraca zestaw wyników.
	ExecuteNonQuery(String, ExecutionTypes)	Wykonuje instrukcja wykonanie określonej opcji, która nie zwraca zestaw wyników.
	ExecuteReader(String)	Wykonuje Transact-SQL instrukcji, które zwraca jeden lub wiele wyników zestawów.
	ExecuteReader(String, SqlCommand%)	Wykonuje się przy użyciu czytnika SqlDataReader wartość obiektu zawierającego jeden lub więcej wyników zestawów.
	ExecuteScalar(StringCollection)	Wykonuje partia Transact-SQL sprawozdań i zwraca pierwszej kolumna pierwszego wiersza jako wartość obiektu.
	ExecuteScalar(String)	Wykonuje Transact-SQL instrukcja i zwraca pierwszej kolumna pierwszego wiersza jako wartość obiektu.
	ExecuteTSql	Wykonuje Transact-SQL polecenia. (Dziedziczony z ConnectionManager).
	ExecuteWithResults(StringCollection)	Wykonuje partia Transact-SQL instrukcji, które zwracają wiele zestawów wyników.
	ExecuteWithResults(String)	Wykonuje Transact-SQL instrukcja, która zwraca zestaw wyników.
	Finalize	(Dziedziczony z Object).
	ForceDisconnected	Wymusza rozłączenia z wystąpienie SQL Server. (Dziedziczony z ConnectionManager).
	GetHashCode	(Dziedziczony z Object).
	GetType	(Dziedziczony z Object).
	IsInFixedServerRole	Sprawdza, czy logowanie skojarzonych z tym połączeniem odwołanie jest element członkowski roli serwera określonego środka.
	MemberwiseClone	(Dziedziczony z Object).
	NormalizeQuery(String)	Używa wprowadzania ciąg, który reprezentuje tekst kwerendy.
	NormalizeQuery(String, Boolean)	Normalizuje kwerendę, która kontroluje połączenie z serwerem.
	RollBackTransaction	Wycofuje bieżącej transakcji.
	ThrowIfPropertyNotSet(String, String)	Zgłasza wyjątek, jeśli właściwość określonego połączenia jest null lub pusty. (Dziedziczony z ConnectionSettings).
	ThrowIfPropertyNotSet(String, String, Boolean)	Jeśli właściwość określonego połączenia jest null lub null opcjonalnie, zgłasza wyjątek. (Dziedziczony z ConnectionSettings).
	ToString	Zwraca nazwę obiektu odwołanie jako ciąg. (Dziedziczony z ConnectionSettings).

Do góry

Zdarzenia

	Nazwa	Opis
	InfoMessage	zdarzenie występującego podczas wystąpienie SQL Server generuje komunikat informacyjny. (Dziedziczony z ConnectionManager).
	RemoteLoginFailed	To zdarzenie występuje podczas logowania zdalnego nie może połączyć się z wystąpienie SQL Server. (Dziedziczony z ConnectionManager).
	ServerMessage	zdarzenie występującego podczas SQL Server zwraca komunikat ostrzeżenie lub informację na bieżącego połączenia. (Dziedziczony z ConnectionManager).
	StateChange	zdarzenie występującego podczas wystąpienie SQL Server zmiany stanu. (Dziedziczony z ConnectionManager).
	StatementExecuted	zdarzenie występującego podczas wystąpienie SQL Server wykonuje instrukcja na bieżące połączenie. (Dziedziczony z ConnectionManager).

Do góry

Jawne implementacje interfejsu

	Nazwa	Opis
	ISfcConnection.Connect	Zwraca wartość, która wskazuje serwer połączyć się przy użyciu połączenia SFC.
	ISfcConnection.Copy	Używa połączenia SFC, aby skopiować połączenie z serwerem.
	ISfcConnection.Disconnect	Rozłącza połączenie.
	ISfcConnection.ServerVersion	Pobiera wersja serwera.
	ISfcConnection.ToEnumeratorObject	Renderuje obiekt enumerator dla połączenia z serwerem.

Do góry

Uwagi

ServerConnection Klasy jest obsługiwana przez Server Klasa i klasy replikacja, takich jak ReplicationServer klasy

Zazwyczaj nie trzeba zadeklarować wystąpienie ServerConnection obiektu, ponieważ jest tworzone automatycznie z obiektu serwera.Zadeklarować ServerConnection zmienna obiektu, jeśli chcesz przechowywać ustawienia połączenia dla ponownego wykorzystywania.ConnectionContext Właściwość punkty obiektu serwera do obiektu ServerConnection.ServerConnection Obiekt zawiera właściwości, które odnoszą się do połączenia między obiektu serwera i wystąpienie SQL Server.Można go użyć do wyświetlania lub modyfikowania niektórych aspektów połączenia, takie jak identyfikator procesu przetwarzania transakcji, tryb uwierzytelnianie, trybu wykonywania, a nawet uruchomić Transact-SQL polecenia bezpośrednio.

Za pomocą ServerConnection obiektu, można wykonać następujące czynności:

• Uruchom Transact-SQL instrukcji bezpośrednio przez połączenie z wystąpienie SQL Server.

• Zmienić ustawienia połączenia, takie jak metoda uwierzytelnianie.

• Rozpocząć, zatwierdzić i wycofać transakcji.

• Przechwytywanie Transact-SQL instrukcji generowanych przez aplikację SMO.

Przykłady

Innym przykładem tej metoda z Database obiektów, zobacz [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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Management.Common

Inne zasoby

Nawiązywanie połączenia z wystąpieniem programu SQL Server

Nawiązywanie połączenia z wystąpieniem programu SQL Server