StringBuilder.Replace Метод

Определение

Заменяет все вхождения указанного символа или строки в этом экземпляре другим указанным символом или строкой.

Перегрузки

Replace(Char, Char)

Заменяет все вхождения указанного символа в этом экземпляре другим указанным символом.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Заменяет все экземпляры одного диапазона символов только для чтения другим в этом построителе.

Replace(String, String)

Заменяет все вхождения указанной строки в этом экземпляре другой указанной строкой.

Replace(Char, Char, Int32, Int32)

Заменяет в подстроку этого экземпляра все вхождения указанного символа другим заданным символом.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Заменяет все экземпляры одного диапазона символов только для чтения другим в составе этого построителя.

Replace(String, String, Int32, Int32)

Заменяет в подстроке этого экземпляра все вхождения указанной строки другой указанной строкой.

Примеры

В следующем примере показан метод Replace.

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.

*/

Replace(Char, Char)

Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs

Заменяет все вхождения указанного символа в этом экземпляре другим указанным символом.

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

Параметры

oldChar
Char

Символ для замены.

newChar
Char

Символ, заменяющий oldChar.

Возвращаемое значение

Ссылка на этот экземпляр с oldChar заменена newChar.

Комментарии

Этот метод выполняет порядковое сравнение с учетом регистра для идентификации вхождения oldChar в текущем экземпляре. Размер текущего экземпляра StringBuilder не изменяется после замены.

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Исходный код:
StringBuilder.cs

Заменяет все экземпляры одного диапазона символов только для чтения другим в этом построителе.

public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue);

Параметры

oldValue
ReadOnlySpan<Char>

Диапазон символов только для чтения для замены.

newValue
ReadOnlySpan<Char>

Диапазон символов только для чтения для замены oldValue.

Возвращаемое значение

Комментарии

Если newValue пуст, экземпляры oldValue удаляются из этого построителя.

Применяется к

.NET 9
Өнім Нұсқалар
.NET 9

Replace(String, String)

Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs

Заменяет все вхождения указанной строки в этом экземпляре другой указанной строкой.

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

Параметры

oldValue
String

Строка для замены.

newValue
String

Строка, которая заменяет oldValueили null.

Возвращаемое значение

Ссылка на этот экземпляр со всеми экземплярами oldValue заменена newValue.

Исключения

oldValue null.

Длина oldValue равна нулю.

Увеличение значения этого экземпляра превысит MaxCapacity.

Комментарии

Этот метод выполняет порядковое сравнение с учетом регистра для идентификации вхождения oldValue в текущем экземпляре. Если newValuenull или String.Empty, удаляются все вхождения oldValue.

См. также раздел

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(Char, Char, Int32, Int32)

Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs

Заменяет в подстроку этого экземпляра все вхождения указанного символа другим заданным символом.

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

Параметры

oldChar
Char

Символ для замены.

newChar
Char

Символ, заменяющий oldChar.

startIndex
Int32

Позиция в этом экземпляре, в которой начинается подстрока.

count
Int32

Длина подстроки.

Возвращаемое значение

Ссылка на этот экземпляр с oldChar заменена newChar в диапазоне от startIndex до startIndex + count -1.

Исключения

startIndex + count больше длины значения этого экземпляра.

-или-

startIndex или count меньше нуля.

Комментарии

Этот метод выполняет порядковое сравнение с учетом регистра для идентификации вхождения oldChar в текущем экземпляре. Размер текущего объекта StringBuilder не изменяется после замены.

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Исходный код:
StringBuilder.cs

Заменяет все экземпляры одного диапазона символов только для чтения другим в составе этого построителя.

public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue, int startIndex, int count);

Параметры

oldValue
ReadOnlySpan<Char>

Диапазон символов только для чтения для замены.

newValue
ReadOnlySpan<Char>

Диапазон символов только для чтения для замены oldValue.

startIndex
Int32

Индекс для запуска в этом построителе.

count
Int32

Количество символов для чтения в этом построителе.

Возвращаемое значение

Комментарии

Если newValue пуст, экземпляры oldValue удаляются из этого построителя.

Применяется к

.NET 9
Өнім Нұсқалар
.NET 9

Replace(String, String, Int32, Int32)

Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs
Исходный код:
StringBuilder.cs

Заменяет в подстроке этого экземпляра все вхождения указанной строки другой указанной строкой.

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

Параметры

oldValue
String

Строка для замены.

newValue
String

Строка, которая заменяет oldValueили null.

startIndex
Int32

Позиция в этом экземпляре, в которой начинается подстрока.

count
Int32

Длина подстроки.

Возвращаемое значение

Ссылка на этот экземпляр со всеми экземплярами oldValue заменена newValue в диапазоне от startIndex до startIndex + count – 1.

Исключения

oldValue null.

Длина oldValue равна нулю.

startIndex или count меньше нуля.

-или-

startIndex плюс count указывает положение символов, не в этом экземпляре.

-или-

Увеличение значения этого экземпляра превысит MaxCapacity.

Комментарии

Этот метод выполняет порядковое сравнение с учетом регистра для выявления вхождения oldValue в указанной подстроке. Если newValuenull или String.Empty, удаляются все вхождения oldValue.

См. также раздел

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0