SqlConnection.AccessToken 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v7.1.0

取得或設定連線的存取權杖。

public:
 property System::String ^ AccessToken { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string AccessToken { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.AccessToken : string with get, set

Public Property AccessToken As String

屬性值

String

連線的存取權杖。

屬性

BrowsableAttribute

例外狀況

InvalidOperationException

它 AccessToken 與其他相互衝突的認證配置結合使用。

備註

AccessToken 是連線池金鑰的一部分。 提供更新後的存取權杖給新連線，且其他屬性與現有連線相同，將該新連線放入新的連線池中。 使用此屬性管理您自己的存取權杖時，請特別小心。 建議改用 AccessTokenCallback 該屬性，該屬性不會將更新的存取權杖視為連線池的獨立資料。

應用程式負責判斷存取權杖何時到期，且池中的連線不應再被使用。 如果你設定最低池大小 > 為 0 並同時設定 AccessToken，必須在存取權杖到期後呼叫 ClearPool(SqlConnection) ，以確保連線池不會無限期維持由池所建立的實體連線。

此性質與 AccessTokenCallback、 Credential及 SspiContextProvider 性質互斥。 在 SspiContextProvider 已經設定 時設定此屬性會拋 InvalidOperationException出 ，因為 SSPI 是基於憑證驗證的替代方案。