String.Replace 메서드

정의

현재 문자열에서 발견되는 지정된 유니코드 문자 또는 String을 모두 지정된 다른 유니코드 문자 또는 String으로 바꾼 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified Unicode character or String in the current string are replaced with another specified Unicode character or String.

오버로드

Replace(String, String, Boolean, CultureInfo)

제공된 문화권과 대/소문자 구분을 사용하여 현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided culture and case sensitivity.

Replace(Char, Char)

현재 인스턴스의 지정된 유니코드 문자가 지정된 다른 유니코드 문자로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.

Replace(String, String)

현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.

Replace(String, String, StringComparison)

제공된 비교 유형을 사용하여 현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided comparison type.

Replace(String, String, Boolean, CultureInfo)

제공된 문화권과 대/소문자 구분을 사용하여 현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided culture and case sensitivity.

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

매개 변수

oldValue
String

바꿀 문자열입니다.The string to be replaced.

newValue
String

모든 oldValue를 바꿀 문자열입니다.The string to replace all occurrences of oldValue.

ignoreCase
Boolean

비교할 때 대/소문자를 무시하려면 true이고, 그렇지 않으면 false입니다.true to ignore casing when comparing; false otherwise.

culture
CultureInfo

비교할 때 사용할 문화권입니다.The culture to use when comparing.

반환

oldValue의 모든 인스턴스를 newValue로 바꾼다는 점을 제외하고 현재 문자열과 동일한 문자열입니다.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValue를 현재 인스턴스에서 찾을 수 없으면 메서드가 변경되지 않은 현재 인스턴스를 반환합니다.If oldValue is not found in the current instance, the method returns the current instance unchanged.

예외

oldValuenull인 경우oldValue is null.

oldValue가 빈 문자열("")입니다.oldValue is the empty string ("").

설명

newValue null되는 경우 모든 oldValue 항목이 제거 됩니다.If newValue is null, all occurrences of oldValue are removed.

참고

이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.This method does not modify the value of the current instance. 대신 oldValue의 모든 항목이 newValue으로 바뀌는 새 문자열을 반환 합니다.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

이 메서드는 제공 된 cultureignoreCase 대/소문자 구분을 사용 하 여 oldValue를 찾기 위해 검색을 수행 합니다.This method performs a search to find oldValue using the provided culture and ignoreCase case sensitivity.

이 메서드는 수정 된 문자열을 반환 하기 때문에 Replace 메서드에 대 한 연속 호출을 함께 연결 하 여 원래 문자열에서 여러 개의 대체를 수행할 수 있습니다.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. 메서드 호출 왼쪽에서 오른쪽으로 실행 됩니다.Method calls are executed from left to right. 다음 예에서는 이러한 내용을 보여 줍니다.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'

Replace(Char, Char)

현재 인스턴스의 지정된 유니코드 문자가 지정된 다른 유니코드 문자로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.

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

매개 변수

oldChar
Char

바꿀 유니코드 문자입니다.The Unicode character to be replaced.

newChar
Char

모든 oldChar을 바꿀 유니코드 문자입니다.The Unicode character to replace all occurrences of oldChar.

반환

oldChar의 모든 인스턴스를 newChar로 바꾼다는 점을 제외하고 이 인스턴스와 동일한 문자열입니다.A string that is equivalent to this instance except that all instances of oldChar are replaced with newChar. oldChar를 현재 인스턴스에서 찾을 수 없으면 메서드가 변경되지 않은 현재 인스턴스를 반환합니다.If oldChar is not found in the current instance, the method returns the current instance unchanged.

예제

다음 예제에서는 일련의 숫자 사이 있는 공백 쉼표로 대체 하 여 쉼표로 구분 된 값 목록을 만듭니다.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"

설명

이 메서드는 oldChar을 찾기 위해 서 수 (대/소문자 구분 및 문화권을 구분 하지 않음) 검색을 수행 합니다.This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldChar.

참고

이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.This method does not modify the value of the current instance. 대신 oldChar의 모든 항목이 newChar으로 바뀌는 새 문자열을 반환 합니다.Instead, it returns a new string in which all occurrences of oldChar are replaced by newChar.

