Makale
07/26/2011

ServerConnection Sınıfı

ServerConnection Nesnesini temsil eden bir bağlantı sunucu.

Devralma Hiyerarşisi

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

Ad Alanı: Microsoft.SqlServer.Management.Common
Derleme: Microsoft.SqlServer.ConnectionInfo (Microsoft.SqlServer.ConnectionInfo içinde.dll)

Sözdizimi

'Bildirim
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'Kullanım
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

ServerConnection türü aşağıdaki üyeleri açıklar.

Oluşturucular

	Ad	Açıklama
	ServerConnection()	Yeni bir başlatır örnek , ServerConnection WalkTree
	ServerConnection(SqlConnection)	Yeni bir başlatır örnek , ServerConnection sınıfı ile belirtilen bağlantı parametreleri.
	ServerConnection(String)	Yeni bir örneğini başlatır ServerConnection sınıfı ile belirtilen sunucu örnek.
	ServerConnection(SqlConnectionInfo)	Yeni bir başlatır örnek , ServerConnection sınıfı ile belirtilen bağlantı bilgileri.
	ServerConnection(String, String, SecureString)	Yeni bir örneğini başlatır ServerConnection sınıfı için belirtilen sunucu örnek ve oturum açma kimlik bilgileri.
	ServerConnection(String, String, String)	Yeni bir örneğini başlatır ServerConnection sınıfı için belirtilen sunucu örnek ve oturum açma kimlik bilgileri.

Üst

Özellikler

	Ad	Açıklama
	ApplicationName	Alır veya sunucu ile bağlantı kurulmuş uygulamanın adını ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	AutoDisconnectMode	Alır veya ayarlar için bulunulan bağlantının otomatik bağlantı kesme modu örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	BatchSeparator	Alır veya ayarlar toplu olarak bulunulan bağlantısını ayırmak için kullanılan dize değeri.
	CapturedSql	Alır Transact-SQL olduğunda bağlantının çalışır yakalanmış ifadeleri yakalama modu. (ConnectionManager öğesinden devralınmıştır.)
	ConnectAsUser	Alır veya ayarlar Boolean özellik değerini belirtir olup olmadığını bağlantı kurulur kullanarak kimliğe bürünme. (ConnectionSettings öğesinden devralınmıştır.)
	ConnectAsUserName	Alır veya kimliğe bürünme kullanılarak bağlanırken kullanıcı adını ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	ConnectAsUserPassword	Alır veya kimliğe bürünme kullanılarak bağlanırken kullanıcı için parola ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	ConnectionString	Alır veya ayarlar bağlantı dize belirtilen veri kaynak ile bağlantı kurmak için kullanılır. (ConnectionSettings öğesinden devralınmıştır.)
	ConnectionType	Sunucuda bağlantı türünü alır.
	ConnectTimeout	Alır veya bağlantı saat aşımı süresini saniye cinsinden ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	DatabaseEngineType	Veritabanı Altyapısı türü alır. (ConnectionManager öğesinden devralınmıştır.)
	DatabaseName	Alır veya veritabanı ile bağlantı gerekli ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	EncryptConnection	Alır veya ayarlar Boolean bağlantı şifreli olup olmadığını belirleyen bir özellik değeri. (ConnectionSettings öğesinden devralınmıştır.)
	FixedServerRoles	Başvurulan bağlantıyla ilişkili sabit sunucu rolü alır.
	InUse	Alır veya ayarlar Boolean bağlantı kullanılmakta olup olmadığını belirleyen bir özellik değeri. (ConnectionManager öğesinden devralınmıştır.)
	IsForceDisconnected	Alır bir Boolean bağlantı zorla kesildi olup olmadığını belirten değer. (ConnectionManager öğesinden devralınmıştır.)
	IsOpen	Alır Boolean özellik değeri belirleyen bir bağlantısı olup şu anda açık. (ConnectionManager öğesinden devralınmıştır.)
	LockTimeout	Alır veya bağlantı saat aşımı için geçerli işlem kilitlendiğinde gereken saniye cinsinden süreyi ayarlar. (ConnectionManager öğesinden devralınmıştır.)
	Login	Alır veya server örnek ile bağlantı kurmak için gerekli oturum açma ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	LoginSecure	Alır veya ayarlar Boolean Windows kimlik doğrulaması kullanarak bağlantı sunucuya kurulmuş olup olmadığını belirleyen özellik veya SQL Server kimlik doğrulaması. (ConnectionSettings öğesinden devralınmıştır.)
	MaxPoolSize	Alır veya belirtilen bağlantı sunucusu ile bağlantı kurarken kabul eden bir bağlantı havuzunda en fazla bağlantı sayısını ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	MinPoolSize	Alır veya belirtilen bağlantı sunucusu ile bağlantı kurarken kabul eden bir bağlantı havuzunda en düşük bağlantı sayısını ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	MultipleActiveResultSets	Alır veya küme Boolean belirten özellik değeri olup birden fazla etkin sonuç küme izin. (ConnectionSettings öğesinden devralınmıştır.)
	NetworkProtocol	Alır veya ayarlar sunucu bağlantı için kullanılan ağ protokol. (ConnectionSettings öğesinden devralınmıştır.)
	NonPooledConnection	Alır veya ayarlar Boolean bağlantı havuza veya alınmamış belirten özellik değeri. (ConnectionSettings öğesinden devralınmıştır.)
	PacketSize	Alır veya ayarlar veri bayt ağ üzerinden istemci ve sunucu arasında gönderilen paketler. (ConnectionSettings öğesinden devralınmıştır.)
	ParameterizationMode	Alır veya sunucu bağlantısı için parameterizasyonunu modunu ayarlar.
	Password	Alır veya ayarlar parola ile oturum açma sunucusu ile bağlantı kurmak için kullanılan, SQL Server kimlik doğrulamasının kullanıldığını. (ConnectionSettings öğesinden devralınmıştır.)
	PooledConnectionLifetime	Alır veya ayarlar havuza bağlantı süresi. (ConnectionSettings öğesinden devralınmıştır.)
	ProcessID	Başvurulan sunucu bağlantısı ile ilişkili işlemi benzersiz olarak tanımlayan kimlik değeri alır.
	ResetConnectionString	Alır veya ayarlar bir Boolean belirten değeri bağlantı bir düğüm olup dize değiştirildi. (ConnectionSettings öğesinden devralınmıştır.)
	SecureConnectionString	Alır veya ayarlar bağlantı şifreli sürüm dize. (ConnectionSettings öğesinden devralınmıştır.)
	SecurePassword	Alır veya ayarlar güvenli parola ile oturum açma sunucusu ile bağlantı kurmak için kullanılan, SQL Server kimlik doğrulamasının kullanıldığını. (ConnectionSettings öğesinden devralınmıştır.)
	ServerInstance	Alır veya sunucu adını ayarlar. (ConnectionSettings öğesinden devralınmıştır.)
	ServerVersion	Bağlı örnek sürüm alır SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	SqlConnectionObject	Bağlantı nesnesi alır. (ConnectionManager öğesinden devralınmıştır.)
	SqlExecutionModes	Alır veya başvurulan sunucu bağlantısı ile ilişkili yürütme moduna ayarlar.
	StatementTimeout	Alır veya bir deyim önce saat aşımı hatası ile başarısız olan çalıştırmak için verilen saniye sayısını ayarlar.
	TransactionDepth	Geçerli hareketin derinliğini başvurulan bağlantı için alır.
	TrueLogin	Başvurulan bağlantısı tarafından kullanılan geçerli oturum açma kaydı adını alır.
	TrueName	Sunucu adını alır.
	UseMode	Alır veya ayarlar Belirtilen mod kullanarak sunucu bağlantısı.
	UserProfile	Başvurulan bağlantıyla ilişkili kullanıcı profilini alır.
	WorkstationId	Alır veya iş istasyonu olarak tanıtan kimlik değeri ayarlar. (ConnectionSettings öğesinden devralınmıştır.)

