SqlConnection.RegisteredApplication Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.