Lenguaje

SqlConnection.RegisteredApplication Propiedad

Definición

Importante

Esta API no es conforme a CLS.

Obtiene o establece la identidad de la aplicación de middleware notificada al servidor para esta conexión.

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 de propiedad

Un valor RegisteredApplication. El valor predeterminado es Unknown.

Atributos

Excepciones

La conexión se abre o abre. La identidad se notifica durante el inicio de sesión, por lo que debe establecerse de antemano.

Ejemplos

Establezca la identidad antes de abrir la conexión:

using Microsoft.Data.SqlClient;

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

Comentarios

Esta API está pensada para aplicaciones registradas que reservan un identificador en RegisteredApplication. Se puede notificar un identificador no registrado mediante la conversión de un valor a ese tipo.

Este valor es telemetría. El cliente lo proporciona por completo, que puede notificar cualquier identificador en el intervalo, por lo que no es una identidad autenticada y no debe usarse para la autorización ni para ninguna otra decisión de seguridad.

La identidad se envía una vez, durante el inicio de sesión, por lo que debe establecerse antes de que se abra la conexión.

Cuando la agrupación está habilitada, el valor solo se notifica al establecer una nueva conexión física y no forma parte de la clave de grupo. Por lo tanto, una conexión atendida desde el grupo informa de la identidad de la conexión que provocó que se creara esa conexión física y las conexiones físicas abiertas en segundo plano para satisfacer Min Pool Size el informe Unknown. Las aplicaciones que mezclan identidades en una cadena de conexión deben tratar esta telemetría como indicativa en lugar de exacta o deshabilitar la agrupación donde se requiere una atribución exacta.

Se aplica a