다음을 통해 공유

XmlMappedRange.Find 메서드

  • 아티클

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

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

구문

‘선언
Function Find ( _
    What As Object, _
    After As Object, _
    LookIn As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    SearchDirection As XlSearchDirection, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object _
) As Range

Range Find(
    Object What,
    Object After,
    Object LookIn,
    Object LookAt,
    Object SearchOrder,
    XlSearchDirection SearchDirection,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat
)

매개 변수

  • What
    형식: System.Object
    검색할 데이터입니다.문자열 또는 Microsoft Office Excel 데이터 형식일 수 있습니다.
  • After
    형식: System.Object
    검색을 시작할 셀의 바로 앞 셀입니다.사용자 인터페이스에서 검색할 경우 이것은 활성 셀의 위치에 해당됩니다. After는 범위 내의 단일 셀이어야 합니다.이 셀의 다음 셀부터 검색이 시작되며, 지정된 셀은 메서드가 이 셀까지 다시 돌아올 때까지 검색되지 않습니다.이 인수를 지정하지 않으면 범위의 왼쪽 위 모퉁이에 있는 셀의 다음 셀부터 검색이 시작됩니다.
  • MatchCase
    형식: System.Object
    검색에서 대/소문자를 구분하는 경우 true입니다.기본값은 false입니다.
  • MatchByte
    형식: System.Object
    더블바이트 언어 지원을 선택 또는 설치한 경우에만 사용됩니다.더블바이트 문자를 더블바이트 문자하고만 비교하려면 true이고, 더블바이트 문자를 해당하는 싱글바이트 문자와 비교하려면 false입니다.

반환 값

형식: Microsoft.Office.Interop.Excel.Range
지정된 정보가 검색된 첫째 셀을 나타내는 Range입니다.

설명

일치하는 항목이 없는 경우 이 메서드는 nullNull 참조(Visual Basic의 경우 Nothing)을 반환합니다.

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

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

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

예제

다음 코드 예제에서는 XmlMappedRange의 값을 문자열 "Smith"로 설정한 다음 Find, FindNext 및 FindPrevious 메서드를 사용하여 문자열 "Smith"가 포함된 첫째 셀을 찾습니다.XmlMappedRange에는 항상 하나의 셀만 포함되어 있기 때문에 언제나 같은 셀이 검색됩니다.이 코드 예제에서는 현재 워크시트에 CustomerLastNameCell이라는 XmlMappedRange가 포함되어 있다고 가정합니다.

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

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);
}

.NET Framework 보안

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

참고 항목

참조

XmlMappedRange 인터페이스

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