NamedRange.Replace 메서드

아티클
08/10/2011

NamedRange 컨트롤의 지정된 문자를 새 문자열로 바꿉니다.

네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
Function Replace ( _
    What As Object, _
    Replacement As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object, _
    ReplaceFormat As Object _
) As Boolean

bool Replace(
    Object What,
    Object Replacement,
    Object LookAt,
    Object SearchOrder,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat,
    Object ReplaceFormat
)

매개 변수

What
형식: System.Object
Microsoft Office Excel에서 검색할 문자열입니다.

Replacement
형식: System.Object
대체 문자열입니다.

LookAt
형식: System.Object
XlLookAt 상수인 xlWhole 또는 xlPart일 수 있습니다.

SearchOrder
형식: System.Object
XlSearchOrder 상수인 xlByRows 또는 xlByColumns일 수 있습니다.

MatchCase
형식: System.Object
검색에서 대/소문자를 구분하는 경우 true입니다.

MatchByte
형식: System.Object
Excel에서 더블바이트 언어 지원을 선택 또는 설치한 경우에만 이 인수를 사용할 수 있습니다.더블바이트 문자를 더블바이트 문자하고만 비교하려면 true이고, 더블바이트 문자를 해당하는 싱글바이트 문자와 비교하려면 false입니다.

SearchFormat
형식: System.Object
메서드의 검색 서식입니다.

ReplaceFormat
형식: System.Object
메서드의 대체 서식입니다.

반환 값

형식: System.Boolean
지정된 문자가 NamedRange 컨트롤의 셀에 있으면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드를 사용해도 선택 영역이나 활성 셀이 변경되지 않습니다.

LookAt, SearchOrder, MatchCase 및 MatchByte에 대한 설정은 이 메서드를 사용할 때마다 저장됩니다. 다음에 메서드를 호출할 때 이러한 인수의 값을 지정하지 않으면 저장된 값이 사용됩니다. 이러한 인수를 설정하면 찾기 대화 상자의 설정이 변경되며, 찾기 대화 상자의 설정을 변경하면 인수를 생략했을 때 사용되는 저장된 값이 변경됩니다. 이러한 문제를 없애려면 메서드를 사용할 때마다 이러한 인수를 명시적으로 설정해야 합니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 NamedRange 컨트롤의 셀 값을 "This is a sentence."라는 문자열로 설정한 다음 Replace 메서드를 사용하여 부분 문자열 "a"를 "my"로 바꿉니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

    Private Sub ReplaceValue()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Value2 = "This is a sentence."
        namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart, _
            Excel.XlSearchOrder.xlByColumns, False, , , )
    End Sub

private void ReplaceValue()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    namedRange1.Value2 = "This is a sentence.";
    namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
        Excel.XlSearchOrder.xlByColumns, false, missing,
        missing, missing);
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

NamedRange 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스

Share via