SqlConnection.AccessToken Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Package:

Microsoft.Data.SqlClient v7.1.0

Obtient ou définit le jeton d’accès pour la connexion.

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

Valeur de propriété

String

Jeton d’accès pour la connexion.

Attributs

BrowsableAttribute

Exceptions

InvalidOperationException

Il AccessToken est combiné à d’autres configurations d’authentification en conflit.

Remarques

AccessToken fait partie de la clé du pool de connexions. L’approvisionnement d’un jeton d’accès actualisé à une nouvelle connexion, avec toutes les autres propriétés identiques aux autres connexions existantes, place cette nouvelle connexion dans un nouveau pool. Veillez à utiliser cette propriété pour gérer votre propre jeton d’accès. Envisagez d’utiliser la propriété à la AccessTokenCallback place, qui ne considère pas les jetons d’accès actualisés comme distincts à des fins de regroupement de connexions.

L’application est chargée de savoir quand le jeton d’accès expire et que les connexions du pool ne doivent plus être utilisées. Si vous définissez une taille > minimale de pool 0 avec accessToken, vous devez appeler ClearPool(SqlConnection) une fois le jeton d’accès expiré pour vous assurer que le pool de connexions ne conserve pas les connexions physiques (créées par le pool) indéfiniment.

Cette propriété s’exclue mutuellement avec les propriétés, Credentialet SspiContextProvider les AccessTokenCallbackpropriétés. Définition de cette propriété quand SspiContextProvider elle est déjà définie lève InvalidOperationException, car SSPI est une alternative à l’authentification basée sur des jetons.