String.Replace メソッド

定義

名前空間:: System

アセンブリ:: mscorlib.dll, System.Runtime.dll

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の文字列で指定した Unicode 文字または String のすべての出現箇所が、別の指定した Unicode 文字または Stringに置き換えられる新しい文字列を返します。

オーバーロード

名前	説明
Replace(Char, Char)	このインスタンスで指定した Unicode 文字のすべての出現箇所が、別の指定された Unicode 文字に置き換えられる新しい文字列を返します。
Replace(String, String)	現在のインスタンス内の指定した文字列のすべての出現箇所が、別の指定した文字列に置き換えられる新しい文字列を返します。
Replace(Rune, Rune)
Replace(String, String, StringComparison)	指定された比較型を使用して、現在のインスタンス内の指定された文字列のすべての出現箇所を別の指定された文字列に置き換える新しい文字列を返します。
Replace(String, String, Boolean, CultureInfo)	指定されたカルチャと大文字と小文字の区別を使用して、現在のインスタンス内の指定された文字列のすべての出現箇所を別の指定された文字列に置き換える新しい文字列を返します。

Replace(Char, Char)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

このインスタンスで指定した Unicode 文字のすべての出現箇所が、別の指定された 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

パラメーター

oldChar: Char

置換する Unicode 文字。

newChar: Char

oldCharのすべての出現箇所を置き換える Unicode 文字。

返品

String

oldCharのすべてのインスタンスがnewCharに置き換えられる点を除き、このインスタンスと同等の文字列。 oldCharが現在のインスタンスで見つからない場合、メソッドは現在のインスタンスを変更せずに返します。

例

次の例では、一連の数値の間に空白のコンマを置き換えて、コンマ区切り値リストを作成します。

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"

注釈

このメソッドは、序数 (大文字と小文字が区別され、カルチャを区別しない) 検索を実行して、 oldCharを検索します。

Note

このメソッドは、現在のインスタンスの値を変更しません。代わりに、 oldChar のすべての出現箇所が newCharに置き換えられる新しい文字列が返されます。

このメソッドは変更された文字列を返すので、 Replace メソッドの連続する呼び出しを連結して、元の文字列に対して複数の置換を実行できます。メソッド呼び出しは左から右に実行されます。具体的な例を次に示します。

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'

こちらもご覧ください

適用対象

Replace(String, String)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

現在のインスタンス内の指定した文字列のすべての出現箇所が、別の指定した文字列に置き換えられる新しい文字列を返します。

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

public string Replace(string oldValue, 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

パラメーター

oldValue: String

置換する文字列。

newValue: String

oldValueのすべての出現箇所を置き換える文字列。

返品

String

oldValueのすべてのインスタンスがnewValueに置き換えられる点を除き、現在の文字列と同等の文字列。 oldValueが現在のインスタンスで見つからない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

ArgumentNullException

oldValue は nullです。

ArgumentException

oldValue は空の文字列 ("") です。

例

次の例では、 Replace メソッドを使用してスペルミスを修正する方法を示します。

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

注釈

newValueがnullの場合は、oldValueのすべての出現箇所が削除されます。

Note

このメソッドは、現在のインスタンスの値を変更しません。代わりに、 oldValue のすべての出現箇所が newValueに置き換えられる新しい文字列が返されます。

このメソッドは、序数 (大文字と小文字が区別され、カルチャを区別しない) 検索を実行して、 oldValueを検索します。

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'

こちらもご覧ください

適用対象

Replace(Rune, Rune)

ソース:: String.Manipulation.cs

public:
 System::String ^ Replace(System::Text::Rune oldRune, System::Text::Rune newRune);

public string Replace(System.Text.Rune oldRune, System.Text.Rune newRune);

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

Public Function Replace (oldRune As Rune, newRune As Rune) As String

パラメーター

oldRune: Rune

newRune: Rune

返品

String

適用対象

Replace(String, String, StringComparison)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

指定された比較型を使用して、現在のインスタンス内の指定された文字列のすべての出現箇所を別の指定された文字列に置き換える新しい文字列を返します。

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

public string Replace(string oldValue, 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

パラメーター

oldValue: String

置換する文字列。

newValue: String

oldValueのすべての出現箇所を置き換える文字列。

comparisonType: StringComparison

このインスタンス内での oldValue の検索方法を決定する列挙値の 1 つ。

返品

String

例外

ArgumentNullException

oldValue は nullです。

ArgumentException

oldValue は空の文字列 ("") です。

注釈

newValueがnullの場合は、oldValueのすべての出現箇所が削除されます。

Note

このメソッドは、comparisonTypeで説明されているカルチャおよび大文字と小文字の区別を使用して、oldValueを検索します。

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'

適用対象

Replace(String, String, Boolean, CultureInfo)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

指定されたカルチャと大文字と小文字の区別を使用して、現在のインスタンス内の指定された文字列のすべての出現箇所を別の指定された文字列に置き換える新しい文字列を返します。

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);

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

パラメーター

oldValue: String

置換する文字列。

newValue: String

oldValueのすべての出現箇所を置き換える文字列。

ignoreCase: Boolean

true 比較時に大文字と小文字の区別を無視する場合。それ以外の場合 false 。

culture: CultureInfo

比較するときに使用するカルチャ。 culture が null の場合は、現在のカルチャが使用されます。

返品

String

例外

ArgumentNullException

oldValue は nullです。

ArgumentException

oldValue は空の文字列 ("") です。

注釈

newValueがnullの場合は、oldValueのすべての出現箇所が削除されます。

Note

このメソッドは、指定されたcultureおよびignoreCaseの大文字と小文字の区別を使用して、oldValueを検索します。

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'

適用対象

フィードバック

このページはお役に立ちましたか?