SqlConnection.RegisteredApplication Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Package:

Microsoft.Data.SqlClient v7.1.0

Important

Cette API n’est pas conforme CLS.

Obtient ou définit l’identité de l’application middleware signalée au serveur pour cette connexion.

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

Valeur de propriété

RegisteredApplication

Une valeur RegisteredApplication. La valeur par défaut est Unknown.

Attributs

CLSCompliantAttribute

Exceptions

InvalidOperationException

La connexion est ouverte ou ouverte. L’identité est signalée lors de la connexion. Elle doit donc être définie au préalable.

Exemples

Définissez l’identité avant d’ouvrir la connexion :

using Microsoft.Data.SqlClient;

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

Remarques

Cette API est destinée aux applications inscrites qui réservent un identificateur dans RegisteredApplication. Un identificateur non inscrit peut être signalé en cas de conversion d’une valeur sur ce type.

Cette valeur est la télémétrie. Il est fourni entièrement par le client, qui peut signaler n’importe quel identificateur dans la plage, de sorte qu’il n’est pas une identité authentifiée et ne doit pas être utilisé pour l’autorisation ou toute autre décision de sécurité.

L’identité est envoyée une fois, lors de la connexion, de sorte qu’elle doit être définie avant l’ouverture de la connexion.

Lorsque le regroupement est activé, la valeur est signalée uniquement lors de l’établissement d’une nouvelle connexion physique, et elle ne fait pas partie de la clé de pool. Une connexion servie à partir du pool signale donc l’identité de la connexion à laquelle la connexion physique a été créée et les connexions physiques ouvertes en arrière-plan pour satisfaire Min Pool Size le rapport Unknown. Les applications qui combinent des identités sur une chaîne de connexion doivent traiter ces données de télémétrie comme indicatifs plutôt que exacts, ou désactiver le regroupement où une attribution exacte est requise.