SqlConnection.RegisteredApplication Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wichtig
Diese API ist nicht CLS-kompatibel.
Ruft die Middleware-Anwendungsidentität ab, die an den Server für diese Verbindung gemeldet wird, oder legt diese fest.
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, setPublic Property RegisteredApplication As RegisteredApplicationEigenschaftswert
Ein RegisteredApplication-Wert. Der Standardwert lautet Unknown.
- Attribute
Ausnahmen
Die Verbindung wird geöffnet oder geöffnet. Die Identität wird während der Anmeldung gemeldet, sodass sie vorher festgelegt werden muss.
Beispiele
Legen Sie die Identität vor dem Öffnen der Verbindung fest:
using Microsoft.Data.SqlClient;
using SqlConnection connection = new(connectionString)
{
RegisteredApplication = RegisteredApplication.EntityFrameworkCore
};
connection.Open();
Hinweise
Diese API ist für registrierte Anwendungen vorgesehen, die einen Bezeichner reservieren.RegisteredApplication Ein nicht registrierter Bezeichner kann durch Umwandlung eines Werts in diesen Typ gemeldet werden.
Dieser Wert ist Telemetrie. Sie wird vollständig vom Client bereitgestellt, der einen beliebigen Bezeichner im Bereich melden kann, sodass es sich nicht um eine authentifizierte Identität handelt und nicht für die Autorisierung oder andere Sicherheitsentscheidungen verwendet werden darf.
Die Identität wird einmal gesendet, während der Anmeldung, sodass sie vor dem Öffnen der Verbindung festgelegt werden muss.
Wenn die Poolerstellung aktiviert ist, wird der Wert nur bei der Einrichtung einer neuen physischen Verbindung gemeldet und ist nicht Teil des Poolschlüssels. Eine vom Pool bereitgestellte Verbindung meldet daher die Identität der Verbindung, die dazu führte, dass eine physische Verbindung erstellt wurde, und physische Verbindungen, die im Hintergrund geöffnet wurden, um den Bericht Unknownzu erfüllenMin Pool Size. Anwendungen, die Identitäten über eine Verbindungszeichenfolge kombinieren, sollten diese Telemetrie als richtwert und nicht genau behandeln oder pooling deaktivieren, wenn eine genaue Zuordnung erforderlich ist.