Język

SqlConnection.RegisteredApplication Właściwość

Definicja

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Pobiera lub ustawia tożsamość aplikacji oprogramowania pośredniczącego zgłoszoną na serwerze dla tego połączenia.

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

Wartość właściwości

Wartość RegisteredApplication. Wartość domyślna to Unknown.

Atrybuty

Wyjątki

Połączenie jest otwierane lub otwarte. Tożsamość jest zgłaszana podczas logowania, dlatego należy ją ustawić wcześniej.

Przykłady

Ustaw tożsamość przed otwarciem połączenia:

using Microsoft.Data.SqlClient;

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

Uwagi

Ten interfejs API jest przeznaczony dla zarejestrowanych aplikacji, które rezerwują identyfikator w RegisteredApplicationprogramie . Niezarejestrowany identyfikator może być zgłaszany przez rzutowanie wartości do tego typu.

Ta wartość to telemetria. Jest on dostarczany w całości przez klienta, który może zgłaszać dowolny identyfikator w zakresie, więc nie jest to tożsamość uwierzytelniona i nie może być używana do autoryzacji ani żadnej innej decyzji dotyczącej zabezpieczeń.

Tożsamość jest wysyłana raz podczas logowania, dlatego należy ją ustawić przed otwarciem połączenia.

Po włączeniu buforowania wartość jest zgłaszana tylko podczas ustanawiania nowego połączenia fizycznego i nie jest częścią klucza puli. Połączenie obsługiwane z puli w związku z tym zgłasza tożsamość niezależnie od tego, które połączenie spowodowało utworzenie połączenia fizycznego, a połączenia fizyczne otwarte w tle w celu zaspokojenia Min Pool Size raportu Unknown. Aplikacje, które mieszają tożsamości na jednym parametry połączenia, powinny traktować tę telemetrię jako wskazanie, a nie dokładne, lub wyłączyć buforowanie, gdy wymagane jest dokładne przypisanie.

Dotyczy