String.Replace Yöntem

Tanım

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

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

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

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

oldValue, null değeridir.

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.

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 = "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

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

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

oldValue, null değeridir.

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.

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 = "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

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

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

oldValue, null değeridir.

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.

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 = "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