Zeichenfolgenfunktionen

Der .NET Framework-Datenanbieter für SQL Server (SqlClient) stellt Funktionen bereit String , die Vorgänge für eine Eingabe String ausführen und ein oder ein String numerisches Wertergebnis zurückgeben. Diese Funktionen befinden sich im SqlServer-Namespace, der verfügbar ist, wenn Sie SqlClient verwenden. Mit der Namespaceeigenschaft eines Anbieters kann Entity Framework ermitteln, welches Präfix von diesem Anbieter für bestimmte Konstrukte verwendet wird, z. B. Typen und Funktionen.

Die folgende Tabelle zeigt die SqlClient-Funktionen String .

Funktion	BESCHREIBUNG
ASCII(expression)	Gibt den ASCII-Codewert des äußerst linken Zeichens eines Zeichenfolgenausdrucks zurück. Argumente expression: Ein beliebiger gültiger Ausdruck eines ASCII-Typs String . Rückgabewert Int32. Beispiel SqlServer.ASCII('A')
CHAR(expression)	Konvertiert einen Int32 Code in eine ASCII-Zeichenfolge. Argumente expression: Ein Int32. Rückgabewert Ein ASCII-String. Beispiel SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location])	Gibt die Startposition des angegebenen Ausdrucks in einer Zeichenfolge zurück. Argumente expression1: Ein Ausdruck, der die Abfolge der zu findenden Zeichen enthält. Der Ausdruck kann ein Zeichenfolgentyp (ASCII oder Unicode) oder ein Binärtyp sein. expression2: Ein Ausdruck, in der Regel eine Spalte, der nach der angegebenen Sequenz durchsucht werden soll. Der Ausdruck kann ein Zeichenfolgentyp (ASCII oder Unicode) oder ein Binärtyp sein. start_location:(Optional) Ein Int64 (nicht in SQL Server 2000 zurückgegeben) oder Int32, das die Zeichenposition darstellt, um mit der Suche nach Ausdruck1 in Expression2 zu beginnen. Wenn start_location nicht angegeben ist, eine negative Zahl ist oder null ist, beginnt die Suche am Anfang von Expression2. Rückgabewert Int32. Beispiel SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression)	Vergleicht die SOUNDEX Werte von zwei Zeichenfolgen und wertet die Ähnlichkeit zwischen ihnen aus. Argumente Ein ASCII- oder Unicode-Typ String . expression kann eine Konstante, eine Variable oder eine Spalte sein. Rückgabewert Gibt einen Int32 Wert zurück, der den Unterschied zwischen den SOUNDEX-Werten von zwei Zeichenausdrücken darstellt. Der Bereich liegt zwischen 0 und 4. 0 weist auf eine schwache Ähnlichkeit oder keine Ähnlichkeit hin, und 4 gibt eine starke Ähnlichkeit oder dieselben Werte an. Beispiel // The following example returns a DIFFERENCE value of 4, //the least possible difference or the best match. SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count)	Gibt den linken Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück. Argumente expression: Ein Unicode- oder ASCII-Zeichenfolgentyp. Verwenden Sie die CAST-Funktion, um character_expression explizit zu konvertieren. count: Ein Int64 (nicht in SQL Server 2000 zurückgegebener Wert) oder Int32 Typ, der angibt, wie viele Zeichen von character_expression zurückgegeben werden. Rückgabewert Ein Unicode- oder ASCII-Format String. Beispiel SqlServer.LEFT('SQL Server', 4)
LEN(expression)	Gibt die Anzahl der Zeichen im angegebenen Zeichenfolgenausdruck zurück, ohne nachfolgende Leerzeichen. Argumente expression: Ein Ausdruck eines String (Unicode- oder ASCII-Typs) oder eines Typs Binary Rückgabewert Int32. Beispiel SqlServer.LEN('abcd')
LOWER(expression)	Gibt einen String Ausdruck zurück, nachdem Großbuchstaben in Kleinbuchstaben konvertiert wurden. Argumente expression: Ein beliebiger gültiger Ausdruck des Typs String . Rückgabewert Ein String. Beispiel SqlServer.LOWER('AbB')
LTRIM(expression)	Gibt einen String Ausdruck zurück, nachdem führende Leerzeichen entfernt wurden. Argumente expression: Ein beliebiger gültiger Ausdruck des Typs String . Rückgabewert Ein String. Beispiel SqlServer.LTRIM(' d')
NCHAR(expression)	Gibt einen Unicode-Code String mit dem angegebenen ganzzahligen Code zurück, wie durch den Unicode-Standard definiert. Argumente expression: Ein Int32. Rückgabewert Ein String (Unicode). Beispiel SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression)	Gibt die Anfangsposition des ersten Vorkommens eines Musters in einem angegebenen String Ausdruck zurück. Argumente '%pattern%': Ein ASCII- oder Unicode-Typ String . Wildcardzeichen können verwendet werden; Das % Zeichen muss jedoch vor und nach dem Muster (mit Ausnahme der Suchvorgänge nach ersten oder letzten Zeichen) erfolgen. expression: Ein ASCII- oder Unicode-Wert String , der nach dem angegebenen Muster gesucht werden soll. Rückgabewert Int32. Beispiel SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char'])	Gibt einen Unicode-Wert String mit den Trennzeichen zurück, die hinzugefügt wurden, um die Eingabezeichenfolge zu einem gültigen bezeichner mit Trennzeichen für SQL Server 2005 zu machen. Argumente char_string: Ein Unicode String. quote_char: Eine einstellige Zeichenfolge, die als Trennzeichen verwendet werden soll. Kann ein einfaches Anführungszeichen ( ' ), eine linke oder rechte Klammer ( [ ] ) oder ein doppeltes Anführungszeichen ( " ) sein. Wenn quote_char nicht angegeben, werden eckige Klammern verwendet. Rückgabewert Ein String (Unicode). Beispiel SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3)	Ersetzt einen Zeichenausdruck durch einen anderen Zeichenausdruck. Argumente expression1: Der zu durchsuchende Zeichenfolgenausdruck. expression1 kann ein Unicode- oder ASCII-Zeichenfolgentyp sein. expression2:Die zu findende Teilzeichenfolge. expression2 kann ein Unicode- oder ASCII-Zeichenfolgentyp sein. expression3; Die Ersetzungszeichenfolge. expression3 kann ein Unicode- oder ASCII-Zeichenfolgentyp sein. Beispiel SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression)	Wiederholt einen Zeichenausdruck für eine angegebene Anzahl von Malen. Argumente char_expression: Ein Unicode- oder ASCII-Typ String . int_expression: Int64 (in SQL Server 2000 nicht unterstützt) oder Int32. Rückgabewert Ein Unicode- oder ASCII-Typ String . Beispiel SqlServer.REPLICATE('aa',2)
REVERSE(expression)	Gibt eine Unicode- oder ASCII-Zeichenfolge zurück, deren Zeichenpositionen von der Eingabezeichenfolge umgekehrt werden. Argumente expression: Ein Unicode- oder ASCII-Typ String . Rückgabewert Ein Unicode- oder ASCII-Typ String . Beispiel SqlServer.REVERSE('abcd')
RIGHT(char_expression, count)	Gibt den rechten Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück. Argumente char_expression:A Unicode- oder ASCII-Zeichenfolgentyp. Verwenden Sie die CAST-Funktion, um character_expression explizit zu konvertieren. count: Ein Int64 (nicht in SQL Server 2000 zurückgegebener Wert) oder Int32 Typ, der angibt, wie viele Zeichen von character_expression zurückgegeben werden. Rückgabewert Ein ASCII-Typ String . Beispiel SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression)	Gibt eine Unicode- oder ASCII-Zeichenfolge zurück, nachdem nachfolgende Leerzeichen entfernt wurden. Argumente expression: Ein Unicode- oder ASCII-Typ String . Rückgabewert Ein Unicode- oder ASCII-Typ String . Beispiel SqlServer.RTRIM(' d e ')
SOUNDEX(expression)	Gibt einen Vier-Zeichen-Code (SOUNDEX) zurück, um die Ähnlichkeit zweier Zeichenfolgen auszuwerten. Argumente expression: Ein Unicode- oder ASCII-Zeichenfolgentyp. Rückgabewert Ein ASCII-String. Ein vierstelligen Code (SOUNDEX) ist eine Zeichenfolge, die die Ähnlichkeit zweier Zeichenfolgen auswertet. Beispiel Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1} Rückgabe ----- ----- S530 S530
SPACE(int_expression)	Gibt einen ASCII-Wert String wiederholter Leerzeichen zurück. Argumente int_expression: Eine Int64 (nicht in SQL Server 2000 zurückgegebene) oder Int32 die die Anzahl der Leerzeichen angibt. Rückgabewert Ein ASCII-String. Beispiel SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]])	Gibt einen ASCII-Wert String zurück, der aus numerischen Daten konvertiert wird. Argumente float _expression: Ein Ausdruck des ungefähren numerischen Datentyps (Double) mit einem Dezimalkomma. length: (optional) Ein Int32 Wert, der die Gesamtlänge darstellt. Dazu gehören Dezimalkomma, Zeichen, Ziffern und Leerzeichen. Der Standardwert ist 10. decimal:(optional) Ein Wert Int32 , der die Anzahl der Stellen rechts neben dem Dezimalkomma darstellt. Dezimalzahl muss kleiner oder gleich 16 sein. Wenn die Dezimalzahl mehr als 16 ist, wird das Ergebnis an sechszehn Stellen rechts neben dem Dezimalkomma abgeschnitten. Rückgabewert Ein ASCII-String. Beispiel SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert)	Löscht eine angegebene Länge von Zeichen und fügt einen weiteren Satz von Zeichen an einem angegebenen Anfangspunkt in einem Zeichenfolgenausdruck ein. Argumente str_expression: Unicode oder ASCII String. start: Ein Int64 (nicht in SQL Server 2000 zurückgegebener) oder Int32 Wert, der den Speicherort angibt, an dem das Löschen und Einfügen gestartet werden soll. length: Eine Int64 (nicht in SQL Server 2000 zurückgegebene) oder Int32 ein Wert, der die Anzahl der zu löschenden Zeichen angibt. str_expression_to_insert: Unicode oder ASCII String. Rückgabewert Ein Unicode- oder ASCII-Format String. Beispiel SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length)	Gibt einen Teil eines String Ausdrucks zurück. Argumente str_expression: Ein Ausdruck eines String (ASCII- oder Unicode-Typs) oder eines Binary Typs. start: Eine Int64 (nicht in SQL Server 2000 zurückgegebene) oder Int32 die angibt, wo die Teilzeichenfolge beginnt. 1 bezieht sich auf das erste Zeichen in der Zeichenfolge. length: Eine Int64 (nicht in SQL Server 2000 zurückgegebene) oder Int32 die angibt, wie viele Zeichen des Ausdrucks zurückgegeben werden. Rückgabewert Ein String (ASCII- oder Unicode-Typ) oder ein Binary Typ. Beispiel SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression)	Gibt den ganzzahligen Wert zurück, wie durch den Unicode-Standard definiert, für das erste Zeichen des Eingabeausdrucks. Argumente expression: Ein Unicode String. Rückgabewert Int32. Beispiel SqlServer.UNICODE('a')
UPPER(expression)	Gibt einen String Ausdruck zurück, nachdem Kleinbuchstaben in Großbuchstaben konvertiert wurden. Argumente expression: Ein Ausdruck eines ASCII- oder Unicode-Zeichenfolgentyps. Rückgabewert Ein ASCII- oder Unicode-Typ String . Beispiel SqlServer.UPPER('AbB')

Weitere Informationen zu den funktionen, die String SqlClient unterstützt, finden Sie unter String Functions (Transact-SQL).

Siehe auch

• SqlClient für Entity Framework-Funktionen
• Bekannte Probleme in SqlClient für Entity Framework