SqlConnection.RegisteredApplication 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v7.1.0

重要

此 API 不符合 CLS 規範。

取得或設定此連線中介軟體應用程式身份，回報給伺服器。

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

屬性值

RegisteredApplication

一個 RegisteredApplication 值。 預設值為 Unknown。

屬性

CLSCompliantAttribute

例外狀況

InvalidOperationException

連線是開啟或開啟。 身份會在登入時報告，因此必須事先設定。

範例

在開啟連線前先設定身份：

using Microsoft.Data.SqlClient;

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

備註

此 API 是為註冊應用程式設計，且在 中保留識別碼。RegisteredApplication 未註冊識別碼可透過鑄造該類型值來回報。

這個數值就是遙測。 它完全由用戶端提供，客戶端可報告範圍內的任何識別碼，因此該識別碼並非經過認證的身份，且不得用於授權或其他安全決策。

身份只會在登入時傳送一次，因此必須在開啟連線前設定好。

啟用池化時，該值僅在建立新的實體連線時報告，且不包含在池金鑰中。 因此，從池中服務的連線會回報導致該實體連線建立的連線身份，並在背景中開啟物理連線以滿足 Min Pool Size 報告 Unknown。 在單一 連接字串 上混合身份的應用程式，應將此遙測視為指示性資料而非精確資料，或在需要精確歸因時關閉池化。