Строковые канонические функции (язык Entity SQL)

Язык 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. Legth('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. Дополнительные сведения см. в разделе Функции поставщика данных .NET Framework для SQL Server (SqlClient) на платформе Entity Framework.

См. также

Основные понятия

Канонические функции (язык Entity SQL)