SqlConnection.AccessToken Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Zugriffstoken für die Verbindung ab oder legt es fest.
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
Eigenschaftswert
Das Zugriffstoken für die Verbindung.
- Attribute
Ausnahmen
Dies AccessToken wird mit anderen in Konflikt stehenden Authentifizierungskonfigurationen kombiniert.
Hinweise
AccessToken ist Teil des Verbindungspoolschlüssels. Wenn Sie ein aktualisiertes Zugriffstoken für eine neue Verbindung bereitstellen, wobei alle anderen Eigenschaften mit anderen vorhandenen Verbindungen identisch sind, wird diese neue Verbindung in einem neuen Pool platziert. Achten Sie darauf, wenn Sie diese Eigenschaft verwenden, um Ihr eigenes Zugriffstoken zu verwalten. Erwägen Sie stattdessen die Verwendung der AccessTokenCallback Eigenschaft, die aktualisierte Zugriffstoken nicht als eindeutig für die Zwecke der Verbindungspooling betrachtet.
Die Anwendung ist dafür verantwortlich zu wissen, wann das Zugriffstoken abläuft, und die Verbindungen vom Pool sollten nicht mehr verwendet werden. Wenn Sie eine Mindestpoolgröße > 0 zusammen mit einem AccessToken festlegen, müssen Sie aufrufen ClearPool(SqlConnection) , nachdem das Zugriffstoken abgelaufen ist, um sicherzustellen, dass der Verbindungspool die physischen Verbindungen (die durch den Pool erstellt werden) nicht unbegrenzt verwaltet.
Diese Eigenschaft schließt sich gegenseitig mit den AccessTokenCallbackEigenschaften Credential, und SspiContextProvider die Eigenschaften aus. Wenn diese Eigenschaft SspiContextProvider bereits festgelegt wird, wird ausgelöst InvalidOperationException, da SSPI eine Alternative zur tokenbasierten Authentifizierung ist.