Строковые канонические функции

Entity SQL включает строковые канонические функции.

Замечания

В следующей таблице показаны строковые канонические функции Entity SQL.

Функция	Описание
Concat(string1, string2)	Возвращает строку, содержащую строку string2, добавленную к строке string1. Аргументы string1: строка, к которой добавляется string2. string2: строка, которая добавляется к string1. Возвращаемое значение String. Если длина строки возвращаемого значения больше максимально допустимой длины, произойдет ошибка. Пример -- The following example returns abcxyz. Concat('abc', 'xyz')
Contains(string, target)	Возвращает значение true, если target содержится в string. Аргументы string: строка, в которой выполняется поиск. target: искомая строка. Возвращаемое значение true, если target содержится в string; в противном случае false. Пример -- The following example returns true. Contains('abc', 'bc')
EndsWith(string, target)	Возвращает значение true, если target заканчивается на string. Аргументы string: строка, в которой выполняется поиск. target: целевая строка, поиск которой ведется в конце string. Возвращаемое значение Значение True, если string заканчивается на target. В противном случае - значение false. Пример -- The following example returns true. EndsWith('abc', 'bc') Заметка: Если вы используете поставщик данных SQL Server, эта функция возвращаетсяfalse, если строка хранится в столбце строки фиксированной длины и target является константой. В данном случае производится поиск по всей строке, включая конечные пробелы. Данную проблему можно обойти, усекая данные в строке с фиксированной длиной, как это показано в следующем примере: EndsWith(TRIM(string), target)
IndexOf(target, string)	Возвращает позицию target в string, или 0, если не найдено. Возвращает значение 1, указывая на начало string. Нумерация позиций начинается со значения 1. Аргументы target: искомая строка. string: строка, в которой выполняется поиск. Возвращаемое значение Объект Int32. Пример -- The following example returns 4. IndexOf('xyz', 'abcxyz')
Left(string, length)	Возвращает первые символы length с левой стороны string. Если длина string меньше, чем length, возвращается вся строка. Аргументы string — значение в формате String. length: значение типа Int16, Int32, Int64 или Byte. Параметр length не может иметь значение меньше нуля. Возвращаемое значение String. Пример -- The following example returns abc. Left('abcxyz', 3)
Length(string)	Возвращает (Int32) длину строки в символах. Аргументы string — значение в формате String. Возвращаемое значение Объект Int32. Пример -- The following example returns 6. Length('abcxyz')
LTrim(string)	Возвращает string без начального пробела. Аргументы String. Возвращаемое значение String. Пример -- The following example returns abc. LTrim(' abc')
Replace(string1, string2, string3)	Возвращает string1, где все вхождения string2 заменены на string3. Аргументы String. Возвращаемое значение String. Пример -- The following example returns abcxyz. Concat('abc', 'xyz')
Reverse(string)	Возвращает string с обратным порядком символов. Аргументы String. Возвращаемое значение String. Пример -- The following example returns dcba. Reverse('abcd')
Right(string, length)	Возвращает последние length символы из string. Если длина string меньше, чем length, возвращается вся строка. Аргументы string — значение в формате String. length: значение типа Int16, Int32, Int64 или Byte. Параметр length не может иметь значение меньше нуля. Возвращаемое значение String. Пример -- The following example returns xyz. Right('abcxyz', 3)
RTrim(string)	Возвращается string без пробела. Аргументы String. Возвращаемое значение String.
Substring(string, start, length)	Возвращает для строки подстроку, начинающуюся на позиции start и длиной length символов. Значение аргумента start, равное 1, определяет первый символ строки. Нумерация позиций начинается со значения 1. Аргументы string — значение в формате String. start: Int16, Int32, Int64 и Byte. Параметр start не может иметь значение меньше единицы. length: Int16, Int32, Int64 и Byte. Параметр length не может иметь значение меньше нуля. Возвращаемое значение String. Пример -- The following example returns xyz. Substring('abcxyz', 4, 3)
StartsWith(string, target)	Возвращает значение true, если string начинается с target. Аргументы string: строка, в которой выполняется поиск. target: целевая строка, поиск которой ведется в начале string. Возвращаемое значение Значение True, если string начинается с target. В противном случае - значение false. Пример -- The following example returns true. StartsWith('abc', 'ab')
ToLower(string)	Возвращает string с прописными буквами, преобразованными в символы нижнего регистра. Аргументы String. Возвращаемое значение Это String. Пример -- The following example returns abc. ToLower('ABC')
ToUpper(string)	Возвращает string с символами нижнего регистра, преобразованными в прописные буквы. Аргументы String. Возвращаемое значение String. Пример -- The following example returns ABC. ToUpper('abc')
Trim(string)	Возвращает string без начальных и конечных пробелов. Аргументы String. Возвращаемое значение String. Пример -- The following example returns abc. Trim(' abc ')

Эти функции возвращают null при получении на входе null.

Эквивалентную функциональность предоставляет управляемый поставщик клиента Microsoft SQL. Дополнительные сведения см. в разделе SqlClient для функций Entity Framework.

См. также

• Канонические функции