SqlConnection.RegisteredApplication 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

Package(패키지):

Microsoft.Data.SqlClient v7.1.0

Important

이 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, set

Public Property RegisteredApplication As RegisteredApplication

속성 값

RegisteredApplication

RegisteredApplication 값입니다. 기본값은 Unknown입니다.

특성

CLSCompliantAttribute

예외

InvalidOperationException

연결이 열리거나 열려 있습니다. ID는 로그인하는 동안 보고되므로 미리 설정해야 합니다.

예제

연결을 열기 전에 ID를 설정합니다.

using Microsoft.Data.SqlClient;

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

설명

이 API는 식별자를 예약하는 등록된 애플리케이션을 위한 것입니다 RegisteredApplication. 해당 형식으로 값을 캐스팅하여 등록되지 않은 식별자를 보고할 수 있습니다.

이 값은 원격 분석입니다. 범위의 식별자를 보고할 수 있는 클라이언트에서 전적으로 제공되므로 인증된 ID가 아니며 권한 부여 또는 기타 보안 결정에 사용해서는 안 됩니다.

ID는 로그인하는 동안 한 번 전송되므로 연결을 열기 전에 설정해야 합니다.

풀링을 사용하도록 설정하면 새 물리적 연결을 설정하는 동안에만 값이 보고되며 풀 키의 일부가 아닙니다. 따라서 풀에서 제공되는 연결은 실제 연결을 만든 연결의 ID를 보고하고, 실제 연결은 보고서를 Unknown만족 Min Pool Size 시키기 위해 백그라운드에서 열렸습니다. 한 연결 문자열 ID를 혼합하는 애플리케이션은 이 원격 분석을 정확하지 않은 표시로 처리하거나 정확한 특성이 필요한 풀링을 사용하지 않도록 설정해야 합니다.