SqlConnection.RegisteredApplication Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v7.1.0

Importante

Esta API não está em conformidade com CLS.

Obtém ou define a identidade do aplicativo middleware relatada ao servidor para essa conexão.

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

Valor da propriedade

RegisteredApplication

Um RegisteredApplication valor. O padrão é Unknown.

Atributos

CLSCompliantAttribute

Exceções

InvalidOperationException

A conexão está aberta ou aberta. A identidade é relatada durante o logon, portanto, ela deve ser definida com antecedência.

Exemplos

Defina a identidade antes de abrir a conexão:

using Microsoft.Data.SqlClient;

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

Comentários

Essa API destina-se a aplicativos registrados que reservam um identificador em RegisteredApplication. Um identificador não registrado pode ser relatado por meio da conversão de um valor para esse tipo.

Esse valor é telemetria. Ele é fornecido inteiramente pelo cliente, que pode relatar qualquer identificador no intervalo, portanto, ele não é uma identidade autenticada e não deve ser usado para autorização ou qualquer outra decisão de segurança.

A identidade é enviada uma vez, durante o logon, portanto, ela deve ser definida antes que a conexão seja aberta.

Quando o pool é habilitado, o valor é relatado apenas ao estabelecer uma nova conexão física e não faz parte da chave do pool. Uma conexão fornecida do pool, portanto, relata a identidade de qualquer conexão que tenha causado a criação dessa conexão física e conexões físicas abertas em segundo plano para satisfazer Min Pool Size o relatório Unknown. Os aplicativos que combinam identidades em uma cadeia de conexão devem tratar essa telemetria como indicativa em vez de exata ou desabilitar o pool em que uma atribuição exata é necessária.