Compartilhar via


Funções de cadeia de caracteres

O provedor de dados .NET Framework para SQL Server (SqlClient) fornece funções String que executam operações em um String de entrada e retornam String ou um resultado de valor numérico. Essas funções estão no namespace sqlServer, que está disponível quando você usa SqlClient. A propriedade de namespace de um provedor permite que o Entity Framework descubra qual prefixo é usado por esse provedor para constructos específicos, como tipos e funções.

A tabela a seguir mostra as funções sqlClient String .

Função Descrição
ASCII(expression) Retorna o valor de código ASCII do caractere mais à esquerda de uma expressão de cadeia de caracteres.

argumentos

expression: qualquer expressão válida de um tipo ASCII String .

valor retornado

Um Int32.

Exemplo

SqlServer.ASCII('A')
CHAR(expression) Converte um Int32 código em uma cadeia de caracteres ASCII.

argumentos

expression: uma Int32.

valor retornado

Um String ASCII.

Exemplo

SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location]) Retorna a posição inicial da expressão especificada em uma cadeia de caracteres.

argumentos

expression1: uma expressão que contém a sequência de caracteres a ser encontrada. A expressão pode ser de um tipo de cadeia de caracteres (ASCII ou Unicode) ou de um tipo binário.

expression2: uma expressão, normalmente uma coluna, a ser pesquisada para a sequência especificada. A expressão pode ser de um tipo de cadeia de caracteres (ASCII ou Unicode) ou de um tipo binário.

start_location:(Opcional) Um Int64 (não retornado no SQL Server 2000) ou Int32 que representa a posição do caractere para iniciar a pesquisa por expression1 em expression2. Se start_location não for especificado, for um número negativo ou for zero, a pesquisa começará no início da expressão2.

valor retornado

Um Int32.

Exemplo

SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression) Compara os SOUNDEX valores de duas cadeias de caracteres e avalia a semelhança entre elas.

argumentos

Um tipo String ASCII ou Unicode. expression pode ser uma constante, uma variável ou uma coluna.

valor retornado

Retorna um Int32 que representa a diferença entre os valores SOUNDEX de duas expressões de caractere. O intervalo é de 0 a 4. 0 indica uma semelhança fraca ou nenhuma semelhança e 4 indica uma semelhança forte ou os mesmos valores.

Exemplo

// The following example returns a DIFFERENCE value of 4,

//the least possible difference or the best match.

SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count) Retorna a parte esquerda de uma cadeia de caracteres com o número especificado de caracteres.

argumentos

expression: um tipo de cadeia de caracteres Unicode ou ASCII. Use a função CAST para converter explicitamente character_expression.

count: um Int64 (não retornado no SQL Server 2000) ou Int32 tipo que especifica quantos caracteres de character_expression serão retornados.

valor retornado

Um String Unicode ou ASCII.

Exemplo

SqlServer.LEFT('SQL Server', 4)
LEN(expression) Retorna o número de caracteres na expressão String especificada, excluindo espaços em branco à direita.

argumentos

expression: uma expressão de um String tipo (Unicode ou ASCII) ou um Binary tipo

valor retornado

Um Int32.

Exemplo

SqlServer.LEN('abcd')
LOWER(expression) Retorna uma expressão String depois de converter caracteres maiúsculos em minúsculos.

argumentos

expression: qualquer expressão válida do String tipo.

valor retornado

Um String.

Exemplo

SqlServer.LOWER('AbB')
LTRIM(expression) Retorna uma expressão de String após remover os espaços à esquerda.

argumentos

expression: qualquer expressão válida do String tipo.

valor retornado

Um String.

Exemplo

SqlServer.LTRIM(' d')
NCHAR(expression) Retorna um Unicode String com o código inteiro especificado, conforme definido pelo padrão Unicode.

argumentos

expression: uma Int32.

valor retornado

Um String Unicode.

Exemplo

SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression) Retorna a posição inicial da primeira ocorrência de um padrão em uma expressão especificada String .

argumentos

'%pattern%': Um tipo ASCII ou Unicode String. Os caracteres curinga podem ser usados; no entanto, o caractere % deve vir antes e após o padrão (exceto em pesquisas para primeiro ou último caracteres).

expression: um caractere ASCII ou Unicode String para buscar o padrão especificado.

valor retornado

Um Int32.

Exemplo

SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char']) Retorna um Unicode String com os delimitadores adicionados para tornar a cadeia de caracteres de entrada um identificador delimitado válido do SQL Server 2005.

argumentos

char_string: um StringUnicode.

quote_char: uma cadeia de caracteres de um caractere a ser usada como delimitador. Pode ser aspas simples ( ' ), um colchete esquerdo ou direito ( [ ] ) ou aspas duplas ( " ). Se quote_char não for especificado, os colchetes serão usados.

valor retornado

Um String Unicode.

Exemplo

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) Substitui uma expressão de caractere por outra expressão de caractere.

argumentos

expression1: a expressão de cadeia de caracteres a ser pesquisada. expression1 pode ser um tipo de cadeia de caracteres Unicode ou ASCII.