Üst

Yöntemler

	Ad	Açıklama
	BeginTransaction	Başvurulan bağlantısı üzerinde bir hareket başlatır.
	Cancel	Bağlantısını iptal eder.
	ChangePassword(SecureString)	Standart kimlik doğrulaması ile kullanılan oturum açma parolasını değiştirir.
	ChangePassword(String)	Standart kimlik doğrulaması ile kullanılan oturum açma parolasını değiştirir.
	CheckServerVersion	Hedef sürüm denetler örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	CommitTransaction	Başvurulan bağlantı geçerli hareketi tamamlar.
	Connect	Bağlar örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	Copy	Bir kopyasını verir ServerConnection nesne.
	Disconnect	Bağlantıları keser örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	Equals	(Object öğesinden devralınmıştır.)
	ExecuteNonQuery(StringCollection)	Bir sonuç küme döndüren ifadeler toplu iş iş yürütür.
	ExecuteNonQuery(String)	Bir sonuç küme döndüren bir deyim yürütür.
	ExecuteNonQuery(StringCollection, ExecutionTypes)	Bir sonuç küme döndüren ifadeler belirtilen yürütme seçenekleri ile toplu iş iş yürütür.
	ExecuteNonQuery(String, ExecutionTypes)	Bir sonuç küme döndüren bir deyim belirtilen yürütme seçenekleri ile yürütür.
	ExecuteReader(String)	Yürütür Transact-SQL ifadeleri, dönmek bir veya birden çok sonuç kümeleri.
	ExecuteReader(String, SqlCommand%)	Bir okuyucu kullanarak yürüten bir SqlDataReader Nesne değeri içeren bir veya birden çok sonuç kümeleri.
	ExecuteScalar(StringCollection)	toplu iş iş yürütür Transact-SQL ifadeleri ve ilk döner sütun ilk satırın farklı bir nesne değeri.
	ExecuteScalar(String)	Yürüten bir Transact-SQL deyim ilk verir ve sütun ilk satırın farklı bir nesne değeri.
	ExecuteTSql	Yürüten bir Transact-SQL komut. (ConnectionManager öğesinden devralınmıştır.)
	ExecuteWithResults(StringCollection)	toplu iş iş yürütür Transact-SQL ifadeleri, dönüş birden çok sonuç kümeleri.
	ExecuteWithResults(String)	Yürüten bir Transact-SQL deyim döndürür, bir sonuç küme.
	Finalize	(Object öğesinden devralınmıştır.)
	ForceDisconnected	Bağlantısını kes zorlar örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	GetHashCode	(Object öğesinden devralınmıştır.)
	GetType	(Object öğesinden devralınmıştır.)
	IsInFixedServerRole	Sınamalar oturum açma başvurulan bağlantıyla ilişkili olup belirtilen sabit sunucu rolü üye.
	MemberwiseClone	(Object öğesinden devralınmıştır.)
	NormalizeQuery(String)	Sorgu metni temsil eden bir dize girişi kullanır.
	NormalizeQuery(String, Boolean)	Sunucu bağlantısı denetleyen sorgu normalleştirir.
	RollBackTransaction	Geçerli işlem geri alınır.
	ThrowIfPropertyNotSet(String, String)	Belirtilen bağlantı özellik null veya boş ise, bir istisna atar. (ConnectionSettings öğesinden devralınmıştır.)
	ThrowIfPropertyNotSet(String, String, Boolean)	Belirtilen bağlantı özellik null veya boş isteğe bağlı olarak, bir istisna atar. (ConnectionSettings öğesinden devralınmıştır.)
	ToString	Başvurulan nesnenin adı bir dize döndürür. (ConnectionSettings öğesinden devralınmıştır.)

