SqlConnection.AccessToken プロパティ

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

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

public string AccessToken { get; set; }

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

member this.AccessToken : string with get, set

Public Property AccessToken As String

プロパティ値

接続のアクセス トークン。

属性

BrowsableAttribute

例外

注釈

AccessToken は、接続プール キーの一部です。 更新されたアクセス トークンを新しい接続に指定すると、他のすべてのプロパティが他の既存の接続と同じになり、その新しい接続が新しいプールに配置されます。 このプロパティを使用して独自のアクセス トークンを管理する場合は、注意が必要です。 代わりに AccessTokenCallback プロパティを使用することを検討してください。更新されたアクセス トークンは、接続プールの目的で個別とは見なされません。

アプリケーションは、アクセス トークンの有効期限が切れ、プールからの接続を使用しないようにする必要があるタイミングを把握する役割を担います。 AccessToken と共に最小プール サイズ > 0 を設定した場合は、アクセス トークンの有効期限が切れた後に ClearPool(SqlConnection) を呼び出して、接続プールが (プールによって作成された) 物理接続を無期限に維持しないようにする必要があります。

このプロパティは、 AccessTokenCallback、 Credential、および SspiContextProvider プロパティと相互に排他的です。 SspiContextProviderが既に設定されている場合にこのプロパティを設定すると、InvalidOperationExceptionがスローされます。SSPI はトークン ベースの認証の代わりに使用されるためです。