SqlConnection.AccessToken Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v7.1.0

Возвращает или задает маркер доступа для подключения.

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

Значение свойства

String

Маркер доступа для подключения.

Атрибуты

BrowsableAttribute

Исключения

InvalidOperationException

В AccessToken сочетании с другими конфликтующими конфигурациями проверки подлинности.

Комментарии

AccessToken является частью ключа пула подключений. При предоставлении обновленного маркера доступа новому соединению все остальные свойства, аналогичные другим существующим подключениям, будут помещать новое подключение в новый пул. Будьте внимательны при использовании этого свойства для управления собственным маркером доступа. Вместо этого рекомендуется использовать AccessTokenCallback свойство, которое не будет рассматривать обновленные маркеры доступа в качестве отдельных для целей пула подключений.

Приложение отвечает за то, что когда срок действия маркера доступа истекает, и подключения из пула больше не должны использоваться. Если вы устанавливаете минимальный размер > пула 0 вместе с AccessToken, необходимо вызвать ClearPool(SqlConnection) после истечения срока действия маркера доступа, чтобы пул соединений не поддерживал физические подключения (созданные пулом) на неопределенный срок.

Это свойство взаимоисключающ с AccessTokenCallbackCredentialсвойствами и SspiContextProvider свойствами. Если этот свойство SspiContextProvider уже задано InvalidOperationException, так как SSPI является альтернативой аутентификации на основе маркеров.