SqlConnection.RegisteredApplication Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Importante
Questa API non è conforme a CLS.
Ottiene o imposta l'identità dell'applicazione middleware segnalata al server per questa connessione.
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
Valore della proprietà
Valore RegisteredApplication. Il valore predefinito è Unknown.
- Attributi
Eccezioni
La connessione è aperta o aperta. L'identità viene segnalata durante l'accesso, quindi deve essere impostata in anticipo.
Esempio
Impostare l'identità prima di aprire la connessione:
using Microsoft.Data.SqlClient;
using SqlConnection connection = new(connectionString)
{
RegisteredApplication = RegisteredApplication.EntityFrameworkCore
};
connection.Open();
Commenti
Questa API è destinata alle applicazioni registrate che riservano un identificatore in RegisteredApplication. Un identificatore non registrato può essere segnalato eseguendo il cast di un valore a tale tipo.
Questo valore è la telemetria. Viene fornito interamente dal client, che può segnalare qualsiasi identificatore nell'intervallo, quindi non è un'identità autenticata e non deve essere usata per l'autorizzazione o per qualsiasi altra decisione di sicurezza.
L'identità viene inviata una volta, durante l'accesso, quindi deve essere impostata prima dell'apertura della connessione.
Quando il pooling è abilitato, il valore viene segnalato solo durante la creazione di una nuova connessione fisica e non fa parte della chiave del pool. Una connessione servita dal pool segnala quindi l'identità della connessione che ha causato la creazione della connessione fisica e le connessioni fisiche aperte in background per soddisfare Min Pool Size il report Unknown. Le applicazioni che combinano identità su un stringa di connessione devono considerare questi dati di telemetria come indicativi anziché esatti o disabilitare il pool in cui è necessaria un'attribuzione esatta.