SqlConnection.RegisteredApplication Właściwość

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v7.1.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

RegisteredApplication

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

Atrybuty: CLSCompliantAttribute

Wyjątki

InvalidOperationException

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