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 - 現在接続を利用しているアプリケーションの名前</li><li>ClientUser - 接続を使用するアプリケーションが処理を実行しているユーザーの名前。 これは、connection.< の確立に使用されたユーザー名と同じではない可能性があります。/li><li>ClientHostname - 接続を使用するアプリケーションが実行されているコンピューターのホスト名</li></ul>

1.6 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。