NamedRange.Find 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Excel

어셈블리:

Microsoft.Office.Tools.Excel.dll

NamedRange 컨트롤에서 특정 정보를 찾은 다음 해당 정보가 있는 첫 번째 셀을 나타내는 Range 개체를 반환합니다.

public Microsoft.Office.Interop.Excel.Range Find (object What, object After, object LookIn, object LookAt, object SearchOrder, Microsoft.Office.Interop.Excel.XlSearchDirection SearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, object MatchCase, object MatchByte, object SearchFormat);

abstract member Find : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlSearchDirection * obj * obj * obj -> Microsoft.Office.Interop.Excel.Range

Public Function Find (What As Object, Optional After As Object, Optional LookIn As Object, Optional LookAt As Object, Optional SearchOrder As Object, Optional SearchDirection As XlSearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, Optional MatchCase As Object, Optional MatchByte As Object, Optional SearchFormat As Object) As Range

매개 변수

What

Object

검색할 데이터입니다. 문자열 또는 Microsoft Office Excel 데이터 형식일 수 있습니다.

After

Object

검색을 시작할 셀의 바로 앞 셀입니다. 사용자 인터페이스에서 검색할 경우 이것은 활성 셀의 위치에 해당됩니다. After 범위의 단일 셀이어야 합니다. 이 셀의 다음 셀부터 검색이 시작되며, 지정된 셀은 메서드가 이 셀까지 다시 돌아올 때까지 검색되지 않습니다. 이 인수를 지정하지 않으면 범위의 왼쪽 위 모퉁이에 있는 셀의 다음 셀부터 검색이 시작됩니다.

LookIn

Object

정보의 서식입니다.

LookAt

Object

XlLookAt 값인 xlWhole 또는 xlPart일 수 있습니다.

SearchOrder

Object

XlSearchOrder 값인 xlByRows 또는 xlByColumns일 수 있습니다.

SearchDirection

XlSearchDirection

검색 방향입니다. 또는 xlPrevious값 xlNext 중 XlSearchDirection 하나일 수 있습니다.

MatchCase

Object

검색에서 대/소문자를 구분하는 경우 true입니다. 기본값은 false입니다.

MatchByte

Object

더블바이트 언어 지원을 선택 또는 설치한 경우에만 사용됩니다. 더블바이트 문자를 더블바이트 문자하고만 비교하려면 true이고, 더블바이트 문자를 해당하는 싱글바이트 문자와 비교하려면 false입니다.

SearchFormat

Object

검색 서식입니다.

반환

Range

정보가 검색된 첫 번째 셀을 나타내는 Range 개체입니다.

예제

다음 코드 예제에서는 메서드를 Find 사용 하 여 첫 번째 셀 Seashell 을 찾을 값을 컨트롤입니다 NamedRange . 그런 다음, 및 FindPrevious 메서드를 FindNext 사용하여 값 Seashell 이 있는 다음 셀을 찾은 다음 원래 셀로 돌아갑니다. 마지막으로 이 예제에서는 메서드를 Cut 사용하여 첫 번째 셀의 내용을 값 Seashell 으로 잘라 B1 셀에 붙여넣습니다.

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

private void FindValue()
{
    this.Range["A1"].Value2 = "Barnacle";
    this.Range["A2"].Value2 = "Seashell";
    this.Range["A3"].Value2 = "Star Fish";
    this.Range["A4"].Value2 = "Seashell";
    this.Range["A5"].Value2 = "Clam Shell";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell",
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1"]);
}

Private Sub FindValue()
    Me.Range("A1").Value2 = "Barnacle"
    Me.Range("A2").Value2 = "Seashell"
    Me.Range("A3").Value2 = "Star Fish"
    Me.Range("A4").Value2 = "Seashell"
    Me.Range("A5").Value2 = "Clam Shell"

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

    ' Find the first occurrence of "Seashell".
    Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
        False, False, )

    ' Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1)

    ' Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1)

    ' Cut the range with the first "Seashell" and copy it to cell B1.
    Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Range1, "namedRange2")
    namedRange2.Cut(Me.Range("B1"))
End Sub

설명

일치하는 항목이 없으면 이 메서드가 를 반환 null 합니다.

이 메서드는 선택 영역 또는 활성 셀에 영향을 주지 않습니다.

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

및 FindPrevious 메서드를 FindNext 사용하여 검색을 반복할 수 있습니다.

검색이 지정된 검색 범위의 끝에 도달하면 범위의 시작 부분으로 래핑됩니다. 이 랩어라운드가 발생할 때 검색을 중지하려면 처음 찾은 셀의 주소를 저장한 다음 이 저장된 주소에 대해 연속된 각 찾기 셀 주소를 테스트합니다.

선택적 매개 변수

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