ConnectionManager 類別

定義

命名空間:

Microsoft.SqlServer.Management.Common

組件:

Microsoft.SqlServer.ConnectionInfo.dll

套件:

Microsoft.SqlServer.SqlManagementObjects v172.64.0

連線設定與創建

public abstract class ConnectionManager : Microsoft.SqlServer.Management.Common.ConnectionSettings

type ConnectionManager = class
    inherit ConnectionSettings

Public MustInherit Class ConnectionManager
Inherits ConnectionSettings

繼承

Object

ConnectionSettings

ConnectionManager

衍生

Microsoft.SqlServer.Management.Common.ServerConnection

欄位

名稱	Description
NoConnectionTimeout	無限等待 (繼承來源 ConnectionSettings)

屬性

名稱	Description
AcceptsLogin	如果 LoginSecure 和 Authentication 目前的值都使用 Login 屬性，則會回傳 true。 (繼承來源 ConnectionSettings)
AccessToken	連線設定與創建 (繼承來源 ConnectionSettings)
ApplicationIntent	連線的應用意圖有效值為 ReadWrite 與 ReadOnly (繼承來源 ConnectionSettings)
ApplicationName	應用程式的名稱。 若未提供應用程式名稱，則稱為「SQL 管理」。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
Authentication	連線的認證類型 (繼承來源 ConnectionSettings)
AutoDisconnectMode	連線設定與創建
CapturedSql	連線設定與創建
ConnectAsUser	若設為 true，連線將以指定使用者的憑證建立。 此舉假設冒充，但 LoginSecure 標誌及登入與密碼欄位不受影響。 這個設定只能在 Windows 上使用。 (繼承來源 ConnectionSettings)
ConnectAsUserName	指定建立冒充連線時所使用的 Windows 使用者。 使用者必須擁有互動式登入權限。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (繼承來源 ConnectionSettings)
ConnectAsUserPassword	指定 Windows 使用者在建立冒充連線時使用的密碼。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (繼承來源 ConnectionSettings)
ConnectionProtocol	線上通訊協定。
ConnectionString	該屬性會回傳使用者指定的 連接字串，或是根據物件設定回傳計算出的 連接字串。 若明確設定，ServerConnection 物件中的所有屬性都會被填入以反映傳入的 連接字串。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
ConnectTimeout	等待連線到伺服器的時間（以秒計）後終止嘗試並拋出例外。 預設是30秒（和Shiloh一樣）。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
CurrentDatabase	回傳目前的資料庫上下文。
DatabaseEngineEdition	資料庫引擎 版本
DatabaseEngineType	回傳 SQL Server 的資料庫引擎類型。 例外：ConnectionFailureException
DatabaseName	待定 (繼承來源 ConnectionSettings)
EncryptConnection	連接字串 是否指定「encrypt=true」 (繼承來源 ConnectionSettings)
HostNameInCertificate	憑證中提供的主機名稱用於憑證驗證。 (繼承來源 ConnectionSettings)
HostPlatform	伺服器的主機平台（Linux/Windows 等）
InUse	如果物件至少與伺服器連接過一次，則會回傳為真。 若屬實，則不再允許屬性變更，且當屬性變更時會拋出 ConnectionCannotBeChangedException。
IsContainedAuthentication	如果資料庫引擎使用包含的認證來驗證，則會回傳為真。 例外：ConnectionFailureException
IsForceDisconnected	表示連線已被強制斷開
IsOpen	如果 SqlConnection 物件與伺服器有連線，則會回傳 true。 這只能在非池化連線中回應，因為組化連線在操作結束後總是直接閉合。
LockTimeout	LockTimeout 是指幾秒鐘內的鎖定超時。 預設 -1 是無限期的。 對於所有其他負數都會拋出 InvalidPropertyValueException。 正鎖定超時會乘以 1000，然後用於「設定LOCK_TIMEOUT」設定。
Login	用來連接伺服器的 SQL Server 登入名稱。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (繼承來源 ConnectionSettings)
LoginSecure	若設為 true，則使用 Windows 整合的安全機制，並忽略登入與密碼。 若未設定，則使用 SQL Server 認證。 例外：ConnectionCannotBeChangedException (繼承來源 ConnectionSettings)
MaxPoolSize	集區中所允許的最大連接數。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
MinPoolSize	集區中維持的最小連接數。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
MultipleActiveResultSets	從連線啟用 MARS。 預設值為 false。 (繼承來源 ConnectionSettings)
NetworkProtocol	識別用於連接 SQL Server 的用戶端網路協定。 如果你沒有指定網路，且使用本地伺服器，則會使用共享記憶體。 如果你沒有指定網路，且使用遠端伺服器，則會使用已設定的客戶端協定之一。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
NonPooledConnection	預設情況下，所有與 SQL Server 的連線都來自 ADO.NET 連線池。若設為 true，使用者可建立非池連線（關閉時不會重複使用）。 例外：ConnectionCannotBeChangedException (繼承來源 ConnectionSettings)
PacketSize	網路封包的大小（以位元組計）與 SQL Server 實例通訊。 預設是 8192。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
Password	登入時用來連接伺服器的密碼。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (繼承來源 ConnectionSettings)
PooledConnectionLifetime	當連線回傳到池時，會將其建立時間與當前時間比較，若該時間跨度（以秒計）超過連線壽命所規定的值，連線即被銷毀。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
ProductVersion	取得此連線的 ProductVersion 伺服器屬性
RequiresLogin	如果 LoginSecure 和 Authentication 的當前值需要設定登入屬性，則會回傳 true。 (繼承來源 ConnectionSettings)
ResetConnectionString	告訴我們 ConnectionManager 的 SqlConnectionObject 屬性是否需要重置 ConnectionString。 (繼承來源 ConnectionSettings)
SecureConnectionString	該屬性會回傳使用者指定的 連接字串 版本，或是根據物件設定回傳計算出的 連接字串。 若明確設定，ServerConnection 物件中的所有屬性都會被填入以反映傳入的 連接字串。 例外：ConnectionCannotBeChangedException (繼承來源 ConnectionSettings)
SecurePassword	登入時用來連接伺服器的密碼。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (繼承來源 ConnectionSettings)
ServerCertificate	用於憑證驗證的伺服器憑證路徑。 (繼承來源 ConnectionSettings)
ServerInstance	物件將連接的 SQL Server 名稱。 若未設定，則為本地伺服器。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)
ServerVersion	回傳 SQL Server 的主要版本號。 例如 8 for SQL Server 2000。 例外：ConnectionFailureException
SqlConnectionObject	回傳 ConnectionContext 物件所使用的 SqlConnection 物件的參考。 這應該總是回傳有效的 sqlConnection 物件，且 ConnectionString 設定為最新有效。 例外：PropertyNotAvailableException
StrictEncryption	是否在 連接字串 中指定「encrypt=strict」。 當為真時，的 EncryptConnection 值會被忽略。 (繼承來源 ConnectionSettings)
TrustServerCertificate	請指示客戶端是否信任伺服器憑證 (繼承來源 ConnectionSettings)
WorkstationId	連接 SQL Server 的工作站名稱。 例外：ConnectionCannotBeChangedException InvalidPropertyValueException (繼承來源 ConnectionSettings)

