Funções canônicas de cadeia de caracteres
O Entity SQL inclui funções canônicas de cadeia de caracteres.
Observações
A tabela a seguir mostra as funções canônicas Entity SQL de cadeia de caracteres.
| Function | Description |
|---|---|
Concat(string1, string2) |
Retorna uma cadeia de caracteres que contém string2 anexado a string1.Argumentos string1: A cadeia de caracteres à qual string2 é acrescentado.string2: A cadeia de caracteres que é acrescentada a string1.Valor de retorno A String. Ocorrerá um erro se o comprimento da cadeia de caracteres do valor de retorno for maior do que o comprimento máximo permitido.Exemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Contains(string, target) |
Devolve true se target estiver contido em string.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino que é pesquisada.Valor de retorno true se target estiver contido em string; caso contrário false.Exemplo -- The following example returns true.Contains('abc', 'bc') |
EndsWith(string, target) |
Retorna true se target terminar com string.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino pesquisada no final de string.Valor de retorno True se string termina com target; caso contrário false.Exemplo -- The following example returns true.EndsWith('abc', 'bc')Observação: Se você estiver usando o provedor de dados do SQL Server, essa função retornará false se a cadeia de caracteres estiver armazenada em uma coluna de cadeia de caracteres de comprimento fixo e target for uma constante. Nesse caso, toda a cadeia de caracteres é pesquisada, incluindo quaisquer espaços à direita de preenchimento. Uma solução possível é cortar os dados na cadeia de caracteres de comprimento fixo, como no exemplo a seguir: EndsWith(TRIM(string), target) |
IndexOf(target, string) |
Devolve a posição de dentro stringde target , ou 0 se não for encontrado. Retorna 1 para indicar o início de string. A numeração do índice começa a partir de 1.Argumentos target: A cadeia de caracteres que é pesquisada.string: A cadeia de caracteres que é pesquisada.Valor de retorno Um Int32.Exemplo -- The following example returns 4.IndexOf('xyz', 'abcxyz') |
Left(string, length) |
Retorna os primeiros length caracteres do lado esquerdo do string. Se o comprimento de for menor que length, toda a cadeia de string caracteres será retornada.Argumentos string: A String.length: An Int16, Int32, Int64, ou Byte. length não pode ser inferior a zero.Valor de retorno A String.Exemplo -- The following example returns abc.Left('abcxyz', 3) |
Length(string) |
Devolve o comprimento (Int32), em carateres, da cadeia de caracteres.Argumentos string: A String.Valor de retorno Um Int32.Exemplo -- The following example returns 6.Length('abcxyz') |
LTrim(string) |
Retorna string sem espaço em branco à esquerda.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns abc.LTrim(' abc') |
Replace(string1, string2, string3) |
Devolve string1, com todas as ocorrências de substituídas string2 por string3.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Reverse(string) |
Retorna string com a ordem dos caracteres invertida.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns dcba.Reverse('abcd') |
Right(string, length) |
Retorna os últimos length caracteres do stringarquivo . Se o comprimento de for menor que length, toda a cadeia de string caracteres será retornada.Argumentos string: A String.length: An Int16, Int32, Int64, ou Byte. length não pode ser inferior a zero.Valor de retorno A String.Exemplo -- The following example returns xyz.Right('abcxyz', 3) |
RTrim(string) |
Retorna string sem espaço em branco à direita.Argumentos A String.Valor de retorno A String. |
Substring(string, start, length) |
Retorna a substring da cadeia de caracteres começando na posição start, com um comprimento de length caracteres. Um início de 1 indica o primeiro caractere da cadeia de caracteres. A numeração do índice começa a partir de 1.Argumentos string: A String.start: An Int16, Int32, Int64 e Byte. start não pode ser inferior a um.length: An Int16, Int32, Int64 e Byte. length não pode ser inferior a zero.Valor de retorno A String.Exemplo -- The following example returns xyz.Substring('abcxyz', 4, 3) |
StartsWith(string, target) |
Retorna true se string começar com target.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino pesquisada no início do string.Valor de retorno True se string começa com target; caso contrário false.Exemplo -- The following example returns true.StartsWith('abc', 'ab') |
ToLower(string) |
Retorna string com caracteres maiúsculos convertidos em minúsculas.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns abc.ToLower('ABC') |
ToUpper(string) |
Retorna string com caracteres minúsculos convertidos em maiúsculas.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns ABC.ToUpper('abc') |
Trim(string) |
Retorna string sem espaço em branco à esquerda e à direita.Argumentos A String.Valor de retorno A String.Exemplo -- The following example returns abc.Trim(' abc ') |
Essas funções retornarão null se a entrada for dada null .
Funcionalidade equivalente está disponível no Microsoft SQL Client Managed Provider. Para obter mais informações, consulte SqlClient for Entity Framework Functions.