String.Replace Methode

Definitie

Naamruimte:

System

Assembly:

mscorlib.dll

Retourneert een nieuwe tekenreeks waarin alle exemplaren van een opgegeven Unicode-teken of String in de huidige tekenreeks worden vervangen door een ander opgegeven Unicode-teken of String.

Overloads

Name	Description
Replace(Char, Char)	Retourneert een nieuwe tekenreeks waarin alle exemplaren van een opgegeven Unicode-teken in dit exemplaar worden vervangen door een ander opgegeven Unicode-teken.
Replace(String, String)	Retourneert een nieuwe tekenreeks waarin alle exemplaren van een opgegeven tekenreeks in het huidige exemplaar worden vervangen door een andere opgegeven tekenreeks.

Replace(Char, Char)

Retourneert een nieuwe tekenreeks waarin alle exemplaren van een opgegeven Unicode-teken in dit exemplaar worden vervangen door een ander opgegeven Unicode-teken.

public:
 System::String ^ Replace(char oldChar, char newChar);

public string Replace(char oldChar, char newChar);

member this.Replace : char * char -> string

Public Function Replace (oldChar As Char, newChar As Char) As String

Parameters

oldChar

Char

Het Unicode-teken dat moet worden vervangen.

newChar

Char

Het Unicode-teken om alle exemplaren van oldChar.

Retouren

String

Een tekenreeks die gelijk is aan dit exemplaar, behalve dat alle exemplaren oldChar worden vervangen door newChar. Als oldChar deze niet wordt gevonden in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Voorbeelden

In het volgende voorbeeld wordt een door komma's gescheiden waardenlijst gemaakt door komma's te vervangen door lege waarden tussen een reeks getallen.

string str = "1 2 3 4 5 6 7 8 9";
Console.WriteLine($"Original string: \"{str}\"");
Console.WriteLine($"CSV string:      \"{str.Replace(' ', ',')}\"");

// This example produces the following output:
// Original string: "1 2 3 4 5 6 7 8 9"
// CSV string:      "1,2,3,4,5,6,7,8,9"

let str = "1 2 3 4 5 6 7 8 9"
printfn $"Original string: \"{str}\""
printfn $"CSV string:      \"{str.Replace(' ', ',')}\""

// This example produces the following output:
// Original string: "1 2 3 4 5 6 7 8 9"
// CSV string:      "1,2,3,4,5,6,7,8,9"

Class stringReplace1
   Public Shared Sub Main()
      Dim str As [String] = "1 2 3 4 5 6 7 8 9"
      Console.WriteLine("Original string: ""{0}""", str)
      Console.WriteLine("CSV string:      ""{0}""", str.Replace(" "c, ","c))
   End Sub
End Class
' This example produces the following output:
' Original string: "1 2 3 4 5 6 7 8 9"
' CSV string:      "1,2,3,4,5,6,7,8,9"

Opmerkingen

Met deze methode wordt een ordinale (hoofdlettergevoelige en cultuurgevoelige) zoekopdracht uitgevoerd om te zoeken oldChar.

Note

Met deze methode wordt de waarde van het huidige exemplaar niet gewijzigd. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd waarin alle exemplaren oldChar worden vervangen door newChar.

Omdat deze methode de gewijzigde tekenreeks retourneert, kunt u opeenvolgende aanroepen aan de Replace methode koppelen om meerdere vervangingen uit te voeren op de oorspronkelijke tekenreeks. Methode-aanroepen worden van links naar rechts uitgevoerd. In het volgende voorbeeld ziet u een afbeelding.

string s = new('a', 3);
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace('a', 'b').Replace('b', 'c').Replace('c', 'd');
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'

let s = new string('a', 3)
printfn $"The initial string: '{s}'"
let s2 = s.Replace('a', 'b').Replace('b', 'c').Replace('c', 'd')
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'

