SqlConnection.AccessToken Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.