StringBuilder.Replace メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このインスタンスに出現する指定文字または指定文字列をすべて、別に指定した文字または文字列に置換します。
オーバーロード
Replace(Char, Char) |
このインスタンスに出現する指定文字をすべて、別に指定した文字に置換します。 |
Replace(String, String) |
このインスタンスに出現するすべての指定した文字列を、別の指定した文字列に置換します。 |
Replace(Char, Char, Int32, Int32) |
このインスタンスの部分文字列に出現するすべての指定した文字を、別の指定した文字に置換します。 |
Replace(String, String, Int32, Int32) |
このインスタンスの部分文字列に出現するすべての指定した文字列を、別の指定した文字列に置換します。 |
例
Replaceメソッドの例を次に示します。
using namespace System;
using namespace System::Text;
void Show( StringBuilder^ sbs )
{
String^ rule1 = "0----+----1----+----2----+----3----+----4---";
String^ rule2 = "01234567890123456789012345678901234567890123";
Console::WriteLine( rule1 );
Console::WriteLine( rule2 );
Console::WriteLine( "{0}", sbs );
Console::WriteLine();
}
int main()
{
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
String^ str = "The quick br!wn d#g jumps #ver the lazy cat.";
StringBuilder^ sb = gcnew 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 );
}
/*
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.
*/
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.
*/
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)
このインスタンスに出現する指定文字をすべて、別に指定した文字に置換します。
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
パラメーター
- oldChar
- Char
置換する文字。
- newChar
- Char
oldChar
を置換する文字。
戻り値
oldChar
が newChar
に置換されたこのインスタンスへの参照。
注釈
このメソッドは、現在のインスタンスでの の出現箇所を識別するために、大文字と小文字を区別する序 oldChar
数の比較を実行します。 置換後、現在の StringBuilder インスタンスのサイズは変更されません。
適用対象
Replace(String, String)
このインスタンスに出現するすべての指定した文字列を、別の指定した文字列に置換します。
public:
System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue);
public System.Text.StringBuilder Replace (string oldValue, 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
パラメーター
- oldValue
- String
置換する文字列。
- newValue
- String
oldValue
を置換する文字列、または null
。
戻り値
oldValue
のすべてのインスタンスが newValue
に置換されたこのインスタンスへの参照。
例外
oldValue
が null
です。
oldValue
の長さが 0 です。
このインスタンスの値を増やすと MaxCapacity を超えます。
注釈
このメソッドは、現在のインスタンスでの の出現箇所を識別するために、大文字と小文字を区別する序 oldValue
数の比較を実行します。 が newValue
または null
の String.Empty 場合、 の出現箇所 oldValue
はすべて削除されます。
こちらもご覧ください
適用対象
Replace(Char, Char, Int32, Int32)
このインスタンスの部分文字列に出現するすべての指定した文字を、別の指定した文字に置換します。
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
パラメーター
- oldChar
- Char
置換する文字。
- newChar
- Char
oldChar
を置換する文字。
- startIndex
- Int32
このインスタンスにおける部分文字列の開始位置。
- count
- Int32
部分文字列の長さです。
戻り値
startIndex
から startIndex
+ count
-1 までの範囲内で、oldChar
が newChar
に置換されたこのインスタンスへの参照。
例外
startIndex
+ count
このインスタンスの値の長さを超えています。
- または -
startIndex
または count
が 0 未満です。
注釈
このメソッドは、現在のインスタンスでの の出現箇所を識別するために、大文字と小文字を区別する序 oldChar
数の比較を実行します。 置換後、現在の StringBuilder オブジェクトのサイズは変更されません。
適用対象
Replace(String, String, Int32, Int32)
このインスタンスの部分文字列に出現するすべての指定した文字列を、別の指定した文字列に置換します。
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);
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
パラメーター
- oldValue
- String
置換する文字列。
- newValue
- String
oldValue
を置換する文字列、または null
。
- startIndex
- Int32
このインスタンスにおける部分文字列の開始位置。
- count
- Int32
部分文字列の長さです。
戻り値
startIndex
から startIndex
+ count
1 までの範囲内で、oldValue
のすべてのインスタンスが newValue
に置換されたこのインスタンスへの参照。
例外
oldValue
が null
です。
oldValue
の長さが 0 です。
startIndex
または count
が 0 未満です。
- または -
startIndex
にcount
を加算した値はこのインスタンスの範囲外の文字位置を示します。
- または -
このインスタンスの値を増やすと MaxCapacity を超えます。
注釈
このメソッドは、指定した部分文字列内の の出現箇所を識別するために、大文字と小文字を区別する序 oldValue
数の比較を実行します。 が newValue
または null
の String.Empty 場合、 の出現箇所 oldValue
はすべて削除されます。