Replace-Funktion (Visual Basic)

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt eine Zeichenfolge zurück, in der eine bestimmte untergeordnete Zeichenfolge so oft wie angegeben durch eine andere Zeichenfolge ersetzt wurde.

Public Function Replace(
   ByVal Expression As String,
   ByVal Find As String,
   ByVal Replacement As String,
   Optional ByVal Start As Integer = 1,
   Optional ByVal Count As Integer = -1,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String

Parameter

Expression
Erforderlich. Zeichenfolgenausdruck, der die zu ersetzende, untergeordnete Zeichenfolge enthält.
Find
Erforderlich. Die untergeordnete Zeichenfolge, nach der gesucht wird.
Replacement
Erforderlich. Die untergeordnete Ersatzzeichenfolge.
Start
Optional. Position in Expression, an der die Suche nach der Teilzeichenfolge beginnt. Wird der Wert nicht angegeben, so wird 1 angenommen.
Count
Optional. Anzahl der durchzuführenden Ersetzungen der Teilzeichenfolge. Wird diese Angabe ausgelassen, ist die Standardeinstellung –1, d. h., alle möglichen Zeichenfolgen werden ersetzt.
Compare
Optional. Numerischer Wert, der angibt, wie beim Auswerten von Teilzeichenfolgen verglichen werden soll. Werte finden Sie im Abschnitt "Einstellungen".

Einstellungen

Das Compare-Argument kann die folgenden Werte haben.

Konstante	Beschreibung
Binary	Führt einen binären Vergleich durch
Text	Führt einen Textvergleich durch

Rückgabewert

Replace gibt die folgenden Werte zurück.

Voraussetzung	Replace gibt Folgendes zurück
Find ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing	Kopie von Expression
Replace ist eine Zeichenfolge mit der Länge 0 (null)	Kopie von Expression ohne Vorkommen von Find
Expression ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing, oder Start ist größer als die Länge von Expression	Nothing
Count ist 0	Kopie von Expression

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Count < –1 oder Start < = 0.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Der Rückgabewert der Replace-Funktion ist eine Zeichenfolge, die an der durch Start festgelegten Position beginnt und am Ende der Expression-Zeichenfolge endet. Die Ersetzungen werden entsprechend der Werte für Find und Replace vorgenommen.

Beispiel

Dieses Beispiel zeigt die Replace-Funktion.

Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

Zeichenfolgenbearbeitung: Zusammenfassung

Filter-Funktion (Visual Basic)

ArgumentException

Freigeben über