SqlConnection.RegisteredApplication プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
重要
この API は CLS 準拠ではありません。
この接続についてサーバーに報告されるミドルウェア アプリケーション ID を取得または設定します。
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, setPublic Property RegisteredApplication As RegisteredApplicationプロパティ値
RegisteredApplication の値。 既定値は Unknown です。
- 属性
例外
接続が開いているか開いています。 ID はログイン中に報告されるため、事前に設定する必要があります。
例
接続を開く前に ID を設定します。
using Microsoft.Data.SqlClient;
using SqlConnection connection = new(connectionString)
{
RegisteredApplication = RegisteredApplication.EntityFrameworkCore
};
connection.Open();
注釈
この API は、 RegisteredApplicationで識別子を予約する登録済みアプリケーションを対象としています。 未登録の識別子は、その型に値をキャストすることによって報告できます。
この値はテレメトリです。 これはクライアントによって完全に提供されます。これは、範囲内の識別子を報告する可能性があるため、認証された ID ではなく、承認やその他のセキュリティ上の決定に使用しないでください。
ID はログイン中に 1 回送信されるため、接続を開く前に設定する必要があります。
プールが有効になっている場合、値は新しい物理接続の確立中にのみ報告され、プール キーの一部ではありません。 そのため、プールから提供された接続は、その物理接続が作成された原因となった接続の ID を報告し、レポートUnknownを満たすためにバックグラウンドで開かれた物理接続Min Pool Size報告します。 ID を 1 つの接続文字列に混在させるアプリケーションでは、このテレメトリを正確ではなく示すものとして扱うか、正確な属性が必要な場合はプールを無効にする必要があります。