Bagikan melalui


Metode setSendStringParametersAsUnicode (SQLServerDataSource)

Unduh driver JDBC

Mengatur nilai boolean yang menunjukkan apakah driver mengirim parameter string ke server dalam format Unicode.

Sintaks

  
public void setSendStringParametersAsUnicode(boolean sendStringParametersAsUnicode)  

Parameter

sendStringParametersAsUnicode

true jika driver mengirim parameter string ke server dalam format Unicode. Jika tidak, salah.

Keterangan

Ketika properti sendStringParametersAsUnicode diatur ke true, yang merupakan nilai default, driver mengirim parameter string ke server dalam pengodean UTF-16LE (UTF-16 Little Endian), yang cocok dengan format penyimpanan NCHAR/NVARCHAR internal SQL Server. Driver mengonversi jenis CHAR, VARCHAR, dan LONGVARCHAR ke NCHAR, NVARCHAR, dan LONGNVARCHAR masing-masing sebelum mengirimkannya ke server.

Saat sendStringParametersAsUnicode diatur ke false, driver mengirim parameter string dalam pengodean MBCS (Set Karakter Multi-Byte) khusus kolase database. Halaman kode tertentu yang digunakan bergantung pada database target atau kolatasi kolom. Ini bukan ASCII (yang hanya 7-bit), melainkan pengodean karakter lengkap yang ditentukan oleh kolase.

Jika Anda tidak mengatur sendStringParametersAsUnicode, getSendStringParametersAsUnicode mengembalikan nilai default true.

Nota

Mengubah nilai ini dapat memengaruhi pengurutan hasil dari database. Perbedaan pengurutan disebabkan oleh aturan pengurutan yang berbeda untuk karakter Unicode versus karakter non-Unicode. Untuk kolom VARCHAR/CHAR, mengatur ini ke false menghindari overhead konversi implisit di server.

Untuk informasi selengkapnya tentang properti koneksi sendStringParametersAsUnicode, lihat Mengatur Properti Koneksi. Untuk detail tentang dukungan Unicode SQL Server, lihat Dukungan Kolase dan Unicode.