String.Replace Yöntem

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

Döndürülenler

String

Tüm örneklerinin değiştirilmesinin dışında geçerli dize ile eşdeğer bir dize oldValue newValue .A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValueGeçerli örnekte bulunamazsa, yöntemi geçerli örneği değiştirilmemiş olarak döndürür.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Özel durumlar

Açıklamalar

newValueİse null , tüm oluşumları oldValue kaldırılır.If newValue is null, all occurrences of oldValue are removed.

Bu yöntem oldValue , belirtilen culture ve ignoreCase büyük/küçük harf duyarlılığı kullanarak bulmak için bir arama gerçekleştirir.This method performs a search to find oldValue using the provided culture and ignoreCase case sensitivity.

Bu yöntem değiştirilmiş dizeyi döndürdüğünden, Replace özgün dizede birden fazla değişiklik gerçekleştirmek için yöntemine birbirini izleyen çağrıları birlikte zincirleyebilirsiniz.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Yöntem çağrıları soldan sağa yürütülür.Method calls are executed from left to right. Aşağıdaki örnek, bir gösterim sağlar.The following example provides an illustration.

String s = "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);

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

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

Döndürülenler

String

Tüm örneklerinin değiştirilmesinin dışında, bu örneğe eşdeğer bir dize oldChar newChar .A string that is equivalent to this instance except that all instances of oldChar are replaced with newChar. oldCharGeçerli örnekte bulunamazsa, yöntemi geçerli örneği değiştirilmemiş olarak döndürür.If oldChar is not found in the current instance, the method returns the current instance unchanged.

Örnekler

Aşağıdaki örnek, bir dizi sayı arasındaki boşluklar için virgül koyarak virgülle ayrılmış bir değer listesi oluşturur.The following example creates a comma separated value list by substituting commas for the blanks between a series of numbers.

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

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, bulunacak bir sıra (büyük/küçük harfe duyarlı ve kültüre duyarsız) araması gerçekleştirir oldChar .This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldChar.

Bu yöntem değiştirilmiş dizeyi döndürdüğünden, Replace özgün dizede birden fazla değişiklik gerçekleştirmek için yöntemine birbirini izleyen çağrıları birlikte zincirleyebilirsiniz.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Yöntem çağrıları soldan sağa yürütülür.Method calls are executed from left to right. Aşağıdaki örnek, bir gösterim sağlar.The following example provides an illustration.

String s = new String('a', 3);
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);

// 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[])

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

Döndürülenler

String

Tüm örneklerinin değiştirilmesinin dışında geçerli dize ile eşdeğer bir dize oldValue newValue .A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValueGeçerli örnekte bulunamazsa, yöntemi geçerli örneği değiştirilmemiş olarak döndürür.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Özel durumlar

Örnekler

Aşağıdaki örnek, Replace bir yazım hatasını düzeltmek için yöntemini nasıl kullanabileceğinizi gösterir.The following example demonstrates how you can use the Replace method to correct a spelling error.

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:{0}'{1}'{0}", Environment.NewLine, errString);

// Correct the spelling of "document".

string correctString = errString.Replace("docment", "document");

Console.WriteLine("After correcting the string, the result is:{0}'{1}'",
        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

newValueİse null , tüm oluşumları oldValue kaldırılır.If newValue is null, all occurrences of oldValue are removed.

Bu yöntem, bulunacak bir sıra (büyük/küçük harfe duyarlı ve kültüre duyarsız) araması gerçekleştirir oldValue .This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldValue.

Bu yöntem değiştirilmiş dizeyi döndürdüğünden, Replace özgün dizede birden fazla değişiklik gerçekleştirmek için yöntemine birbirini izleyen çağrıları birlikte zincirleyebilirsiniz.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Yöntem çağrıları soldan sağa yürütülür.Method calls are executed from left to right. Aşağıdaki örnek, bir gösterim sağlar.The following example provides an illustration.

String s = "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);

// 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[])

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

Döndürülenler

String

Tüm örneklerinin değiştirilmesinin dışında geçerli dize ile eşdeğer bir dize oldValue newValue .A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValueGeçerli örnekte bulunamazsa, yöntemi geçerli örneği değiştirilmemiş olarak döndürür.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Özel durumlar

Açıklamalar

newValueİse null , tüm oluşumları oldValue kaldırılır.If newValue is null, all occurrences of oldValue are removed.

Bu yöntem oldValue , tarafından tanımlanan kültür ve büyük/küçük harf duyarlılığı kullanarak bulmak için bir arama gerçekleştirir comparisonType .This method performs a search to find oldValue using the culture and case sensitivity described by comparisonType.

Bu yöntem değiştirilmiş dizeyi döndürdüğünden, Replace özgün dizede birden fazla değişiklik gerçekleştirmek için yöntemine birbirini izleyen çağrıları birlikte zincirleyebilirsiniz.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Yöntem çağrıları soldan sağa yürütülür.Method calls are executed from left to right. Aşağıdaki örnek, bir gösterim sağlar.The following example provides an illustration.

String s = "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);

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