ServerConnection 類別

發行項
04/22/2014

ServerConnection 物件代表伺服器的連接。

繼承階層

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

命名空間： Microsoft.SqlServer.Management.Common
組件： Microsoft.SqlServer.ConnectionInfo (在 Microsoft.SqlServer.ConnectionInfo.dll 中)

語法

'宣告
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'用途
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 型別公開下列成員。

建構函式

	名稱	說明
	ServerConnection()	初始化 ServerConnection 類別的新執行個體。
	ServerConnection(SqlConnection)	使用指定的連接參數，初始化 ServerConnection 類別的新執行個體。
	ServerConnection(String)	使用指定的伺服器執行個體，初始化 ServerConnection 類別的新執行個體。
	ServerConnection(SqlConnectionInfo)	使用指定的連接資訊，初始化 ServerConnection 類別的新執行個體。
	ServerConnection(String, String, SecureString)	使用指定的伺服器執行個體和登入認證，初始化 ServerConnection 類別的新執行個體。
	ServerConnection(String, String, String)	使用指定的伺服器執行個體和登入認證，初始化 ServerConnection 類別的新執行個體。

回到頁首

屬性

	名稱	說明
	ApplicationName	取得或設定已建立與伺服器連接的應用程式名稱。 (繼承自 ConnectionSettings。)
	AutoDisconnectMode	取得或設定與 SQL Server 執行個體之參考連接的自動中斷連接模式。 (繼承自 ConnectionManager。)
	BatchSeparator	取得或設定在參考的連接中用來分隔批次的字串值。
	CapturedSql	取得在擷取模式下執行連接時所擷取的 Transact-SQL 陳述式。 (繼承自 ConnectionManager。)
	ConnectAsUser	取得或設定 Boolean 屬性值，這個值指定是否會使用模擬來建立連接。 (繼承自 ConnectionSettings。)
	ConnectAsUserName	取得或設定使用模擬進行連接時的使用者名稱。 (繼承自 ConnectionSettings。)
	ConnectAsUserPassword	取得或設定使用模擬進行連接時的使用者密碼。 (繼承自 ConnectionSettings。)
	ConnectionString	取得或設定建立與指定之資料來源的連接時所使用的連接字串。 (繼承自 ConnectionSettings。)
	ConnectionType	取得要在伺服器中使用的連接類型。
	ConnectTimeout	取得或設定連接逾時期限 (以秒為單位)。 (繼承自 ConnectionSettings。)
	DatabaseEngineType	取得 Database Engine 類型。 (繼承自 ConnectionManager。)
	DatabaseName	取得或設定連接所需的資料庫。 (繼承自 ConnectionSettings。)
	EncryptConnection	取得或設定指定連線是否經過加密的 Boolean 屬性值。 (繼承自 ConnectionSettings。)
	FixedServerRoles	取得與參考連接相關聯的固定伺服器角色。
	InUse	取得或設定 Boolean 屬性值，這個值會指定是否正在使用連接。 (繼承自 ConnectionManager。)
	IsForceDisconnected	取得 Boolean 值，這個值指定是否已強制中斷連接。 (繼承自 ConnectionManager。)
	IsOpen	取得指定連接目前是否開啟的 Boolean 屬性值。 (繼承自 ConnectionManager。)
	LockTimeout	取得或設定鎖定目前交易時連接逾時所需的時間 (以秒為單位)。 (繼承自 ConnectionManager。)
	Login	取得或設定建立與伺服器執行個體的連接時所需要的登入。 (繼承自 ConnectionSettings。)
	LoginSecure	取得或設定 Boolean 屬性，這個屬性指定要使用 Windows 驗證還是 SQL Server 驗證來建立伺服器連接。 (繼承自 ConnectionSettings。)
	MaxPoolSize	取得或設定建立與伺服器的連接時，指定的連接在連接集區中接受的連接數目上限。 (繼承自 ConnectionSettings。)
	MinPoolSize	取得或設定建立與伺服器的連接時，指定的連接在連接集區中接受的連接數目下限。 (繼承自 ConnectionSettings。)
	MultipleActiveResultSets	取得或設定 Boolean 屬性值，這個值指定是否允許一個以上作用中的結果集。 (繼承自 ConnectionSettings。)
	NetworkProtocol	取得或設定用來建立與伺服器之連接的網路通訊協定。 (繼承自 ConnectionSettings。)
	NonPooledConnection	取得或設定指定連接是否可共用的 Boolean 屬性值。 (繼承自 ConnectionSettings。)
	PacketSize	取得或設定透過網路在用戶端與伺服器之間傳送的資料封包 (以位元組為單位)。 (繼承自 ConnectionSettings。)
	ParameterizationMode	取得或設定伺服器連接的參數化模式。
	Password	取得或設定使用 SQL Server 驗證時，建立伺服器連接之登入所使用的密碼。 (繼承自 ConnectionSettings。)
	PooledConnectionLifetime	取得或設定共用連接的存留期間。 (繼承自 ConnectionSettings。)
	ProcessID	取得識別碼值，這個值可唯一識別與伺服器之參考連接相關聯的處理序。
	SecureConnectionString	取得或設定連接字串的加密版本。 (繼承自 ConnectionSettings。)
	SecurePassword	取得或設定使用 SQL Server 驗證時，建立伺服器連接之登入所使用的安全密碼。 (繼承自 ConnectionSettings。)
	ServerInstance	取得或設定伺服器的名稱。 (繼承自 ConnectionSettings。)
	ServerVersion	取得連接之 SQL Server 執行個體的版本。 (繼承自 ConnectionManager。)
	SqlConnectionObject	取得連接物件。 (繼承自 ConnectionManager。)
	SqlExecutionModes	取得或設定與伺服器之參考連接相關聯的執行模式。
	StatementTimeout	取得或設定陳述式因為逾時錯誤而失敗之前可以執行的秒數。
	TransactionDepth	取得參考連接目前的交易深度。
	TrueLogin	取得參考連接目前所使用的登入記錄名稱。
	TrueName	取得伺服器的名稱。
	UseMode	取得或設定使用指定模式的伺服器連接。
	UserProfile	取得與參考連接相關聯的使用者設定檔。
	WorkstationId	取得或設定可唯一識別工作站的識別碼值。 (繼承自 ConnectionSettings。)

