IConnection.SetClientInfo(String, String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengatur nilai properti info klien yang ditentukan berdasarkan nama ke nilai yang ditentukan oleh nilai.
[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
Nama properti info klien yang akan diatur
- value
- String
Nilai untuk mengatur properti info klien ke. Jika nilai null, nilai saat ini dari properti yang ditentukan akan dihapus. <p>
- Atribut
Pengecualian
jika koneksi ini ditutup, atau ada masalah saat mengatur properti.
Keterangan
Mengatur nilai properti info klien yang ditentukan berdasarkan nama ke nilai yang ditentukan oleh nilai.
Aplikasi dapat menggunakan DatabaseMetaData.getClientInfoProperties metode untuk menentukan properti info klien yang didukung oleh driver dan panjang maksimum yang mungkin ditentukan untuk setiap properti.
Driver menyimpan nilai yang ditentukan di lokasi yang sesuai dalam database. Misalnya dalam daftar khusus, parameter sesi, atau kolom tabel sistem. Untuk efisiensi, driver dapat menunda pengaturan nilai dalam database hingga kali berikutnya pernyataan dijalankan atau disiapkan. Selain menyimpan informasi klien di tempat yang sesuai dalam database, metode ini tidak akan mengubah perilaku koneksi. Nilai yang disediakan untuk metode ini hanya digunakan untuk tujuan akuntansi, diagnostik, dan penelusuran kesalahan.
Driver akan menghasilkan peringatan jika nama info klien yang ditentukan tidak dikenali oleh driver.
Jika nilai yang ditentukan untuk metode ini lebih besar dari panjang maksimum untuk properti driver dapat memotong nilai dan menghasilkan peringatan atau menghasilkan SQLClientInfoException. Jika driver menghasilkan SQLClientInfoException, nilai yang ditentukan tidak diatur pada koneksi.
Berikut ini adalah properti info klien standar. Driver tidak diperlukan untuk mendukung properti ini namun jika driver mendukung properti info klien yang dapat dijelaskan oleh salah satu properti standar, nama properti standar harus digunakan.
<ul><li>ApplicationName - Nama aplikasi yang saat ini menggunakan koneksi</li li><>ClientUser - Nama pengguna tempat aplikasi menggunakan koneksi melakukan pekerjaan. Ini mungkin tidak sama dengan nama pengguna yang digunakan dalam membuat koneksi.</li li><>ClientHostname - Nama host komputer tempat aplikasi menggunakan koneksi berjalan.</li></ul>
Ditambahkan dalam 1.6.
Java dokumentasi untuk java.sql.Connection.setClientInfo(java.lang.String, java.lang.String).
Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.