IConnection.SetClientInfo(String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la valeur de la propriété d’informations cliente spécifiée par nom sur la valeur spécifiée par valeur.
[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 -> unitParamètres
- name
- String
Nom de la propriété d’informations client à définir
- value
- String
Valeur à laquelle définir la propriété d’informations du client. Si la valeur est null, la valeur actuelle de la propriété spécifiée est effacée. <p>
- Attributs
Exceptions
si cette connexion est fermée ou s’il existe un problème lors de la définition de la propriété.
Remarques
Définit la valeur de la propriété d’informations cliente spécifiée par nom sur la valeur spécifiée par valeur.
Les applications peuvent utiliser la DatabaseMetaData.getClientInfoProperties méthode pour déterminer les propriétés d’informations clientes prises en charge par le pilote et la longueur maximale qui peut être spécifiée pour chaque propriété.
Le pilote stocke la valeur spécifiée dans un emplacement approprié dans la base de données. Par exemple, dans un registre spécial, un paramètre de session ou une colonne de table système. Pour plus d’efficacité, le pilote peut différer la définition de la valeur dans la base de données jusqu’à la prochaine exécution ou préparation d’une instruction. Outre le stockage des informations clientes à l’emplacement approprié dans la base de données, ces méthodes ne modifient pas le comportement de la connexion de toute façon. Les valeurs fournies à ces méthodes sont utilisées uniquement à des fins de comptabilité, de diagnostic et de débogage.
Le pilote génère un avertissement si le nom d’informations du client spécifié n’est pas reconnu par le pilote.
Si la valeur spécifiée à cette méthode est supérieure à la longueur maximale de la propriété, le pilote peut tronquer la valeur et générer un avertissement ou générer un SQLClientInfoException. Si le pilote génère un SQLClientInfoException, la valeur spécifiée n’a pas été définie sur la connexion.
Voici les propriétés d’informations client standard. Les pilotes ne sont pas nécessaires pour prendre en charge ces propriétés. Toutefois, si le pilote prend en charge une propriété d’informations client qui peut être décrite par l’une des propriétés standard, le nom de la propriété standard doit être utilisé.
<ul><li>ApplicationName : nom de l’application qui utilise actuellement la connexion</li><clientUser>- Nom de l’utilisateur pour lequel l’application utilise la connexion fonctionne. Cela peut ne pas être identique au nom d’utilisateur utilisé pour établir la connexion.</li><clientHostname>: nom d’hôte de l’ordinateur sur lequel l’application utilise la connexion.</li></ul>
Ajouté dans la version 1.6.
Java documentation pour java.sql.Connection.setClientInfo(java.lang.String, java.lang.String).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.