이 메서드는 수정 된 문자열을 반환 하기 때문에 Replace 메서드에 대 한 연속 호출을 함께 연결 하 여 원래 문자열에서 여러 개의 대체를 수행할 수 있습니다.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. 메서드 호출 왼쪽에서 오른쪽으로 실행 됩니다.Method calls are executed from left to right. 다음 예에서는 이러한 내용을 보여 줍니다.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'

추가 정보

Replace(String, String)

현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.

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

매개 변수

oldValue
String

바꿀 문자열입니다.The string to be replaced.

newValue
String

모든 oldValue를 바꿀 문자열입니다.The string to replace all occurrences of oldValue.

반환

oldValue의 모든 인스턴스를 newValue로 바꾼다는 점을 제외하고 현재 문자열과 동일한 문자열입니다.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValue를 현재 인스턴스에서 찾을 수 없으면 메서드가 변경되지 않은 현재 인스턴스를 반환합니다.If oldValue is not found in the current instance, the method returns the current instance unchanged.

예외

oldValuenull인 경우oldValue is null.

oldValue가 빈 문자열("")입니다.oldValue is the empty string ("").

예제

다음 예제에서는 Replace 메서드를 사용 하 여 맞춤법 오류를 수정 하는 방법을 보여 줍니다.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'
'

설명

newValue null되는 경우 모든 oldValue 항목이 제거 됩니다.If newValue is null, all occurrences of oldValue are removed.

참고

이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.This method does not modify the value of the current instance. 대신 oldValue의 모든 항목이 newValue으로 바뀌는 새 문자열을 반환 합니다.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

이 메서드는 oldValue을 찾기 위해 서 수 (대/소문자 구분 및 문화권을 구분 하지 않음) 검색을 수행 합니다.This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldValue.

이 메서드는 수정 된 문자열을 반환 하기 때문에 Replace 메서드에 대 한 연속 호출을 함께 연결 하 여 원래 문자열에서 여러 개의 대체를 수행할 수 있습니다.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. 메서드 호출 왼쪽에서 오른쪽으로 실행 됩니다.Method calls are executed from left to right. 다음 예에서는 이러한 내용을 보여 줍니다.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'

추가 정보

Replace(String, String, StringComparison)

제공된 비교 유형을 사용하여 현재 인스턴스의 지정된 문자열이 지정된 다른 문자열로 모두 바뀌는 새 문자열을 반환합니다.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided comparison type.

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

매개 변수

oldValue
String

바꿀 문자열입니다.The string to be replaced.

newValue
String

모든 oldValue를 바꿀 문자열입니다.The string to replace all occurrences of oldValue.

comparisonType
StringComparison

이 인스턴스 내에서 oldValue를 검색하는 방법을 결정하는 열거형 값 중 하나입니다.One of the enumeration values that determines how oldValue is searched within this instance.

반환

oldValue의 모든 인스턴스를 newValue로 바꾼다는 점을 제외하고 현재 문자열과 동일한 문자열입니다.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. oldValue를 현재 인스턴스에서 찾을 수 없으면 메서드가 변경되지 않은 현재 인스턴스를 반환합니다.If oldValue is not found in the current instance, the method returns the current instance unchanged.

예외

oldValuenull인 경우oldValue is null.

oldValue가 빈 문자열("")입니다.oldValue is the empty string ("").

설명

newValue null되는 경우 모든 oldValue 항목이 제거 됩니다.If newValue is null, all occurrences of oldValue are removed.

참고

이 메서드는 현재 인스턴스의 값을 수정 하지 않습니다.This method does not modify the value of the current instance. 대신 oldValue의 모든 항목이 newValue으로 바뀌는 새 문자열을 반환 합니다.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

이 메서드는 comparisonType에서 설명 하는 문화권 및 대/소문자 구분을 사용 하 여 oldValue를 찾기 위해 검색을 수행 합니다.This method performs a search to find oldValue using the culture and case sensitivity described by comparisonType.

이 메서드는 수정 된 문자열을 반환 하기 때문에 Replace 메서드에 대 한 연속 호출을 함께 연결 하 여 원래 문자열에서 여러 개의 대체를 수행할 수 있습니다.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. 메서드 호출 왼쪽에서 오른쪽으로 실행 됩니다.Method calls are executed from left to right. 다음 예에서는 이러한 내용을 보여 줍니다.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'

적용 대상