IConnection.SetClientInfo(String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt den Wert der Clientinformationseigenschaft fest, die durch den Namen auf den wert angegebenen Wert angegeben wird.
[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 -> unitParameter
- name
- String
Der Name der festzulegenden Clientinformationseigenschaft
- value
- String
Der Wert, auf den die Clientinformationseigenschaft festgelegt werden soll. Wenn der Wert NULL ist, wird der aktuelle Wert der angegebenen Eigenschaft gelöscht. <p>
- Attribute
Ausnahmen
wenn diese Verbindung geschlossen ist oder beim Festlegen der Eigenschaft ein Problem auftritt.
Hinweise
Legt den Wert der Clientinformationseigenschaft fest, die durch den Namen auf den wert angegebenen Wert angegeben wird.
Anwendungen können die DatabaseMetaData.getClientInfoProperties Methode verwenden, um die vom Treiber unterstützten Clientinformationen und die maximale Länge zu bestimmen, die für jede Eigenschaft angegeben werden kann.
Der Treiber speichert den in einer geeigneten Position in der Datenbank angegebenen Wert. Beispiel: in einer speziellen Register-, Sitzungsparameter- oder Systemtabellenspalte. Aus Effizienzgründen kann der Treiber das Festlegen des Werts in der Datenbank bis zum nächsten Ausführen oder Vorbereiten einer Anweisung verzögern. Abgesehen davon, dass die Clientinformationen an der entsprechenden Stelle in der Datenbank gespeichert werden, werden diese Methoden das Verhalten der Verbindung trotzdem nicht ändern. Die für diese Methoden bereitgestellten Werte werden nur für Buchhaltungs-, Diagnose- und Debuggingzwecke verwendet.
Der Treiber muss eine Warnung generieren, wenn der angegebene Clientinformationsname vom Treiber nicht erkannt wird.
Wenn der für diese Methode angegebene Wert größer als die maximale Länge für die Eigenschaft ist, kann der Treiber den Wert entweder abschneiden und eine Warnung generieren oder eine SQLClientInfoException. Wenn der Treiber einen SQLClientInfoExceptiongeneriert, wurde der angegebene Wert für die Verbindung nicht festgelegt.
Im Folgenden finden Sie standardmäßige Clientinfoeigenschaften. Treiber sind nicht erforderlich, um diese Eigenschaften zu unterstützen, wenn der Treiber jedoch eine Clientinformationseigenschaft unterstützt, die von einer der Standardeigenschaften beschrieben werden kann, sollte der Standardeigenschaftsname verwendet werden.
<ul><li>ApplicationName - Der Name der Anwendung, die derzeit die Verbindung</li ClientUser>><verwendet . Der Name des Benutzers, für den die Anwendung die Verbindung verwendet, funktioniert. Dies entspricht möglicherweise nicht dem Benutzernamen, der beim Herstellen der Verbindung verwendet wurde.</li li><>ClientHostname - Der Hostname des Computers, auf dem die Anwendung mit der Verbindung ausgeführt wird.</li></ul>
In 1.6 hinzugefügt.
Java Dokumentation für java.sql.Connection.setClientInfo(java.lang.String, java.lang.String).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.