SqlConnection.RegisteredApplication Свойство

Определение

Пространство имен:: Microsoft.Data.SqlClient

Сборка:: Microsoft.Data.SqlClient.dll

Пакет:: Microsoft.Data.SqlClient v7.1.0

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Важно!

Этот API несовместим с CLS.

Возвращает или задает удостоверение приложения промежуточного слоя, сообщаемое серверу для этого подключения.

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

Значение свойства

RegisteredApplication

Некоторое значение RegisteredApplication. Значение по умолчанию — Unknown.

Атрибуты: CLSCompliantAttribute

Исключения

InvalidOperationException

Подключение открывается или открывается. Удостоверение сообщается во время входа, поэтому его необходимо задать заранее.

Примеры

Задайте удостоверение перед открытием подключения:

using Microsoft.Data.SqlClient;

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

Этот API предназначен для зарегистрированных приложений, которые резервировали идентификатор в RegisteredApplication. Незарегистрированный идентификатор может быть сообщен путем приведения значения к такому типу.

Это значение является телеметрией. Он предоставляется полностью клиентом, который может сообщать о любом идентификаторе в диапазоне, поэтому он не является удостоверением, прошедшим проверку подлинности, и не должен использоваться для авторизации или любого другого решения о безопасности.

Удостоверение отправляется один раз во время входа, поэтому его необходимо задать перед открытием подключения.

Если пул включен, значение сообщается только при установке нового физического подключения, и оно не является частью ключа пула. Таким образом, подключение, обслуживаемое из пула, сообщает об идентификаторе любого подключения, что привело к созданию физического подключения, а физические подключения, открытые в фоновом режиме для удовлетворения Min Pool Size отчета Unknown. Приложения, которые смешивают удостоверения по одной строка подключения должны рассматривать эту телеметрию как показательную, а не точную или отключить пул, где требуется точное присвоение.

Применяется к