REPLACE (Transact-SQL)REPLACE (Transact-SQL)

GILT FÜR: jaSQL Server (ab 2008) jaAzure SQL-DatenbankjaAzure SQL Data Warehouse jaParallel Data WarehouseAPPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Ersetzt alle Vorkommen eines angegebenen Zeichenfolgenwerts durch einen anderen Zeichenfolgenwert.Replaces all occurrences of a specified string value with another string value.

Themenlinksymbol Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

REPLACE ( string_expression , string_pattern , string_replacement )  

ArgumenteArguments

string_expressionstring_expression
Der Zeichenfolgenausdruck, der gesucht werden soll.Is the string expression to be searched. string_expression kann von einem Zeichen- oder Binärdatentyp sein.string_expression can be of a character or binary data type.

string_patternstring_pattern
Die zu suchende Teilzeichenfolge.Is the substring to be found. string_pattern kann von einem Zeichen- oder Binärdatentyp sein.string_pattern can be of a character or binary data type. string_pattern darf keine leere Zeichenfolge ('') sein und die maximal zulässige Anzahl von Byte auf einer Seite nicht überschreiten.string_pattern cannot be an empty string (''), and must not exceed the maximum number of bytes that fits on a page.

string_replacementstring_replacement
Die Ersetzungszeichenfolge.Is the replacement string. string_replacement kann von einem Zeichen- oder Binärdatentyp sein.string_replacement can be of a character or binary data type.

RückgabetypenReturn Types

Gibt nvarchar zurück, wenn eines der Eingabeargumente vom Datentyp nvarchar ist. Andernfalls wird von REPLACE varchar zurückgegeben.Returns nvarchar if one of the input arguments is of the nvarchar data type; otherwise, REPLACE returns varchar.

Gibt NULL zurück, wenn eines der Argumente NULL ist.Returns NULL if any one of the arguments is NULL.

Wenn string_expression nicht vom Typ varchar(max) oder nvarchar(max) ist, schneidet REPLACE den Rückgabewert bei 8.000 Byte ab.If string_expression is not of type varchar(max) or nvarchar(max), REPLACE truncates the return value at 8,000 bytes. Für die Rückgabe von Werten über 8.000 Byte muss string_expression explizit in einen Datentyp für umfangreichere Werten umgewandelt werden.To return values greater than 8,000 bytes, string_expression must be explicitly cast to a large-value data type.

RemarksRemarks

REPLACE führt Vergleiche auf der Basis der Sortierung der Eingabe durch.REPLACE performs comparisons based on the collation of the input. Zum Ausführen eines Vergleichs in einer angegebenen Sortierung können Sie mithilfe von COLLATE eine ausdrückliche Sortierung auf die Eingabe anwenden.To perform a comparison in a specified collation, you can use COLLATE to apply an explicit collation to the input.

0x0000 (char(0)) ist ein nicht definiertes Zeichen in Windows-Sortierungen und kann nicht in REPLACE enthalten sein.0x0000 (char(0)) is an undefined character in Windows collations and cannot be included in REPLACE.

BeispieleExamples

Das folgende Beispiel ersetzt die Zeichenfolge cde in abcdefghi durch xxx.The following example replaces the string cde in abcdefghi with xxx.

SELECT REPLACE('abcdefghicde','cde','xxx');  
GO  

Im Folgenden finden Sie das Resultset.Here is the result set.

------------  
abxxxfghixxx  
(1 row(s) affected)  

Das folgende Beispiel verwendet die COLLATE-Funktion.The following example uses the COLLATE function.

SELECT REPLACE('This is a Test'  COLLATE Latin1_General_BIN,  
'Test', 'desk' );  
GO  

Im Folgenden finden Sie das Resultset.Here is the result set.

------------  
This is a desk  
(1 row(s) affected)  

Weitere InformationenSee Also

CONCAT (Transact-SQL)CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)FORMATMESSAGE (Transact-SQL)
QUOTENAME (Transact-SQL)QUOTENAME (Transact-SQL)
REVERSE (Transact-SQL)REVERSE (Transact-SQL)
STRING_AGG (Transact-SQL)STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)STRING_ESCAPE (Transact-SQL)
STUFF (Transact-SQL)STUFF (Transact-SQL)
TRANSLATE (Transact-SQL)TRANSLATE (Transact-SQL)
Datentypen (Transact-SQL) Data Types (Transact-SQL)
String Functions (Transact-SQL) (Zeichenfolgenfunktionen (Transact-SQL))String Functions (Transact-SQL)