Compartilhar via

Método setSendStringParametersAsUnicode (SQLServerDataSource)

Baixar o JDBC Driver

Define um valor booliano que indica se o driver envia parâmetros de cadeia de caracteres para o servidor no formato Unicode.

Sintaxe

  
public void setSendStringParametersAsUnicode(boolean sendStringParametersAsUnicode)

Parâmetros

sendStringParametersAsUnicode

true se o driver enviar parâmetros de cadeia de caracteres para o servidor no formato Unicode. Caso contrário, false.

Comentários

Quando a propriedade sendStringParametersAsUnicode é definida como true, que é o valor padrão, o driver envia parâmetros de cadeia de caracteres para o servidor na codificação UTF-16LE (UTF-16 Little Endian), correspondendo ao formato de armazenamento NCHAR/NVARCHAR interno do SQL Server. O driver converte os tipos CHAR, VARCHAR e LONGVARCHAR em NCHAR, NVARCHAR e LONGNVARCHAR, respectivamente, antes de enviá-los para o servidor.

Quando sendStringParametersAsUnicode é definido como false, o driver envia parâmetros de cadeia de caracteres na codificação MBCS (conjunto de caracteres multi bytes) específico da ordenação do banco de dados. A página de código específica usada depende do banco de dados de destino ou da ordenação de colunas. Isso não é ASCII (que é somente de 7 bits), mas sim a codificação de caractere completo definida pela ordenação.

Se você não definir sendStringParametersAsUnicode, getSendStringParametersAsUnicode retornará o valor padrão de true.

Observação

Alterar esse valor pode afetar a classificação dos resultados do banco de dados. As diferenças de classificação se devem a regras de classificação diferentes para caracteres Unicode versus não Unicode. Para colunas VARCHAR/CHAR, definir isso como false evita sobrecarga de conversão implícita no servidor.

Confira mais informações sobre a propriedade de conexão sendStringParametersAsUnicode, confira Como definir as propriedades de conexão. Para obter detalhes sobre o suporte unicode do SQL Server, consulte Ordenação e Suporte unicode.

Conteúdo relacionado

  • Last updated on