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) ，以确保连接池不会无限期地维护物理连接（由池创建）。

此属性与AccessTokenCallback属性CredentialSspiContextProvider和属性互斥。 设置此属性时已设置引发SspiContextProviderInvalidOperationException，因为 SSPI 是基于令牌的身份验证的替代方法。