IConnection.SetClientInfo(String, String) 方法

定義

命名空間:

Java.Sql

組件:

Mono.Android.dll

將以名稱指定的客戶端資訊屬性的值設為由 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")]
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

要設定 client info 屬性的值。 若值為空值，則該屬性的當前值將被清除。 <p>

屬性

RegisterAttribute

例外狀況

SQLClientInfoException

如果這個連線已經關閉，或是設定屬性有問題。

備註

將以名稱指定的客戶端資訊屬性的值設為由 value 指定的值。

應用程式可使用此 DatabaseMetaData.getClientInfoProperties 方法來判定驅動程式支援的用戶端資訊屬性，以及每個屬性可指定的最大長度。

驅動程式將指定的值儲存在資料庫中適當的位置。 例如，在特殊暫存器、會話參數或系統表格欄位中。 為了效率，驅動程式可能會延後在資料庫中設定該值，直到下一次執行或準備敘述時再設定。 除了將客戶端資訊存放於資料庫中適當的位置外，這些方法不會以任何方式改變連線的行為。 這些方法所提供的數值僅用於會計、診斷及除錯目的。

若驅動程式未識別用戶端資訊名稱，則應產生警告。

若此方法指定的值大於屬性的最大長度，驅動程式可截斷該值並產生警告，或產生 SQLClientInfoException。 若驅動程式產生 ， SQLClientInfoException該連接未設定該值。

以下是標準客戶資訊屬性。 驅動程式不強制支援這些屬性，但若驅動程式支援的客戶端資訊屬性可用標準屬性描述，則應使用標準屬性名稱。

<ul><li>ApplicationName - 目前使用該連接<的應用程式名稱/li><li>ClientUser - 該應用程式正在執行工作的使用者名稱。 這可能與建立連線時使用的使用者名稱不同。</li><li>客戶主機名稱 - 應用程式使用連線所運行的電腦主機名稱。</li></ul>

新增於1.6版本。

Java 文件 java.sql.Connection.setClientInfo(java.lang.String, java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。