SqlConnection.AccessToken Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.1.0

Mendapatkan atau mengatur token akses untuk koneksi.

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

Nilai Properti

String

Token akses untuk koneksi.

Atribut

BrowsableAttribute

Pengecualian

InvalidOperationException

dikombinasikan AccessToken dengan konfigurasi autentikasi lain yang bertentangan.

Keterangan

AccessToken adalah bagian dari kunci kumpulan koneksi. Menyediakan token akses yang di-refresh ke koneksi baru, dengan semua properti lain sama dengan koneksi lain yang ada, akan menempatkan koneksi baru tersebut ke kumpulan baru. Perawatan harus diambil saat menggunakan properti ini untuk mengelola token akses Anda sendiri. Pertimbangkan untuk menggunakan properti sebagai gantinya AccessTokenCallback , yang tidak akan mempertimbangkan token akses yang di-refresh sebagai berbeda untuk tujuan pengumpulan koneksi.

Aplikasi bertanggung jawab untuk mengetahui kapan token akses kedaluwarsa dan koneksi dari kumpulan tidak boleh lagi digunakan. Jika Anda menetapkan ukuran > kumpulan minimum 0 bersama dengan AccessToken, Anda harus memanggil ClearPool(SqlConnection) setelah token akses kedaluwarsa untuk memastikan kumpulan koneksi tidak mempertahankan koneksi fisik (dibuat oleh kumpulan) tanpa batas waktu.

Properti ini saling eksklusif dengan AccessTokenCallbackproperti , , Credentialdan SspiContextProvider . Mengatur properti ini ketika SspiContextProvider sudah diatur melempar InvalidOperationException, karena SSPI adalah alternatif untuk autentikasi berbasis token.