String.Replace Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen bir Unicode karakterinin veya String geçerli dizedeki tüm oluşumlarının başka bir belirtilen Unicode karakteri veya Stringile değiştirildiği yeni bir dize döndürür.

Aşırı Yüklemeler

Replace(Char, Char)	Bu örnekte belirtilen Unicode karakterinin tüm oluşumlarının başka bir belirtilen Unicode karakteriyle değiştirildiği yeni bir dize döndürür.
Replace(String, String)	Belirtilen dizenin geçerli örnekteki tüm oluşumlarının başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.
Replace(String, String, StringComparison)	Belirtilen dizenin geçerli örnekteki tüm oluşumlarının, sağlanan karşılaştırma türü kullanılarak başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.
Replace(String, String, Boolean, CultureInfo)	Belirtilen dizenin geçerli örnekteki tüm oluşumlarının, sağlanan kültür ve büyük/küçük harf duyarlılığı kullanılarak başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.

Replace(Char, Char)

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Bu örnekte belirtilen Unicode karakterinin tüm oluşumlarının başka bir belirtilen Unicode karakteriyle değiştirildiği yeni bir dize döndürür.

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

Parametreler

oldChar: Char

Değiştirilecek Unicode karakteri.

newChar: Char

Tüm oluşumlarını oldChardeğiştirmek için Unicode karakteri.

Döndürülenler

String

Tüm örneklerinin oldChar ile newChardeğiştirilmesi dışında bu örneğe eşdeğer bir dize. Geçerli örnekte bulunamazsa oldChar , yöntemi geçerli örneği değiştirmeden döndürür.

Örnekler

Aşağıdaki örnek, bir sayı dizisi arasındaki boşluklar için virgüller girerek bir virgülle ayrılmış değer listesi oluşturur.

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"

Açıklamalar

Bu yöntem, bulmak oldChariçin sıralı (büyük/küçük harfe duyarlı ve kültüre duyarlı olmayan) bir arama gerçekleştirir.

Not

Bu yöntem, geçerli örneğin değerini değiştirmez. Bunun yerine, tüm oluşumlarının oldChar ile newChardeğiştirildiği yeni bir dize döndürür.

Bu yöntem değiştirilmiş dizeyi döndürdüğünden, özgün dizede birden çok değiştirme gerçekleştirmek için yöntemine Replace ardışık çağrıları zincirleyebilirsiniz. Yöntem çağrıları soldan sağa yürütülür. Aşağıdaki örnek, bir gösterim sağlar.

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'

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.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(String, String)

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Belirtilen dizenin geçerli örnekteki tüm oluşumlarının başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.

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

Parametreler

oldValue: String

Değiştirilecek dize.

newValue: String

tüm oluşumlarını oldValuedeğiştirmek için dize.

Döndürülenler

String

Tüm örneklerinin oldValue ile değiştirilmesi dışında geçerli dizeye newValueeşdeğer bir dize. Geçerli örnekte bulunamazsa oldValue , yöntemi geçerli örneği değiştirmeden döndürür.

Özel durumlar

ArgumentNullException

oldValue, null değeridir.

ArgumentException

oldValue boş dizedir ("").

Örnekler

Aşağıdaki örnekte, bir yazım hatasını Replace düzeltmek için yöntemini nasıl kullanabileceğiniz gösterilmektedir.

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

Açıklamalar

ise newValuenull, öğesinin oldValue tüm oluşumları kaldırılır.

Not

Bu yöntem, geçerli örneğin değerini değiştirmez. Bunun yerine, tüm oluşumlarının oldValue ile newValuedeğiştirildiği yeni bir dize döndürür.

Bu yöntem, bulmak oldValueiçin sıralı (büyük/küçük harfe duyarlı ve kültüre duyarlı olmayan) bir arama gerçekleştirir.

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'

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.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(String, String, StringComparison)

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Belirtilen dizenin geçerli örnekteki tüm oluşumlarının, sağlanan karşılaştırma türü kullanılarak başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.

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

Parametreler

oldValue: String

Değiştirilecek dize.

newValue: String

tüm oluşumlarını oldValuedeğiştirmek için dize.

comparisonType: StringComparison

Bu örnekte nasıl oldValue arandığını belirleyen numaralandırma değerlerinden biri.

Döndürülenler

String

Özel durumlar

ArgumentNullException

oldValue, null değeridir.

ArgumentException

oldValue boş dizedir ("").

Açıklamalar

ise newValuenull, öğesinin oldValue tüm oluşumları kaldırılır.

Not

Bu yöntem, geçerli örneğin değerini değiştirmez. Bunun yerine, tüm oluşumlarının oldValue ile newValuedeğiştirildiği yeni bir dize döndürür.

Bu yöntem, tarafından comparisonTypeaçıklanan kültür ve büyük/küçük harf duyarlılığını kullanarak bulmak oldValue için bir arama gerçekleştirir.

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'

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Replace(String, String, Boolean, CultureInfo)

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Kaynak:: String.Manipulation.cs

Belirtilen dizenin geçerli örnekteki tüm oluşumlarının, sağlanan kültür ve büyük/küçük harf duyarlılığı kullanılarak başka bir belirtilen dizeyle değiştirildiği yeni bir dize döndürür.

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

Parametreler

oldValue: String

Değiştirilecek dize.

newValue: String

tüm oluşumlarını oldValuedeğiştirmek için dize.

ignoreCase: Boolean

true karşılaştırırken büyük/küçük harfe göre sıralamayı yoksaymak için; false Aksi takdir -de.

culture: CultureInfo

Karşılaştırırken kullanılacak kültür. ise culturenull, geçerli kültür kullanılır.

Döndürülenler

String

Özel durumlar

ArgumentNullException

oldValue, null değeridir.

ArgumentException

oldValue boş dizedir ("").

Açıklamalar

ise newValuenull, öğesinin oldValue tüm oluşumları kaldırılır.

Not

Bu yöntem, geçerli örneğin değerini değiştirmez. Bunun yerine, tüm oluşumlarının oldValue ile newValuedeğiştirildiği yeni bir dize döndürür.

Bu yöntem, sağlanan culture ve ignoreCase büyük/küçük harf duyarlılığını kullanarak bulmak oldValue için bir arama gerçekleştirir.

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'

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Aracılığıyla paylaş

String.Replace Yöntem

Tanım

Aşırı Yüklemeler

Replace(Char, Char)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Replace(String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Replace(String, String, StringComparison)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Replace(String, String, Boolean, CultureInfo)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar