StringBuilder.Replace Método

Definição

Espaço de Nomes:: System.Text

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Substitui todas as ocorrências de um carácter ou cadeia especificado nesta instância por outro carácter ou cadeia especificada.

Sobrecargas

Name	Description
Replace(Char, Char)	Substitui todas as ocorrências de um carácter especificado neste caso por outro carácter especificado.
Replace(String, String)	Substitui todas as ocorrências de uma cadeia especificada neste caso por outra cadeia especificada.
Replace(Char, Char, Int32, Int32)	Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de um carácter especificado por outro carácter especificado.
Replace(String, String, Int32, Int32)	Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de uma cadeia especificada por outra cadeia especificada.

Exemplos

O exemplo seguinte demonstra o Replace método.

using System;
using System.Text;

class Sample
{
    public static void Main()
    {
//                0----+----1----+----2----+----3----+----4---
//                01234567890123456789012345678901234567890123
    string str = "The quick br!wn d#g jumps #ver the lazy cat.";
    StringBuilder sb = new StringBuilder(str);

    Console.WriteLine();
    Console.WriteLine("StringBuilder.Replace method");
    Console.WriteLine();

    Console.WriteLine("Original value:");
    Show(sb);

    sb.Replace('#', '!', 15, 29);        // Some '#' -> '!'
    Show(sb);
    sb.Replace('!', 'o');                // All '!' -> 'o'
    Show(sb);
    sb.Replace("cat", "dog");            // All "cat" -> "dog"
    Show(sb);
    sb.Replace("dog", "fox", 15, 20);    // Some "dog" -> "fox"

    Console.WriteLine("Final value:");
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    string rule1 = "0----+----1----+----2----+----3----+----4---";
    string rule2 = "01234567890123456789012345678901234567890123";

    Console.WriteLine(rule1);
    Console.WriteLine(rule2);
    Console.WriteLine("{0}", sbs.ToString());
    Console.WriteLine();
    }
}
/*
This example produces the following results:

StringBuilder.Replace method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.

Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

*/

open System.Text

let show (sbs: StringBuilder) =
    let rule1 = "0----+----1----+----2----+----3----+----4---"
    let rule2 = "01234567890123456789012345678901234567890123"
    printfn $"{rule1}\n{rule2}\n{sbs}\n"

//         0----+----1----+----2----+----3----+----4---
//         01234567890123456789012345678901234567890123
let str = "The quick br!wn d#g jumps #ver the lazy cat."
let sb = StringBuilder str

printfn "StringBuilder.Replace method\n"

printfn "Original value:"
show sb

sb.Replace('#', '!', 15, 29) |> ignore // Some '#' -> '!'
show sb
sb.Replace('!', 'o') |> ignore // All '!' -> 'o'
show sb
sb.Replace("cat", "dog") |> ignore // All "cat" -> "dog"
show sb
sb.Replace("dog", "fox", 15, 20) |> ignore // Some "dog" -> "fox"

printfn "Final value:"
show sb

// This example produces the following results:
//       StringBuilder.Replace method
//
//       Original value:
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick br!wn d#g jumps #ver the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick br!wn d!g jumps !ver the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown dog jumps over the lazy cat.
//
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown dog jumps over the lazy dog.
//
//       Final value:
//       0----+----1----+----2----+----3----+----4---
//       01234567890123456789012345678901234567890123
//       The quick brown fox jumps over the lazy dog.

Imports System.Text

Class Sample
   Public Shared Sub Main()
      '                    0----+----1----+----2----+----3----+----4---
      '                    01234567890123456789012345678901234567890123
      Dim str As String = "The quick br!wn d#g jumps #ver the lazy cat."
      Dim sb As New StringBuilder(str)
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.Replace method")
      Console.WriteLine()
      
      Console.WriteLine("Original value:")
      Show(sb)
      
      sb.Replace("#"c, "!"c, 15, 29)   ' Some '#' -> '!'
      Show(sb)
      sb.Replace("!"c, "o"c)           ' All '!' -> 'o'
      Show(sb)
      sb.Replace("cat", "dog")         ' All "cat" -> "dog"
      Show(sb)
      sb.Replace("dog", "fox", 15, 20) ' Some "dog" -> "fox"
      Console.WriteLine("Final value:")
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Dim rule1 As String = "0----+----1----+----2----+----3----+----4---"
      Dim rule2 As String = "01234567890123456789012345678901234567890123"
      
      Console.WriteLine(rule1)
      Console.WriteLine(rule2)
      Console.WriteLine("{0}", sbs.ToString())
      Console.WriteLine()
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Replace method
'
'Original value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d#g jumps #ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d!g jumps !ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy dog.
'
'Final value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown fox jumps over the lazy dog.
'

