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.

Confira também

• Funções canônicas