Module Example
   Public Sub Main()
      Dim s As New String("a"c, 3)
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a"c, "b"c).Replace("b"c, "c"c).Replace("c"c, "d"c)
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Zie ook

• Char
• Concat(Object)
• Insert(Int32, String)
• Join(String, String[])
• Remove(Int32, Int32)
• Split(Char[])
• Substring(Int32)
• Trim(Char[])

Replace(String, String)

Retourneert een nieuwe tekenreeks waarin alle exemplaren van een opgegeven tekenreeks in het huidige exemplaar worden vervangen door een andere opgegeven tekenreeks.

public:
 System::String ^ Replace(System::String ^ oldValue, System::String ^ newValue);

public string Replace(string oldValue, string newValue);

member this.Replace : string * string -> string

Public Function Replace (oldValue As String, newValue As String) As String

Parameters

oldValue

String

De tekenreeks die moet worden vervangen.

newValue

String

De tekenreeks voor het vervangen van alle exemplaren van oldValue.

Retouren

String

Een tekenreeks die gelijk is aan de huidige tekenreeks, behalve dat alle exemplaren oldValue worden vervangen door newValue. Als oldValue deze niet wordt gevonden in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

ArgumentNullException

oldValue is null.

ArgumentException

oldValue is de lege tekenreeks ("").

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Replace methode kunt gebruiken om een spelfout te corrigeren.

string errString = "This docment uses 3 other docments to docment the docmentation";

Console.WriteLine($"The original string is:{Environment.NewLine}'{errString}'{Environment.NewLine}");

// Correct the spelling of "document".
string correctString = errString.Replace("docment", "document");

Console.WriteLine($"After correcting the string, the result is:{Environment.NewLine}'{correctString}'");

// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//

open System

let errString = "This docment uses 3 other docments to docment the docmentation"

printfn $"The original string is:{Environment.NewLine}'{errString}'{Environment.NewLine}"

// Correct the spelling of "document".

let correctString = errString.Replace("docment", "document")

printfn $"After correcting the string, the result is:{Environment.NewLine}'{correctString}'"

// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//

Public Class ReplaceTest
    
    Public Shared Sub Main()
        Dim errString As String = "This docment uses 3 other docments to docment the docmentation"
                
        Console.WriteLine("The original string is:{0}'{1}'{0}", Environment.NewLine, errString)

        ' Correct the spelling of "document".  
        Dim correctString As String = errString.Replace("docment", "document")
      
        Console.WriteLine("After correcting the string, the result is:{0}'{1}'", Environment.NewLine, correctString)
    End Sub
End Class
'
' This code example produces the following output:
'
' The original string is:
' 'This docment uses 3 other docments to docment the docmentation'
'
' After correcting the string, the result is:
' 'This document uses 3 other documents to document the documentation'
'

Opmerkingen

Als newValue dat het geval is null, worden alle exemplaren verwijderd oldValue .

Note

Met deze methode wordt de waarde van het huidige exemplaar niet gewijzigd. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd waarin alle exemplaren oldValue worden vervangen door newValue.

Met deze methode wordt een ordinale (hoofdlettergevoelige en cultuurgevoelige) zoekopdracht uitgevoerd om te zoeken oldValue.

Omdat deze methode de gewijzigde tekenreeks retourneert, kunt u opeenvolgende aanroepen aan de Replace methode koppelen om meerdere vervangingen uit te voeren op de oorspronkelijke tekenreeks. Methode-aanroepen worden van links naar rechts uitgevoerd. In het volgende voorbeeld ziet u een afbeelding.

string s = "aaa";
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d");
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'

let s = "aaa"
printfn $"The initial string: '{s}'"
let s2 = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'

Module Example
   Public Sub Main()
      Dim s As String = "aaa"
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Zie ook

• Concat(Object)
• Insert(Int32, String)
• Join(String, String[])
• Remove(Int32, Int32)
• Split(Char[])
• Substring(Int32)
• Trim(Char[])