Replace(Char, Char)

Substitui todas as ocorrências de um carácter especificado neste caso por outro carácter especificado.

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

public System.Text.StringBuilder Replace(char oldChar, char newChar);

member this.Replace : char * char -> System.Text.StringBuilder

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

Parâmetros

oldChar: Char

A personagem a substituir.

newChar: Char

A personagem que substitui oldChar.

Devoluções

StringBuilder

Uma referência a esta instância com oldChar substituído por newChar.

Observações

Este método realiza uma comparação ordinal, sensível a maiúsculas e minúsculas, para identificar ocorrências de oldChar na instância atual. O tamanho da instância atual StringBuilder mantém-se inalterado após a substituição.

Aplica-se a

Replace(String, String)

Substitui todas as ocorrências de uma cadeia especificada neste caso por outra cadeia especificada.

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

public System.Text.StringBuilder Replace(string oldValue, string newValue);

member this.Replace : string * string -> System.Text.StringBuilder

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

Parâmetros

oldValue: String

A cadeia a substituir.

newValue: String

A cadeia que substitui oldValue, ou null.

Devoluções

StringBuilder

Uma referência a esta instância com todas as instâncias de oldValue substituídas por newValue.

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

O comprimento de oldValue é zero.

ArgumentOutOfRangeException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Este método realiza uma comparação ordinal, sensível a maiúsculas e minúsculas, para identificar ocorrências de oldValue na instância atual. Se newValue for null ou String.Empty, todas as ocorrências de oldValue são removidas.

Ver também

Remove(Int32, Int32)

Aplica-se a

Replace(Char, Char, Int32, Int32)

Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de um carácter especificado por outro carácter especificado.

public:
 System::Text::StringBuilder ^ Replace(char oldChar, char newChar, int startIndex, int count);

public System.Text.StringBuilder Replace(char oldChar, char newChar, int startIndex, int count);

member this.Replace : char * char * int * int -> System.Text.StringBuilder

Public Function Replace (oldChar As Char, newChar As Char, startIndex As Integer, count As Integer) As StringBuilder

Parâmetros

oldChar: Char

A personagem a substituir.

newChar: Char

A personagem que substitui oldChar.

startIndex: Int32

A posição neste caso onde a subcadeia começa.

count: Int32

O comprimento da subcorda.

Devoluções

StringBuilder

Uma referência a este caso com oldChar substituído por newChar no intervalo de startIndex até startIndex + count -1.

Exceções

ArgumentOutOfRangeException

startIndex + count é maior do que o comprimento do valor desta instância.

-ou-

startIndex ou count é inferior a zero.

Observações

Este método realiza uma comparação ordinal, sensível a maiúsculas e minúsculas, para identificar ocorrências de oldChar na instância atual. O tamanho do objeto atual StringBuilder mantém-se inalterado após a substituição.

Aplica-se a

Replace(String, String, Int32, Int32)

Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de uma cadeia especificada por outra cadeia especificada.

public:
 System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue, int startIndex, int count);

public System.Text.StringBuilder Replace(string oldValue, string newValue, int startIndex, int count);

member this.Replace : string * string * int * int -> System.Text.StringBuilder

Public Function Replace (oldValue As String, newValue As String, startIndex As Integer, count As Integer) As StringBuilder

Parâmetros

oldValue: String

A cadeia a substituir.

newValue: String

A cadeia que substitui oldValue, ou null.

startIndex: Int32

A posição neste caso onde a subcadeia começa.

count: Int32

O comprimento da subcorda.

Devoluções

StringBuilder

Uma referência a esta instância com todas as instâncias de oldValue substituídas por newValue no intervalo de startIndex até startIndex + count -1.

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

O comprimento de oldValue é zero.

ArgumentOutOfRangeException

startIndex ou count é inferior a zero.

-ou-

startIndex Plus count indica uma posição de personagem que não está neste caso.

-ou-

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Este método realiza uma comparação ordinal, sensível a maiúsculas minúsculas, para identificar ocorrências de oldValue na subcadeia especificada. Se newValue for null ou String.Empty, todas as ocorrências de oldValue são removidas.

Ver também

Remove(Int32, Int32)

Aplica-se a

Comentários

Esta página foi útil?