Funções canônicas de cadeias de caracteres
O Entity SQL inclui funções canônicas de cadeias de caracteres.
Comentários
A tabela a seguir mostra as funções canônicas de cadeias de caracteres do Entity SQL.
| Função | Descrição |
|---|---|
Concat(string1, string2) |
Retorna uma cadeia de caracteres que contém string2 acrescentado a string1.Argumentos string1: A cadeia de caracteres a string2 que é acrescentado.string2: A cadeia de caracteres que é acrescentada a string1.Valor Retornado Uma String. Um erro ocorrerá se o comprimento da cadeia de caracteres do valor de retorno é maior do que o comprimento máximo permitido.Exemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Contains(string, target) |
Retorna true se target está contido em string.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino por que é procurada.Valor Retornado true se target está contido em string; se não false.Exemplo -- The following example returns true.Contains('abc', 'bc') |
EndsWith(string, target) |
Retorna true se target termina com string.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino procurarou no final de string.Valor Retornado True se string termina com target; se não 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 retorna false se a cadeia de caracteres estiver armazenada em uma coluna de cadeia de caracteres de tamanho fixo e target for uma constante. Nesse caso, a cadeia de caracteres inteira é pesquisada, incluindo todos os espaço à direita de preenchimento. Uma solução alternativa é possível quebrar dados a cadeia de caracteres fixa comprimento, como no exemplo a seguir: EndsWith(TRIM(string), target) |
IndexOf(target, string) |
Retorna a posição de target dentro de string0, ou se não foi encontrado. Retorna 1 para indicar o início de string. A numeração de índice parte de 1.Argumentos target: A cadeia de caracteres por que é procurada.string: A cadeia de caracteres que é pesquisada.Valor Retornado Um Int32.Exemplo -- The following example returns 4.IndexOf('xyz', 'abcxyz') |
Left(string, length) |
Retorna o primeiro caracteres de length do lado esquerdo de string. Se o comprimento de string é menor que length, a cadeia de caracteres inteira é retornada.Argumentos string: um String.length: um Int16, Int32, Int64 ou Byte. length não pode ser menor que zero.Valor Retornado Uma String.Exemplo -- The following example returns abc.Left('abcxyz', 3) |
Length(string) |
Retorna o tamanho (deInt32), em caracteres, a cadeia de caracteres.Argumentos string: um String.Valor Retornado Um Int32.Exemplo -- The following example returns 6.Length('abcxyz') |
LTrim(string) |
Retorna string sem espaço em branco à esquerda.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns abc.LTrim(' abc') |
Replace(string1, string2, string3) |
Retorna string1, com todas as ocorrências de string2 substituiu por string3.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Reverse(string) |
Retorna string com a ordem dos caracteres revertidas.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns dcba.Reverse('abcd') |
Right(string, length) |
Retorna os últimos caracteres length de string. Se o comprimento de string é menor que length, a cadeia de caracteres inteira é retornada.Argumentos string: um String.length: um Int16, Int32, Int64 ou Byte. length não pode ser menor que zero.Valor Retornado Uma String.Exemplo -- The following example returns xyz.Right('abcxyz', 3) |
RTrim(string) |
Retorna string sem espaço em branco à direita.Argumentos Uma String.Valor Retornado Uma String. |
Substring(string, start, length) |
Retorna a subcadeia de caracteres de cadeia de caracteres começando na posição start, com um comprimento de caracteres de length . Um início de 1 indica o primeiro caractere da cadeia de caracteres. A numeração de índice parte de 1.Argumentos string: um String.start: Int16, Int32, Int64 e Byte. start não pode ser menor que um.length: Int16, Int32, Int64 e Byte. length não pode ser menor que zero.Valor Retornado Uma String.Exemplo -- The following example returns xyz.Substring('abcxyz', 4, 3) |
StartsWith(string, target) |
Retorna true se inicia de string com target.Argumentos string: A cadeia de caracteres que é pesquisada.target: A cadeia de caracteres de destino pesquisada no início de string.Valor Retornado True se inicia de string com target; se não false.Exemplo -- The following example returns true.StartsWith('abc', 'ab') |
ToLower(string) |
Retorna string com os caracteres maiúsculas convertidos em minúsculas.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns abc.ToLower('ABC') |
ToUpper(string) |
Retorna string com os caracteres em minúsculas convertidos para maiúsculas.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns ABC.ToUpper('abc') |
Trim(string) |
Retorna string sem espaço em branco à esquerda e à direita.Argumentos Uma String.Valor Retornado Uma String.Exemplo -- The following example returns abc.Trim(' abc ') |
Essas funções retornará null se entrada dada de null .
Funcionalidade equivalente está disponível no provedor gerenciado cliente do Microsoft SQL. Para obter mais informações, consulte SqlClient para funções do Entity Framework.