IConnection.SetClientInfo(String, String) Метод

Определение

Пространство имен:: Java.Sql

Сборка:: Mono.Android.dll

Важно!

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

Задает значение свойства сведений клиента, указанное именем, значением, указанным значением.

[Android.Runtime.Register("setClientInfo", "(Ljava/lang/String;Ljava/lang/String;)V", "GetSetClientInfo_Ljava_lang_String_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void SetClientInfo(string? name, string? value);

[<Android.Runtime.Register("setClientInfo", "(Ljava/lang/String;Ljava/lang/String;)V", "GetSetClientInfo_Ljava_lang_String_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member SetClientInfo : string * string -> unit

Параметры

name: String

Имя свойства сведений клиента для задания

value: String

Значение для задания свойства сведений о клиенте. Если значение равно NULL, то текущее значение указанного свойства очищается. <p>

Атрибуты: RegisterAttribute

Исключения

SQLClientInfoException

Значение

Приложения могут использовать DatabaseMetaData.getClientInfoProperties метод для определения свойств сведений клиента, поддерживаемых драйвером, и максимальной длины, которая может быть указана для каждого свойства.

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

Драйвер должен создать предупреждение, если указанное имя сведений клиента не распознается драйвером.

Если значение, указанное для этого метода, больше максимальной длины для свойства, драйвер может усечь значение и создать предупреждение или создать SQLClientInfoException. Если драйвер создает SQLClientInfoExceptionобъект, указанное значение не было задано в соединении.

Ниже приведены стандартные свойства сведений о клиенте. Драйверы не требуют поддержки этих свойств, однако если драйвер поддерживает свойство сведений клиента, которое можно описать одним из стандартных свойств, следует использовать стандартное имя свойства.

<ul>li ApplicationName — имя приложения, в настоящее время использующее connection</li<>>clientUser — имя пользователя, на которое выполняется подключение.>< Это может быть не так же, как имя пользователя, которое использовалось при установке соединения.</li><>ClientHostname — имя узла компьютера, в котором используется подключение.</li></ul>

Добавлено в версии 1.6.

Java документации по java.sql.Connection.setClientInfo(java.lang.String, java.lang.String).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

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