Üst

Olaylar

	Ad	Açıklama
	InfoMessage	Bir olay oluştuğunda, örnek , SQL Server oluşturduğu bilgilendirici bir ileti. (ConnectionManager öğesinden devralınmıştır.)
	RemoteLoginFailed	Bağlanmak uzaktan oturum açma başarısız olduğunda, bu olay meydana örnek , SQL Server. (ConnectionManager öğesinden devralınmıştır.)
	ServerMessage	Bir olay oluştuğunda, SQL Server döndüren bir uyarı veya bilgi iletisi geçerli bağlantı. (ConnectionManager öğesinden devralınmıştır.)
	StateChange	Bir olay oluştuğunda, örnek , SQL Server değişiklikleri durumu. (ConnectionManager öğesinden devralınmıştır.)
	StatementExecuted	Bir olay oluştuğunda, örnek , SQL Server yürüten bir deyim geçerli bir bağlantı. (ConnectionManager öğesinden devralınmıştır.)

Üst

Açık Arabirim Uygulamaları

	Ad	Açıklama
	ISfcConnection.Connect	sfc bağlantısını kullanarak bağlanmak için sunucu gösteren bir değeri döndürür.
	ISfcConnection.Copy	Sunucu bağlantısı için sfc bağlantıyı kullanır.
	ISfcConnection.Disconnect	Bağlantıyı keser.
	ISfcConnection.ServerVersion	Server sürüm alır.
	ISfcConnection.ToEnumeratorObject	Sunucu bağlantısı için bir enumerator nesnesi oluşturur.

Üst

Açıklamalar

ServerConnection Sınıfı tarafından sunulan Server sınıf ve çoğaltma sınıfları gibi ReplicationServer WalkTree

Tipik olarak bildirmeniz gerekmez bir örnek , ServerConnection nesne nedeni oluşturulan ile otomatik olarak sunucu nesnesi.Bildirdiğiniz bir ServerConnection , yeniden kullanım için bağlantı ayarlarını depolamak istediğiniz nesne değişkeniConnectionContext özellik, sunucu nesnesi noktalarının bir ServerConnection nesnesi.ServerConnection Nesnesini içeren sunucu nesnesi örnek arasındaki bağlantıyı ilgili özellikler SQL Server.Görüntülemek veya işleme işlemleri, kimlik doğrulaması modu, yürütme moduna işlem kimliği gibi bağlantı belirli yönlerini değiştirmek için ve hatta çalıştırmak için kullanabilirsiniz Transact-SQL doğrudan komutlar.

Kullanarak ServerConnection nesne, aşağıdakileri yapın:

Çalıştır Transact-SQL ifadeleri doğrudan bağlantısı üzerinden örnek , SQL Server.
kimlik doğrulaması yöntem gibi bağlantı ayarlarını değiştirin.
Başlamak, yürütme ve işlemleri geri almak almak.
Yakalama Transact-SQL ifadeleri oluşturulan tarafından smo uygulama.

Örnekler

Bu yöntem ile başka bir örneği için Database , nesne Bkz: [M:Microsoft.SqlServer.Management.Smo.Database.ExecuteNonQuery(System.String].

'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

İş Parçacığı Güvenliği

Bu türdeki tüm ortak static (Visual Basic'te Shared) üyeler iş parçacığı için güvenlidir. Herhangi bir örnek üyenin iş parçacığı için güvenli olduğu garanti edilmemiştir.

Aracılığıyla paylaş