String.Replace Metode

Referensi

Definisi

Ruang nama:: System

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan string baru di mana semua kemunculan karakter Unicode tertentu atau String dalam string saat ini diganti dengan karakter Unicode lain yang ditentukan atau String.

Overload

Replace(Char, Char)	Mengembalikan string baru di mana semua kemunculan karakter Unicode tertentu dalam instans ini diganti dengan karakter Unicode lain yang ditentukan.
Replace(String, String)	Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan.
Replace(String, String, StringComparison)	Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan, menggunakan jenis perbandingan yang disediakan.
Replace(String, String, Boolean, CultureInfo)	Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan, menggunakan budaya dan sensitivitas huruf besar/kecil yang disediakan.

Replace(Char, Char)

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Mengembalikan string baru di mana semua kemunculan karakter Unicode tertentu dalam instans ini diganti dengan karakter Unicode lain yang ditentukan.

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

Parameter

oldChar: Char

Karakter Unicode yang akan diganti.

newChar: Char

Karakter Unicode untuk menggantikan semua kemunculan oldChar.

Mengembalikan

String

String yang setara dengan instans ini kecuali bahwa semua instans oldChar diganti dengan newChar. Jika oldChar tidak ditemukan dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Contoh

Contoh berikut membuat daftar nilai yang dipisahkan koma dengan mengganti koma untuk kosong di antara serangkaian angka.

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: \"{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"

Keterangan

Metode ini melakukan pencarian ordinal (peka huruf besar/kecil dan budaya) untuk menemukan oldChar.

Catatan

Metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru di mana semua kemunculan oldChar digantikan oleh newChar.

Karena metode ini mengembalikan string yang dimodifikasi, Anda dapat menyautkan panggilan berturut-turut ke Replace metode untuk melakukan beberapa penggantian pada string asli. Panggilan metode dijalankan dari kiri ke kanan. Contoh berikut memberikan ilustrasi.

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'

Lihat juga

Berlaku untuk

Replace(String, String)

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan.

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

Parameter

oldValue: String

String yang akan diganti.

newValue: String

String untuk menggantikan semua kemunculan oldValue.

Mengembalikan

String

String yang setara dengan string saat ini kecuali bahwa semua instans oldValue diganti dengan newValue. Jika oldValue tidak ditemukan dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

ArgumentNullException

oldValueadalah null.

ArgumentException

oldValue adalah string kosong ("").

Contoh

Contoh berikut menunjukkan bagaimana Anda dapat menggunakan Replace metode untuk memperbaiki kesalahan ejaan.

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

Keterangan

Jika newValue adalah null, semua kemunculan oldValue dihapus.

Catatan

Metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru di mana semua kemunculan oldValue digantikan oleh newValue.

Metode ini melakukan pencarian ordinal (peka huruf besar/kecil dan budaya) untuk menemukan 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'

Lihat juga

Berlaku untuk

Replace(String, String, StringComparison)

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan, menggunakan jenis perbandingan yang disediakan.

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

Parameter

oldValue: String

String yang akan diganti.

newValue: String

String untuk menggantikan semua kemunculan oldValue.

comparisonType: StringComparison

Salah satu nilai enumerasi yang menentukan cara oldValue dicari dalam instans ini.

Mengembalikan

String

Pengecualian

ArgumentNullException

oldValueadalah null.

ArgumentException

oldValue adalah string kosong ("").

Keterangan

Jika newValue adalah null, semua kemunculan oldValue dihapus.

Catatan

Metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru di mana semua kemunculan oldValue digantikan oleh newValue.

Metode ini melakukan pencarian untuk menemukan oldValue menggunakan budaya dan sensitivitas kasus yang dijelaskan oleh comparisonType.

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'

Berlaku untuk

Replace(String, String, Boolean, CultureInfo)

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Sumber:: String.Manipulation.cs

Mengembalikan string baru di mana semua kemunculan string tertentu dalam instans saat ini diganti dengan string lain yang ditentukan, menggunakan budaya dan sensitivitas huruf besar/kecil yang disediakan.

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

Parameter

oldValue: String

String yang akan diganti.

newValue: String

String untuk menggantikan semua kemunculan oldValue.

ignoreCase: Boolean

true untuk mengabaikan casing saat membandingkan; false Sebaliknya.

culture: CultureInfo

Budaya yang digunakan saat membandingkan. Jika culture adalah null, budaya saat ini digunakan.

Mengembalikan

String

Pengecualian

ArgumentNullException

oldValueadalah null.

ArgumentException

oldValue adalah string kosong ("").

Keterangan

Jika newValue adalah null, semua kemunculan oldValue dihapus.

Catatan

Metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru di mana semua kemunculan oldValue digantikan oleh newValue.

Metode ini melakukan pencarian untuk menemukan oldValue menggunakan sensitivitas yang disediakan culture dan ignoreCase huruf besar/kecil.

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'

Berlaku untuk

Bagikan melalui

String.Replace Metode

Definisi

Overload

Replace(Char, Char)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Replace(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Replace(String, String, StringComparison)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Replace(String, String, Boolean, CultureInfo)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: