IConnection.SetClientInfo(String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece el valor de la propiedad de información de cliente especificada por nombre en el valor especificado por 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 -> unitParámetros
- name
- String
Nombre de la propiedad de información de cliente que se va a establecer
- value
- String
Valor en el que se va a establecer la propiedad de información de cliente. Si el valor es NULL, se borra el valor actual de la propiedad especificada. <p>
- Atributos
Excepciones
si se cierra esta conexión o hay un problema al establecer la propiedad .
Comentarios
Establece el valor de la propiedad de información de cliente especificada por nombre en el valor especificado por value.
Las aplicaciones pueden usar el DatabaseMetaData.getClientInfoProperties método para determinar las propiedades de información de cliente admitidas por el controlador y la longitud máxima que se puede especificar para cada propiedad.
El controlador almacena el valor especificado en una ubicación adecuada en la base de datos. Por ejemplo, en una columna de registro especial, parámetro de sesión o tabla del sistema. Para mejorar la eficacia, el controlador puede aplazar la configuración del valor en la base de datos hasta la próxima vez que se ejecute o prepare una instrucción. Aparte de almacenar la información del cliente en el lugar adecuado en la base de datos, estos métodos no modificarán el comportamiento de la conexión de todos modos. Los valores proporcionados a estos métodos se usan únicamente con fines de contabilidad, diagnóstico y depuración.
El controlador generará una advertencia si el controlador no reconoce el nombre de información de cliente especificado.
Si el valor especificado para este método es mayor que la longitud máxima de la propiedad, el controlador puede truncar el valor y generar una advertencia o generar un SQLClientInfoException. Si el controlador genera un SQLClientInfoException, el valor especificado no se estableció en la conexión.
A continuación se muestran las propiedades de información de cliente estándar. Los controladores no son necesarios para admitir estas propiedades, pero si el controlador admite una propiedad de información de cliente que se puede describir mediante una de las propiedades estándar, se debe usar el nombre de la propiedad estándar.
<ul><li>ApplicationName: el nombre de la aplicación que usa actualmente connection</li><>ClientUser: el nombre del usuario para el que la aplicación usa la conexión funciona. Esto puede no ser el mismo que el nombre de usuario que se usó para establecer la conexión.</li clientHostname>><: el nombre de host del equipo en el que se ejecuta la conexión la aplicación.</li></ul>
Agregado en la versión 1.6.
Java documentación para java.sql.Connection.setClientInfo(java.lang.String, java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.