Kanonische Zeichenfolgefunktionen

Entitäts-SQL enthält Zeichenfolgen (kanonische Funktionen).

Bemerkungen

Die folgende Tabelle zeigt die Zeichenfolgen-Entität SQL (kanonische Funktionen).

Funktion Beschreibung
Concat(string1, string2) Gibt eine Zeichenfolge zurück, die string2 enthält und an string1 angehängt ist.

Argumente

string1: Die Zeichenfolge, an die string2 angefügt wird.

string2: Die Zeichenfolge, die string1 angefügt wird.

Rückgabewert

einen String Wenn die Länge der zurückgegebenen Wertzeichenfolge die zulässige Höchstlänge überschreitet, wird ein Fehler ausgegeben.

Beispiel

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Contains(string, target) Gibt true zurück, wenn target in string enthalten ist.

Argumente

string: Die Zeichenfolge, die gesucht wird.

target: Die Zielzeichenfolge, nach der gesucht wird.

Rückgabewert

true, wenn target in string enthalten ist, andernfalls false.

Beispiel

-- The following example returns true.

Contains('abc', 'bc')
EndsWith(string, target) Gibt true zurück, wenn target mit string endet.

Argumente

string: Die Zeichenfolge, die gesucht wird.

target: Die Zielzeichenfolge, nach der am Ende der Zeichenfolge gesucht string wird.

Rückgabewert

True wenn string mit target endet, anderenfalls false.

Beispiel

-- The following example returns true.

EndsWith('abc', 'bc')Hinweis: Wenn Sie den SQL Server-Datenanbieter verwenden, gibt diese Funktion false zurück, wenn die Zeichenfolge in einer Spalte mit fester Länge gespeichert ist und target eine Konstante ist. In diesem Fall wird die ganze Zeichenfolge gesucht, einschließlich aller Auffüllleerzeichen. Eine mögliche Problemumgehung stellt die Kürzung der Daten in der Zeichenfolge mit fester Länge dar. Beispiel: EndsWith(TRIM(string), target)
IndexOf(target, string) Gibt die Position von target in string oder, wenn nicht vorhanden, den Wert 0 zurück. Gibt 1 zurück, um den Anfang des string anzugeben. Indexbezifferung beginnt mit der Zahl 1.

Argumente

target: Die Zeichenfolge, nach der gesucht wird.

string: Die Zeichenfolge, die gesucht wird.

Rückgabewert

Int32.

Beispiel

-- The following example returns 4.

IndexOf('xyz', 'abcxyz')
Left(string, length) Gibt die ersten length-Zeichen von der linken Seite der string zurück. Wenn die Länge von string kleiner als length ist, wird die gesamte Zeichenfolge zurückgegeben.

Argumente

string: Ein String-Wert.

length: Int16,Int32, Int64 oder Byte. length darf nicht kleiner 0 (Null) sein.

Rückgabewert

einen String

Beispiel

-- The following example returns abc.

Left('abcxyz', 3)
Length(string) Gibt die (Int32-)Länge der Zeichenfolge in Zeichen zurück.

Argumente

string: Ein String-Wert.

Rückgabewert

Int32.

Beispiel

-- The following example returns 6.

Length('abcxyz')
LTrim(string) Gibt string ohne führende Leerzeichen zurück.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns abc.

LTrim(' abc')
Replace(string1, string2, string3) Gibt string1 mit allen Vorkommen von string2 zurück, die durch string3 ersetzt wurden.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Reverse(string) Gibt string mit umgekehrter Reihenfolge der Zeichen zurück.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns dcba.

Reverse('abcd')
Right(string, length) Gibt die letzten length Zeichen aus dem stringzurück. Wenn die Länge von string kleiner als length ist, wird die gesamte Zeichenfolge zurückgegeben.

Argumente

string: Ein String-Wert.

length: Int16,Int32, Int64 oder Byte. length darf nicht kleiner 0 (Null) sein.

Rückgabewert

einen String

Beispiel

-- The following example returns xyz.

Right('abcxyz', 3)
RTrim(string) Gibt string ohne nachfolgende Leerzeichen zurück.

Argumente

einen String

Rückgabewert

einen String
Substring(string, start, length) Gibt die Teilzeichenfolge der Zeichenfolge mit einer Länge von start Zeichen zurück, die an der Position length beginnt. Mit dem Startwert 1 wird das erste Zeichen der Zeichenfolge angegeben. Indexbezifferung beginnt mit der Zahl 1.

Argumente

string: Ein String-Wert.

start: Int16, Int32, Int64 und Byte. start darf nicht kleiner 1 sein.

length: Int16, Int32, Int64 und Byte. length darf nicht kleiner 0 (Null) sein.

Rückgabewert

einen String

Beispiel

-- The following example returns xyz.

Substring('abcxyz', 4, 3)
StartsWith(string, target) Gibt true zurück, wenn string mit target beginnt.

Argumente

string: Die Zeichenfolge, die gesucht wird.

target: Die Zielzeichenfolge, nach der am Anfang der Zeichenfolge gesucht string wird.

Rückgabewert

True wenn string mit target beginnt, anderenfalls false.

Beispiel

-- The following example returns true.

StartsWith('abc', 'ab')
ToLower(string) Gibt string mit in Kleinbuchstaben umgewandelten Großbuchstaben zurück.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns abc.

ToLower('ABC')
ToUpper(string) Gibt string mit in Großbuchstaben umgewandelten Kleinbuchstaben zurück.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns ABC.

ToUpper('abc')
Trim(string) Gibt string ohne führendes und nachfolgendes Leerzeichen zurück.

Argumente

einen String

Rückgabewert

einen String

Beispiel

-- The following example returns abc.

Trim(' abc ')

Diese Funktionen geben null zurück, wenn die Eingabe null ist.

Entsprechende Funktionen sind für den verwalteten Anbieter des Microsoft SQL-Clients verfügbar. Weitere Informationen finden Sie unter SqlClient für Entity Framework-Funktionen.

Siehe auch