Język

SqlConnection.AccessToken Właściwość

Definicja

Pobiera lub ustawia token dostępu dla połączenia.

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

Wartość właściwości

Token dostępu dla połączenia.

Atrybuty

Wyjątki

Element AccessToken jest połączony z innymi konfiguracjami uwierzytelniania powodującego konflikt.

Uwagi

Klucz accessToken jest częścią klucza puli połączeń. Podanie odświeżonego tokenu dostępu do nowego połączenia ze wszystkimi innymi właściwościami, które są takie same jak inne istniejące połączenia, spowoduje umieszczenie nowego połączenia w nowej puli. Należy zachować ostrożność podczas używania tej właściwości do zarządzania własnym tokenem dostępu. Rozważ użycie AccessTokenCallback właściwości , która nie będzie uwzględniać odświeżonych tokenów dostępu jako odrębnych dla celów buforowania połączeń.

Aplikacja jest odpowiedzialna za poznanie, kiedy token dostępu wygaśnie, a połączenia z puli nie powinny być już używane. Jeśli ustawisz minimalny rozmiar > puli 0 wraz z tokenem AccessToken, musisz wywołać ClearPool(SqlConnection) wywołanie po wygaśnięciu tokenu dostępu, aby upewnić się, że pula połączeń nie utrzymuje połączeń fizycznych (utworzonych przez pulę) na czas nieokreślony.

Ta właściwość wzajemnie wyklucza się z AccessTokenCallbackwłaściwościami , Credentiali SspiContextProvider . Ustawienie tej właściwości, gdy SspiContextProvider jest już ustawiona InvalidOperationExceptionzgłasza wyjątek , ponieważ SSPI jest alternatywą dla uwierzytelniania opartego na tokenach.

Dotyczy