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)。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

适用于