expression2: a substring a ser encontrada. expression2 pode ser um tipo de cadeia de caracteres Unicode ou ASCII.

expression3; A Cadeia de caracteres de substituição. expression3 pode ser um tipo de cadeia de caracteres Unicode ou ASCII.

Exemplo

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) Repete uma expressão de caractere para um número especificado de vezes.

argumentos

char_expression: um tipo de String Unicode ou ASCII.

int_expression: Int64 (sem suporte no SQL Server 2000) ou Int32.

valor retornado

Um tipo de String Unicode ou ASCII.

Exemplo

SqlServer.REPLICATE('aa',2)
REVERSE(expression) Retorna uma cadeia de caracteres Unicode ou ASCII com suas posições de caractere invertidas da cadeia de caracteres de entrada.

argumentos

expression: um tipo de String Unicode ou ASCII.

valor retornado

Um tipo de String Unicode ou ASCII.

Exemplo

SqlServer.REVERSE('abcd')
RIGHT(char_expression, count) Retorna a parte direita de uma cadeia de caracteres com o número especificado de caracteres.

argumentos

char_expression:Um tipo de cadeia de caracteres Unicode ou ASCII. Use a função CAST para converter explicitamente character_expression.

count: um Int64 (não retornado no SQL Server 2000) ou Int32 tipo que especifica quantos caracteres de character_expression serão retornados.

valor retornado

Um tipo String ASCII.

Exemplo

SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression) Retorna uma cadeia de caracteres Unicode ou ASCII após remover os espaços à direita.

argumentos

expression: um tipo de String Unicode ou ASCII.

valor retornado

Um tipo de String Unicode ou ASCII.

Exemplo

SqlServer.RTRIM(' d e ')
SOUNDEX(expression) Retorna um código SOUNDEX (quatro caracteres) para avaliar a similaridade de duas cadeias de caracteres. Argumentos

expression: um tipo de cadeia de caracteres Unicode ou ASCII.

valor retornado

Um String ASCII. Um código SOUNDEX (quatro caracteres) é uma cadeia de caracteres que avalia a similaridade de duas cadeias de caracteres.

Exemplo

Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1}

Retorna

----- ----- S530 S530
SPACE(int_expression) Retorna um String ASCII de espaços repetidos.

argumentos

int_expression: um Int64 (não retornado no SQL Server 2000) ou Int32 que indica o número de espaços.

valor retornado

Um String ASCII.

Exemplo

SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]]) Retorna um String ASCII convertido de dados numéricos.

argumentos

float _expression: uma expressão de tipo de dados numérico aproximado (Double) com um ponto decimal.

length: (opcional) Um Int32 que representa o comprimento total. Isso inclui ponto decimal, sinal, dígitos e espaços. O padrão é 10.

decimal:(optional) Um Int32 que representa o número de locais à direita do ponto decimal. decimal deve ser menor que ou igual a 16. Se o decimal é mais que 16, o resultado será truncado a dezesseis locais à direita do ponto decimal.

valor retornado

Um String ASCII.

Exemplo

SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert) Exclui um comprimento especificado de caracteres e insere outro conjunto de caracteres em um ponto de partida especificado em uma expressão de cadeia de caracteres.

argumentos

str_expression: Um caractere Unicode ou ASCII String.

start: Um Int64 valor (não retornado no SQL Server 2000) ou Int32 que especifica o local para iniciar a exclusão e a inserção.

length: um Int64 valor (não retornado no SQL Server 2000) ou Int32 que especifica o número de caracteres a serem excluídos.

str_expression_to_insert: Um caractere Unicode ou ASCII String.

valor retornado

Um String Unicode ou ASCII.

Exemplo

SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length) Retorna parte de uma String expressão.

argumentos

str_expression: uma expressão de tipo String (ASCII ou Unicode) ou Binary.

start: um Int64 (não retornado no SQL Server 2000) ou Int32 que especifica onde a subcadeia de caracteres é iniciada. 1 refere-se ao primeiro caractere na cadeia de caracteres.

length: um Int64 (não retornado no SQL Server 2000) ou Int32 que especifica quantos caracteres da expressão serão retornados.

valor retornado

Um String tipo (ASCII ou Unicode) ou um Binary tipo.

Exemplo

SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression) Retorna o valor inteiro, conforme definido pelo padrão Unicode, para o primeiro caractere da expressão de entrada.

argumentos

expression: um StringUnicode.

valor retornado

Um Int32.

Exemplo

SqlServer.UNICODE('a')
UPPER(expression) Retorna uma expressão String após converter dados de caracteres em letras minúsculas para letras maiúsculas.

argumentos

expression: uma expressão de um tipo ascii ou de cadeia de caracteres Unicode.

valor retornado

Um tipo String ASCII ou Unicode.

Exemplo

SqlServer.UPPER('AbB')

Para obter mais informações sobre as String funções compatíveis com o SqlClient, consulte String Functions (Transact-SQL).

Consulte também