方法

名稱	Description
CheckServerVersion(ServerVersion)	確認我們是否連接到支援的伺服器版本。 ServerConnection 中的 block off <= 7.0。
Connect()	建立與 SQL Server 的實際連線。 如果已經連結過，就忽略。 呼叫此方法為可選，因為連線會在需要時被開啟。 例外：ConnectionFailureException
Disconnect()	關閉與 SQL Server 的連線。 如果已經斷線，就忽略。 例外：ConnectionFailureException
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	根據傳遞的參數動作資訊，使用適當的方法執行 T-SQL。
ForceDisconnected()	強制斷線並確保該連線無法再次開啟
ThrowIfPropertyNotSet(String, String, Boolean)	連線設定與創建 (繼承來源 ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	連線設定與創建 (繼承來源 ConnectionSettings)
ToString()	連線設定與創建 (繼承來源 ConnectionSettings)

事件

名稱	Description
InfoMessage	當 SQL Server 回傳警告或資訊訊息時，會發生這種情況。 使用 SqlClient.SqlInfoMessageEventHandler。
RemoteLoginFailed	當伺服器需要連接遠端伺服器且登入失敗時呼叫
ServerMessage	當 SQL Server 回傳警告或資訊訊息時，會發生這種情況。 使用 SqlClient.SqlInfoMessageEventHandler。
StateChange	當連接的狀態變更時發生。 使用 System.Data.StateChangeEventHandler。
StatementExecuted	連線設定與創建