Replace-FunktionReplace function

Gibt eine Zeichenfolge zurück, die eine Teilzeichenfolge eines Zeichenfolgenausdrucks beginnend an der Startposition (standardmäßig 1) ist, bei der eine angegebene Teilzeichenfolge eine bestimmte Anzahl von Malen durch eine andere Teilzeichenfolge ersetzt wurde.Returns a string, which is a substring of a string expression beginning at the start position (defaults to 1), in which a specified substring has been replaced with another substring a specified number of times.

SyntaxSyntax

Replace(expression, find, replace, [ start, [ count, [ compare ]]])Replace(expression, find, replace, [ start, [ count, [ compare ]]])


Die Syntax der Replace-Funktion weist folgende benannte Argumente auf:The Replace function syntax has these named arguments:

TeilPart BeschreibungDescription
expressionexpression Erforderlich.Required. Ein Zeichenfolgenausdruck mit einer zu ersetzenden Teilzeichenfolge.String expression containing substring to replace.
findfind Erforderlich.Required. Eine Teilzeichenfolge, nach der gesucht wird.Substring being searched for.
replacereplace Erforderlich.Required. Ersatzteilzeichenfolge.Replacement substring.
startstart Optional.Optional. Startposition für die Teilzeichenfolge von expression, nach der gesucht wird und die zurückgegeben wird.Start position for the substring of expression to be searched and returned. Wenn diese nicht angegeben wird, wird 1 angenommen.If omitted, 1 is assumed.
countcount Optional.Optional. Anzahl der auszuführenden Ersetzungen von Teilzeichenfolgen.Number of substring substitutions to perform. Wenn nicht angegeben, wird der Standardwert 1 angenommen, d. h. alle möglichen Ersetzungen werden vorgenommen.If omitted, the default value is -1, which means, make all possible substitutions.
comparecompare Optional.Optional. Der numerische Wert, der die Art des Vergleichs beim Auswerten von Teilzeichenfolgen angibt.Numeric value indicating the kind of comparison to use when evaluating substrings. Im Abschnitt „Einstellungen“ finden Sie entsprechende Werte.See Settings section for values.

EinstellungenSettings

Das compare-Argument kann die folgenden Werte besitzen:The compare argument can have the following values:

KonstanteConstant WertValue BeschreibungDescription
vbUseCompareOptionvbUseCompareOption -1-1 Führt mit der Einstellung der Option Compare-Anweisung einen Vergleich aus.Performs a comparison by using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare 00 Führt einen binären Vergleich aus.Performs a binary comparison.
vbTextComparevbTextCompare 11 Führt einen Textvergleich aus.Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare 22 Nur Microsoft Access.Microsoft Access only. Führt anhand der Informationen in Ihrer Datenbank einen Vergleich aus.Performs a comparison based on information in your database.

RückgabewerteReturn values

Replace gibt die folgenden Werte zurück:Replace returns the following values:

WennIf Gibt „Replace“ Folgendes zurück:Replace returns
expression die Länge NULL aufweistexpression is zero-length Zeichnfolge der Länge Null ("")Zero-length string ("")
expression ist Null.expression is Null FehlerAn error.
find die Länge NULL aufweistfind is zero-length Kopie von expression.Copy of expression.
replace die Länge NULL aufweistreplace is zero-length Kopie von expression, bei der alle Vorkommnisse von finden entfernt wurden.Copy of expression with all occurrences of find removed.
start > Len(expression)start > Len(expression) Zeichenfolge der Länge Null ("").Zero-length string. Die Ersetzung der Zeichenfolge beginnt an der Position, die von start angegeben wird.String replacement begins at the position indicated by start.
count ist 0.count is 0 Kopie von expression.Copy of expression.

HinweiseRemarks

Der Rückgabewert der Replace-Funktion ist eine Zeichenfolge, bei der Ersetzungen vorgenommen wurden, die an der von start angegebenen Position beginnt und an der von expression angegebenen Position endet.The return value of the Replace function is a string, with substitutions made, that begins at the position specified by start and concludes at the end of the expression string. Es handelt sich nicht um eine Kopie der ursprünglichen Zeichenfolge von Anfang bis Ende.It is not a copy of the original string from start to finish.

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.