Replace-Funktion (Visual Basic)

  • Artikel

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