SqlConnection.RegisteredApplication Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.1.0

Penting

API ini bukan kompatibel CLS.

Mendapatkan atau mengatur identitas aplikasi middleware yang dilaporkan ke server untuk koneksi ini.

public:
 property Microsoft::Data::SqlClient::RegisteredApplication RegisteredApplication { Microsoft::Data::SqlClient::RegisteredApplication get(); void set(Microsoft::Data::SqlClient::RegisteredApplication value); };

[System.CLSCompliant(false)]
public Microsoft.Data.SqlClient.RegisteredApplication RegisteredApplication { get; set; }

[<System.CLSCompliant(false)>]
member this.RegisteredApplication : Microsoft.Data.SqlClient.RegisteredApplication with get, set

Public Property RegisteredApplication As RegisteredApplication

Nilai Properti

RegisteredApplication

Nilai RegisteredApplication. Defaultnya adalah Unknown.

Atribut

CLSCompliantAttribute

Pengecualian

InvalidOperationException

Koneksi sedang terbuka atau terbuka. Identitas dilaporkan selama masuk, sehingga harus diatur sebelumnya.

Contoh

Atur identitas sebelum membuka koneksi:

using Microsoft.Data.SqlClient;

using SqlConnection connection = new(connectionString)
{
    RegisteredApplication = RegisteredApplication.EntityFrameworkCore
};
connection.Open();

Keterangan

API ini ditujukan untuk aplikasi terdaftar yang memesan pengidentifikasi di RegisteredApplication. Pengidentifikasi yang tidak terdaftar dapat dilaporkan dengan mentransmisikan nilai ke jenis tersebut.

Nilai ini adalah telemetri. Ini disediakan sepenuhnya oleh klien, yang dapat melaporkan pengidentifikasi apa pun dalam rentang, sehingga bukan identitas terautentikasi dan tidak boleh digunakan untuk otorisasi atau keputusan keamanan lainnya.

Identitas dikirim sekali, selama masuk, sehingga harus diatur sebelum koneksi dibuka.

Saat pengumpulan diaktifkan, nilai hanya dilaporkan saat membuat koneksi fisik baru, dan itu bukan bagian dari kunci kumpulan. Oleh karena itu, koneksi yang dilayani dari kumpulan melaporkan identitas koneksi mana pun yang menyebabkan koneksi fisik dibuat, dan koneksi fisik yang dibuka di latar belakang untuk memenuhi Min Pool Size laporan Unknown. Aplikasi yang mencampur identitas lebih dari satu string koneksi harus memperlakukan telemetri ini sebagai indikasi daripada tepat, atau menonaktifkan pengumpulan di mana atribusi yang tepat diperlukan.