SqlConnection.AccessToken Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.1.0

Bağlantı için erişim belirtecini alır veya ayarlar.

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

Özellik Değeri

String

Bağlantının erişim belirteci.

Öznitelikler

BrowsableAttribute

Özel durumlar

InvalidOperationException

AccessToken diğer çakışan kimlik doğrulama yapılandırmalarıyla birleştirilir.

Açıklamalar

AccessToken, bağlantı havuzu anahtarının bir parçasıdır. Diğer tüm özellikler diğer mevcut bağlantılarla aynı olacak şekilde yeni bir bağlantıya yenilenen erişim belirteci sağlamak, bu yeni bağlantıyı yeni bir havuza yerleştirir. Kendi erişim belirtecinizi yönetmek için bu özellik kullanılırken dikkatli olunmalıdır. Bunun yerine, yenilenen erişim belirteçlerini bağlantı havuzu amacıyla ayrı olarak değerlendirmeyen özelliğini kullanmayı AccessTokenCallback göz önünde bulundurun.

Uygulama, erişim belirtecinin süresinin ne zaman dolacağı ve havuzdaki bağlantıların artık kullanılmaması gerektiğini bilmekten sorumludur. AccessToken ile birlikte en düşük havuz boyutunu > 0 olarak ayarlarsanız, bağlantı havuzunun fiziksel bağlantıları (havuz tarafından oluşturulan) süresiz olarak korumadığından emin olmak için erişim belirtecinin süresi dolduktan sonra aramanız ClearPool(SqlConnection) gerekir.

Bu özellik, , Credentialve SspiContextProvider özellikleriyle birbirini dışlarAccessTokenCallback. SSPI, belirteç tabanlı kimlik doğrulamasına alternatif olduğundan, bu özellik SspiContextProvider zaten ayarlandığında oluşturulur InvalidOperationException.