Строковые канонические функции
Entity SQL включает строковые канонические функции.
Замечания
В следующей таблице показаны строковые канонические функции Entity SQL.
| Function | Description |
|---|---|
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.