Partager via


Méthode setSendStringParametersAsUnicode (SQLServerDataSource)

Télécharger le pilote JDBC

Définit une valeur booléenne qui indique si le pilote envoie des paramètres de chaîne au serveur au format Unicode.

Syntaxe

  
public void setSendStringParametersAsUnicode(boolean sendStringParametersAsUnicode)  

Paramètres

sendStringParametersAsUnicode

true si le pilote envoie des paramètres de chaîne au serveur au format Unicode. Dans le cas contraire, la valeur est false.

Notes

Lorsque la propriété sendStringParametersAsUnicode a la valeur true, qui est la valeur par défaut, le pilote envoie des paramètres de chaîne au serveur dans l’encodage UTF-16LE (UTF-16 Little Endian) correspondant au format de stockage NCHAR/NVARCHAR interne de SQL Server. Le pilote convertit les types CHAR, VARCHAR et LONGVARCHAR en NCHAR, NVARCHAR et LONGNVARCHAR respectivement avant de les envoyer au serveur.

Lorsque sendStringParametersAsUnicode a la valeur false, le pilote envoie des paramètres de chaîne dans l’encodage MBCS (Jeu de caractères multioctets) spécifique au classement de la base de données. La page de codes spécifique utilisée dépend du classement de base de données ou de colonne cible. Ce n’est pas ASCII (qui est 7 bits uniquement), mais plutôt l’encodage de caractères complet défini par le classement.

Si vous ne définissez pas sendStringParametersAsUnicode, getSendStringParametersAsUnicode retourne la valeur par défaut true.

Note

La modification de cette valeur peut affecter le tri des résultats de la base de données. Les différences de tri sont dues à différentes règles de tri pour les caractères Unicode et non Unicode. Pour les colonnes VARCHAR/CHAR, la définition de cette valeur sur false évite la surcharge de conversion implicite sur le serveur.

Pour plus d'informations sur la propriété de connexion sendStringParametersAsUnicode, consultez Définir les propriétés de connexion. Pour plus d’informations sur la prise en charge Unicode de SQL Server, consultez Classement et Prise en charge Unicode.