String.Replace Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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

Aşırı Yüklemeler

Name	Description
Replace(Char, Char)	Bu örnekte belirtilen Unicode karakterinin tüm oluşumlarının belirtilen başka bir Unicode karakteriyle değiştirildiği yeni bir dize döndürür.
Replace(String, String)	Geçerli örnekte belirtilen dizenin 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 bir 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

Bu örnekte belirtilen Unicode karakterinin tüm oluşumlarının belirtilen başka bir 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şmeden döndürür.

Örnekler

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

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.

Note

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ştirilen dizeyi döndürdüğünden, özgün dizede birden çok değiştirme gerçekleştirmek için Replace yöntemine 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.

• Char
• Concat(Object)
• Insert(Int32, String)
• Join(String, String[])
• Remove(Int32, Int32)
• Split(Char[])
• Substring(Int32)
• Trim(Char[])

Replace(String, String)

Kaynak:

String.Manipulation.cs

Geçerli örnekte belirtilen dizenin 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);

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şmeden döndürür.

Özel durumlar

ArgumentNullException

oldValue, null'e eşittir.

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.

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.

Note

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.

Bu yöntem değiştirilen dizeyi döndürdüğünden, özgün dizede birden çok değiştirme gerçekleştirmek için Replace yöntemine 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 = "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.

• Concat(Object)
• Insert(Int32, String)
• Join(String, String[])
• Remove(Int32, Int32)
• Split(Char[])
• Substring(Int32)
• Trim(Char[])

Replace(String, String, StringComparison)

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

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

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şmeden döndürür.

Özel durumlar

ArgumentNullException

oldValue, null'e eşittir.

ArgumentException

oldValue boş dizedir ("").

Açıklamalar

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

Note

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 oldValueaçıklanan kültür ve büyük/küçük harf duyarlılığını kullanarak bulmak comparisonType için bir arama gerçekleştirir.

Bu yöntem değiştirilen dizeyi döndürdüğünden, özgün dizede birden çok değiştirme gerçekleştirmek için Replace yöntemine 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 = "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)

Kaynak:

String.Manipulation.cs

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

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ırma yaparken büyük/küçük harfe almayı yoksaymak; false Aksi takdir -de.

culture

CultureInfo

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

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şmeden döndürür.

Özel durumlar

ArgumentNullException

oldValue, null'e eşittir.

ArgumentException

oldValue boş dizedir ("").

Açıklamalar

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

Note

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 oldValue ve culture büyük/küçük harf duyarlılığını kullanarak bulmak ignoreCase için bir arama gerçekleştirir.

Bu yöntem değiştirilen dizeyi döndürdüğünden, özgün dizede birden çok değiştirme gerçekleştirmek için Replace yöntemine 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 = "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'