回到頁首

方法

	名稱	說明
	BeginTransaction	在參考的連接上啟動交易。
	Cancel	取消連接。
	ChangePassword(SecureString)	變更與標準驗證搭配使用的登入密碼。
	ChangePassword(String)	變更與標準驗證搭配使用的登入密碼。
	CommitTransaction	認可參考連接上目前的交易。
	Connect	連接到 SQL Server 的執行個體。 (繼承自 ConnectionManager。)
	Copy	傳回 ServerConnection 物件的複本。
	Disconnect	中斷與 SQL Server執行個體的連接。 (繼承自 ConnectionManager。)
	Equals	(繼承自 Object。)
	ExecuteNonQuery(StringCollection)	執行不會傳回結果集的陳述式批次。
	ExecuteNonQuery(String)	執行不會傳回結果集的陳述式。
	ExecuteNonQuery(StringCollection, ExecutionTypes)	執行具有指定的執行選項而且不會傳回結果集的陳述式批次。
	ExecuteNonQuery(String, ExecutionTypes)	執行具有指定的執行選項而且不會傳回結果集的陳述式。
	ExecuteReader(String)	執行傳回一個或多個結果集的 Transact-SQL 陳述式。
	ExecuteReader(String, SqlCommand%)	使用包含一個或多個結果集的 SqlDataReader 物件值，執行讀取器。
	ExecuteScalar(StringCollection)	執行 Transact-SQL 陳述式的批次，並以物件值傳回第一個資料列的第一個資料行。
	ExecuteScalar(String)	執行 Transact-SQL 陳述式，並以物件值傳回第一個資料列的第一個資料行。
	ExecuteWithResults(StringCollection)	執行傳回多個結果集的 Transact-SQL 陳述式批次。
	ExecuteWithResults(String)	執行傳回結果集的 Transact-SQL 陳述式。
	ForceDisconnected	強制中斷與 SQL Server 執行個體的連接。 (繼承自 ConnectionManager。)
	GetHashCode	(繼承自 Object。)
	GetType	(繼承自 Object。)
	IsInFixedServerRole	測試與參考連接相關聯的登入是否為指定之固定伺服器角色的成員。
	NormalizeQuery(String)	使用代表查詢文字的字串輸入。
	NormalizeQuery(String, Boolean)	將控制伺服器連接的查詢正規化。
	RollBackTransaction	回復目前的交易。
	ToString	傳回字串格式的參考物件名稱。 (繼承自 ConnectionSettings。)

回到頁首

事件

	名稱	說明
	InfoMessage	SQL Server 的執行個體產生資訊訊息時所發生的事件。 (繼承自 ConnectionManager。)
	RemoteLoginFailed	當遠端登入無法連接到 SQL Server 的執行個體時，就會發生這個事件。 (繼承自 ConnectionManager。)
	ServerMessage	SQL Server 在目前的連接上傳回警告或資訊訊息時所發生的事件。 (繼承自 ConnectionManager。)
	StateChange	SQL Server 的執行個體變更狀態時所發生的事件。 (繼承自 ConnectionManager。)
	StatementExecuted	SQL Server 的執行個體在目前的連接上執行陳述式時所發生的事件。 (繼承自 ConnectionManager。)

回到頁首

明確繼承實作

	名稱	說明
	ISfcConnection.Connect	傳回值，這個值表示使用 SFC 連接來連接的伺服器。
	ISfcConnection.Copy	使用 SFC 連接來複製伺服器連接。
	ISfcConnection.Disconnect	中斷連接。
	ISfcConnection.ServerVersion	取得伺服器的版本。
	ISfcConnection.ToEnumeratorObject	轉譯伺服器連接的列舉值物件。

回到頁首

備註

ServerConnection 類別是由 Server 類別為服務，並複製類別 (例如 ReplicationServer 分類。

一般而言，，因為它會自動建立與伺服器物件，您就必須宣告 ServerConnection 物件的執行個體。如果您想要儲存重複使用的連接設定，請 ServerConnection 宣告物件變數。伺服器物件上的屬性設定為 ConnectionContext ServerConnection 物件的。 ServerConnection 物件包含與伺服器物件 SQL Server和執行個體之間的連接相關聯的屬性。您可以使用它來檢視或修改連接的某些層面，例如處理序識別碼，管理交易，驗證模式，執行模式和直接即使執行 Transact-SQL 命令。

使用 ServerConnection 物件，您可以執行下列動作:

執行 Transact-SQL 陳述式直接在 SQL Server對執行個體的連接。
變更連接設定，例如驗證方法。
開始進行，而且會回復交易。
擷取 SMO 應用程式所產生的 Transact-SQL 陳述式。

範例

如需有關這個方法的另一個執行個體與 Database 物件，請參閱 [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

執行緒安全性

這個型別的任何公用 static (在 Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

共用方式為

ServerConnection 類別

繼承階層

語法

建構函式

屬性

方法

事件

明確繼承實作

備註

範例

執行緒安全性

請參閱

參考

其他資源

其他資源

共用方式為

ServerConnection 類別

繼承階層

語法

建構函式

屬性

方法

事件

明確 繼承 實作

備註

範例

執行緒安全性

請參閱

參考

其他資源

其他資源

明確繼承實作