Funções de cadeia de caracteres

O Provider de Dados do .NET Framework para SQL Server (SqlClient) fornece String funções que executam operações numa entrada String e retornam um resultado de valor ou 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 construções específicas, como tipos e funções.

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

Função	Descrição
ASCII(expression)	Retorna o valor do 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 de retorno Um Int32. Exemplo SqlServer.ASCII('A')
CHAR(expression)	Converte um Int32 código em uma cadeia de caracteres ASCII. Argumentos expression: Um Int32. Valor de retorno Um ASCII String. 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 serem encontrados. A expressão pode ser de um tipo String (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 String (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 procura de 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 de retorno 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 ASCII ou Unicode String. expression pode ser uma constante, uma variável ou uma coluna. Valor de retorno Retorna um Int32 que representa a diferença entre os valores SOUNDEX de duas expressões de caracteres. O intervalo vai 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 de retorno Unicode ou ASCII String. 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 de retorno Um Int32. Exemplo SqlServer.LEN('abcd')
LOWER(expression)	Retorna uma String expressão depois de converter dados de caracteres maiúsculos em minúsculas. Argumentos expression: Qualquer expressão válida do String tipo. Valor de retorno Um String. Exemplo SqlServer.LOWER('AbB')
LTRIM(expression)	Retorna uma expressão String depois de eliminar os espaços à esquerda. Argumentos expression: Qualquer expressão válida do String tipo. Valor de retorno 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: Um Int32. Valor de retorno Um Unicode String. Exemplo SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression)	Devolve a posição inicial da primeira ocorrência de um padrão numa expressão especificada String . Argumentos '%pattern%': Um tipo ASCII ou Unicode String . Caracteres curinga podem ser usados; no entanto, o % caractere deve vir antes e depois do padrão (exceto em pesquisas por primeiro ou último caractere). expression: Um carácter ASCII ou Unicode String usado para procurar o padrão especificado. Valor de retorno 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 caractere Unicode String. quote_char: Uma cadeia de caracteres de um caractere para usar como delimitador. Pode ser uma aspa simples ( ' ), um colchete esquerdo ou direito ( [ ] ), ou umas aspas duplas ( " ). Se quote_char não for especificado, são utilizados parênteses. Valor de retorno Um Unicode String. 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 Unicode ou ASCII String. expression2:A substring a ser encontrada. expression2 pode ser um tipo Unicode ou ASCII String. expression3; A cadeia de caracteres de substituição. expression3 pode ser um tipo Unicode ou ASCII String. Exemplo SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression)	Repete uma expressão de caractere por um número especificado de vezes. Argumentos char_expression: Um tipo Unicode ou ASCII String . int_expression: Int64 (sem suporte no SQL Server 2000) ou Int32. Valor de retorno Um tipo Unicode ou ASCII String. Exemplo SqlServer.REPLICATE('aa',2)
REVERSE(expression)	Retorna uma cadeia de caracteres Unicode ou ASCII com suas posições de caracteres invertidas da cadeia de caracteres de entrada. Argumentos expression: Um tipo Unicode ou ASCII String . Valor de retorno Um tipo Unicode ou ASCII String. 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 de retorno Um tipo ASCII String . Exemplo SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression)	Retorna uma cadeia de caracteres Unicode ou ASCII depois de remover os espaços finais. Argumentos expression: Um tipo Unicode ou ASCII String . Valor de retorno Um tipo Unicode ou ASCII String. Exemplo SqlServer.RTRIM(' d e ')
SOUNDEX(expression)	Retorna um código de quatro caracteres (SOUNDEX) para avaliar a semelhança de duas cadeias de caracteres. Argumentos expression: Um tipo de cadeia de caracteres Unicode ou ASCII. Valor de retorno Um ASCII String. Um código de quatro caracteres (SOUNDEX) é uma cadeia de caracteres que avalia a semelhança de duas cadeias de caracteres. Exemplo Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1} Devoluções ----- ----- S530 S530
SPACE(int_expression)	Retorna um código ASCII String para 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 de retorno Um ASCII String. Exemplo SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]])	Retorna um ASCII String convertido a partir de dados numéricos. Argumentos float _expression: Uma expressão de tipo de dados numéricos aproximados (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:(opcional) Um Int32 que representa o número de lugares à direita da vírgula decimal. decimal deve ser menor ou igual a 16. Se o decimal for maior que 16, o resultado é truncado para dezasseis posições à direita da vírgula. Valor de retorno Um ASCII String. 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 inicial especificado em uma expressão de cadeia de caracteres. Argumentos str_expression: Um Unicode ou um ASCII String. start: Um Int64 (não retornado no SQL Server 2000) ou Int32 valor que especifica o local para iniciar a exclusão e inserção. length: Um Int64 (não retornado no SQL Server 2000) ou Int32 valor que especifica o número de caracteres a serem excluídos. str_expression_to_insert: Um Unicode ou um ASCII String. Valor de retorno Unicode ou ASCII String. 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 um String tipo (ASCII ou Unicode) ou um Binary tipo. start: Um Int64 (não retornado no SQL Server 2000) ou Int32 que especifica onde a subcadeia de caracteres começa. 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 de retorno 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 caractere Unicode String. Valor de retorno Um Int32. Exemplo SqlServer.UNICODE('a')
UPPER(expression)	Retorna uma String expressão depois de converter dados de caracteres minúsculos em maiúsculas. Argumentos expression: Uma expressão de um tipo de cadeia ASCII ou Unicode. Valor de retorno Um tipo ASCII ou Unicode String. Exemplo SqlServer.UPPER('AbB')

Para obter mais informações sobre as String funções que SqlClient suporta, consulte Funções de cadeia de caracteres (Transact-SQL).

Ver também

• SqlClient para funções do Entity Framework
• Problemas conhecidos no SqlClient para Entity Framework