String.Replace Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode nebo String v aktuálním řetězci nahrazeny jiným zadaným znakem Unicode nebo String.

Přetížení

Replace(Char, Char)	Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode v této instanci nahrazeny jiným zadaným znakem Unicode.
Replace(String, String)	Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem.
Replace(String, String, StringComparison)	Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem pomocí zadaného typu porovnání.
Replace(String, String, Boolean, CultureInfo)	Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem s použitím zadané jazykové verze a rozlišování velkých a malých písmen.

Replace(Char, Char)

Source:

String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode v této instanci nahrazeny jiným zadaným znakem Unicode.

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

Parametry

oldChar

Char

Znak unicode, který má být nahrazen.

newChar

Char

Znak Unicode, který nahradí všechny výskyty znaku oldChar.

Návraty

String

Řetězec, který je ekvivalentní této instanci kromě toho, že všechny instance jsou oldChar nahrazeny za newChar. Pokud oldChar se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Příklady

Následující příklad vytvoří seznam hodnot oddělených čárkami nahrazením mezer mezi řadou čísel.

using namespace System;
int main()
{
   String^ str = "1 2 3 4 5 6 7 8 9";
   Console::WriteLine( "Original string: \"{0}\"", str );
   Console::WriteLine( "CSV string:      \"{0}\"", 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"
//

String str = "1 2 3 4 5 6 7 8 9";
Console.WriteLine("Original string: \"{0}\"", str);
Console.WriteLine("CSV string:      \"{0}\"", 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"

Poznámky

Tato metoda provede ordinální vyhledávání (rozlišují se malá a velká písmena a nerozlišují jazykovou verzi) a vyhledá oldChar.

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldChar řetězcem newChar.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

String s = new String('a', 3);
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);

// 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'

Viz také

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

Replace(String, String)

Source:

String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem.

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

Parametry

oldValue

String

Řetězec, který má být nahrazen.

newValue

String

Řetězec, který má nahradit všechny výskyty .oldValue

Návraty

String

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

oldValue je null.

ArgumentException

oldValue je prázdný řetězec ("").

Příklady

Následující příklad ukazuje, jak můžete použít metodu Replace k opravě pravopisné chyby.

using namespace System;
int main()
{
   String^ errString = "This docment uses 3 other docments to docment the docmentation";
   Console::WriteLine( "The original string is:\n'{0}'\n", errString );

   // Correct the spelling of S"document".
   String^ correctString = errString->Replace( "docment", "document" );
   Console::WriteLine( "After correcting the string, the result is:\n'{0}'", 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'
//

string errString = "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".

string correctString = errString.Replace("docment", "document");

Console.WriteLine("After correcting the string, the result is:{0}'{1}'",
        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'
'

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provede ordinální vyhledávání (rozlišují se malá a velká písmena a nerozlišují jazykovou verzi) a vyhledá oldValue.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

String s = "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);

// 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'

Viz také

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

Replace(String, String, StringComparison)

Source:

String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem pomocí zadaného typu porovnání.

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

public string Replace (string oldValue, string? newValue, StringComparison comparisonType);

member this.Replace : string * string * StringComparison -> string

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

Parametry

oldValue

String

Řetězec, který má být nahrazen.

newValue

String

Řetězec, který má nahradit všechny výskyty .oldValue

comparisonType

StringComparison

Jedna z hodnot výčtu, která určuje, jak oldValue je prohledána v rámci této instance.

Návraty

String

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

oldValue je null.

ArgumentException

oldValue je prázdný řetězec ("").

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provádí hledání pomocí oldValue jazykové verze a rozlišování velkých a malých písmen popsaných v comparisonType.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

String s = "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);

// 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'

Replace(String, String, Boolean, CultureInfo)

Source:

String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem s použitím zadané jazykové verze a rozlišování velkých a malých písmen.

public:
 System::String ^ Replace(System::String ^ oldValue, System::String ^ newValue, bool ignoreCase, System::Globalization::CultureInfo ^ culture);

public string Replace (string oldValue, string? newValue, bool ignoreCase, System.Globalization.CultureInfo? culture);

member this.Replace : string * string * bool * System.Globalization.CultureInfo -> string

Public Function Replace (oldValue As String, newValue As String, ignoreCase As Boolean, culture As CultureInfo) As String

Parametry

oldValue

String

Řetězec, který má být nahrazen.

newValue

String

Řetězec, který má nahradit všechny výskyty .oldValue

ignoreCase

Boolean

true ignorovat při porovnávání velikostí a malých a malých velikostí; false Jinak.

culture

CultureInfo

Jazyková verze, která se má použít při porovnávání. Pokud culture je null, použije se aktuální jazyková verze.

Návraty

String

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

oldValue je null.

ArgumentException

oldValue je prázdný řetězec ("").

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provádí hledání pomocí oldValue zadaných culture a ignoreCase rozlišování velkých a malých písmen.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

String s = "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);

// 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'