Funkcje ciągów Canonical
Język Entity SQL zawiera funkcje kanoniczne ciągów.
Uwagi
W poniższej tabeli przedstawiono ciąg Funkcje kanoniczne Entity SQL.
| Function | opis |
|---|---|
Concat(string1, string2) |
Zwraca ciąg, który zawiera string2 ciąg dołączony do .string1Argumenty string1: ciąg, do którego string2 jest dołączany.string2: ciąg, który jest dołączany do elementu string1.Wartość zwracana Klasa String. Wystąpi błąd, jeśli długość ciągu wartości zwracanej jest większa niż dozwolona maksymalna długość.Przykład -- The following example returns abcxyz.Concat('abc', 'xyz') |
Contains(string, target) |
Zwraca wartość true , jeśli target jest zawarta w elem string.Argumenty string: wyszukiwany ciąg.target: wyszukiwany ciąg docelowy.Wartość zwracana true jeśli target jest zawarty w ; w stringprzeciwnym razie false.Przykład -- The following example returns true.Contains('abc', 'bc') |
EndsWith(string, target) |
Zwraca wartość true , jeśli target kończy się ciągiem string.Argumenty string: wyszukiwany ciąg.target: ciąg docelowy wyszukany na końcu elementu string.Wartość zwracana True jeśli string kończy się ciągiem target; w przeciwnym razie false.Przykład -- The following example returns true.EndsWith('abc', 'bc')Uwaga: jeśli używasz dostawcy danych programu SQL Server, ta funkcja zwraca false , jeśli ciąg jest przechowywany w kolumnie ciągu o stałej długości i target jest stałą. W takim przypadku przeszukiwany jest cały ciąg, w tym wszystkie spacje końcowe. Możliwe obejście polega na przycinaniu danych w ciągu o stałej długości, jak w poniższym przykładzie: EndsWith(TRIM(string), target) |
IndexOf(target, string) |
Zwraca położenie target wewnątrz stringelementu lub 0, jeśli nie zostanie znalezione. Zwraca wartość 1, aby wskazać początek .string Numerowanie indeksów rozpoczyna się od 1.Argumenty target: wyszukiwany ciąg.string: wyszukiwany ciąg.Wartość zwracana An Int32.Przykład -- The following example returns 4.IndexOf('xyz', 'abcxyz') |
Left(string, length) |
Zwraca pierwsze length znaki z lewej strony .string Jeśli długość string wartości jest mniejsza niż length, zwracany jest cały ciąg.Argumenty string: A String.length: An Int16, Int32, Int64, lub Byte. length nie może być mniejsza niż zero.Wartość zwracana Klasa String.Przykład -- The following example returns abc.Left('abcxyz', 3) |
Length(string) |
Zwraca długość (Int32) w znakach ciągu.Argumenty string: A String.Wartość zwracana An Int32.Przykład -- The following example returns 6.Length('abcxyz') |
LTrim(string) |
Zwraca string bez wiodącego odstępu.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns abc.LTrim(' abc') |
Replace(string1, string2, string3) |
Zwraca wartość string1, ze wszystkimi wystąpieniami zastąpionymi string2 przez string3.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns abcxyz.Concat('abc', 'xyz') |
Reverse(string) |
Zwraca string wartość z kolejnością odwróconych znaków.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns dcba.Reverse('abcd') |
Right(string, length) |
Zwraca ostatnie length znaki z elementu string. Jeśli długość string wartości jest mniejsza niż length, zwracany jest cały ciąg.Argumenty string: A String.length: An Int16, Int32, Int64, lub Byte. length nie może być mniejsza niż zero.Wartość zwracana Klasa String.Przykład -- The following example returns xyz.Right('abcxyz', 3) |
RTrim(string) |
Zwraca string bez końcowego odstępu.Argumenty Klasa String.Wartość zwracana Klasa String. |
Substring(string, start, length) |
Zwraca podciąg ciągu rozpoczynający się od pozycji start, z długością length znaków. Początek 1 wskazuje pierwszy znak ciągu. Numerowanie indeksów rozpoczyna się od 1.Argumenty string: A String.start: an Int16, Int32Int64 i Byte. start nie może być mniejszy niż jeden.length: an Int16, Int32Int64 i Byte. length nie może być mniejsza niż zero.Wartość zwracana Klasa String.Przykład -- The following example returns xyz.Substring('abcxyz', 4, 3) |
StartsWith(string, target) |
Zwraca wartość true , jeśli string rozpoczyna się od target.Argumenty string: wyszukiwany ciąg.target: ciąg docelowy wyszukany na początku .stringWartość zwracana True jeśli string zaczyna się od target; w przeciwnym razie false.Przykład -- The following example returns true.StartsWith('abc', 'ab') |
ToLower(string) |
Zwraca z string wielkimi literami przekonwertowanymi na małe litery.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns abc.ToLower('ABC') |
ToUpper(string) |
Zwraca string z małymi literami przekonwertowanymi na wielkie litery.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns ABC.ToUpper('abc') |
Trim(string) |
Zwraca string bez wiodącego i końcowego odstępu.Argumenty Klasa String.Wartość zwracana Klasa String.Przykład -- The following example returns abc.Trim(' abc ') |
Te funkcje zostaną zwrócone null w przypadku danych wejściowych null .
Równoważne funkcje są dostępne w programie Microsoft SQL Client Managed Provider. Aby uzyskać więcej informacji, zobacz SqlClient for Entity Framework Functions.Aby uzyskać więcej informacji, zobacz SqlClient for Entity Framework Functions.