다음을 통해 공유

XmlMappedRange.Find 메서드

  • 참조

정의

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

XmlMappedRange 컨트롤에서 특정 정보를 찾은 다음 해당 정보가 있는 첫째 셀을 나타내는 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입니다.

예제

다음 코드 예제에서는 의 값을 XmlMappedRange 문자열 "Smith"로 설정한 다음 , FindNext및 FindPrevious 메서드를 사용하여 Find문자열 "Smith"가 있는 첫 번째 셀을 찾습니다. 는 XmlMappedRange 항상 정확히 하나의 셀을 포함하므로 각 경우에 동일한 셀이 있습니다. 이 코드 예제에서는 현재 워크시트에 라는 가 CustomerLastNameCell포함되어 있다고 XmlMappedRange 가정합니다.

private void FindSmith()
{
    this.CustomerLastNameCell.Value2 = "Smith";

    // Use Find to get the range with "Smith".
    Excel.Range range1 = this.CustomerLastNameCell.Find("Smith",
        Excel.XlSearchDirection.xlNext);
    string address1 = range1.get_Address(missing, missing,
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("Find method found the range: " + address1);

    // Use FindNext to get the range with "Smith".
    Excel.Range range2 = this.CustomerLastNameCell.FindNext(range1);
    string address2 = range2.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindNext method found the range: " + address2);

    // Use FindPrevious to get the range with "Smith".
    Excel.Range range3 = this.CustomerLastNameCell.FindPrevious(range2);
    string address3 = range3.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindPrevious method found the range: " + address3);
}

Private Sub FindSmith()
    Me.CustomerLastNameCell.Value2 = "Smith"

    ' Use Find to get the range with "Smith".
    Dim range1 As Excel.Range = Me.CustomerLastNameCell.Find( _
        "Smith", SearchDirection:=Excel.XlSearchDirection.xlNext)
    Dim address1 As String = range1.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("Find method found the range: " & address1)

    ' Use FindNext to get the range with "Smith".
    Dim range2 As Excel.Range = Me.CustomerLastNameCell.FindNext(range1)
    Dim address2 As String = range2.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindNext method found the range: " & address2)

    ' Use FindPrevious to get the range with "Smith".
    Dim range3 As Excel.Range = Me.CustomerLastNameCell.FindPrevious(range2)
    Dim address3 As String = range3.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindPrevious method found the range: " & address3)
End Sub

설명

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

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

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

및 FindPrevious 메서드를 Microsoft.Office.Interop.Excel.Range.FindNext* 사용하여 검색을 반복할 수 있습니다.

적용 대상