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 .string1 Argumenty 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 string przeciwnym 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') Nuta: Jeśli używasz dostawcy danych programu SQL Server, ta funkcja zwracafalse , 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 string elementu 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 , Int32 Int64 i Byte . start nie może być mniejszy niż jeden.length : an Int16 , Int32 Int64 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 .string Wartość 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.