Funções de Cadeia
O Provedor de Dados do .NET Framework para SQL Server (SqlClient) fornece String funções que executam operações em uma entrada String e retornam um resultado de String valor numérico 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 .
| Function | Description |
|---|---|
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 começar a procurar 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 Um 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 tipoValor 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 A String.Exemplo SqlServer.LOWER('AbB') |
LTRIM(expression) |
Retorna uma String expressão depois de remover espaços à esquerda.Argumentos expression: Qualquer expressão válida do String tipo.Valor de retorno A 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 caracteres).expression: Um ASCII ou Unicode String 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 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 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 um Unicode ou ASCII String depois de remover espaços à direita. 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.Argumentosexpression: 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 ASCII String 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 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 decimal for superior a 16, o resultado é truncado para dezasseis posições à direita da vírgula decimal.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 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 ASCII String.Valor de retorno Um 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 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 ASCII ou Unicode String.Valor de retorno Um tipo ASCII ou Unicode String .Exemplo SqlServer.UPPER('AbB') |
Para obter mais informações sobre as funções suportadas String por SqlClient, consulte Funções de cadeia de caracteres (Transact-SQL).