Udostępnij za pośrednictwem

Metoda XmlMappedRange.Find —

  • Artykuł

Wyszukuje informacje określone w XmlMappedRange kontroli i zwraca Range , oznaczającą pierwszą komórkę, gdzie znaleźć te informacje.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
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
)

Parametry

  • What
    Typ: System.Object
    Dane do wyszukiwania.Może być ciągiem lub dowolny typ danych programu Microsoft Office Excel.
  • After
    Typ: System.Object
    Komórka, po którym ma się zacząć wyszukiwanie.Odpowiada to położenie aktywnej komórki po zakończeniu wyszukiwania z interfejsu użytkownika.Należy zauważyć, że After musi być pojedynczą komórkę w zakresie.Należy pamiętać, że wyszukiwanie rozpoczyna się po tej komórki. określonej komórki nie będzie przeszukiwana, dopóki nie zostanie metoda otoczona wróć do tej komórki.Jeśli ten argument nie zostanie określony, wyszukiwanie rozpoczyna się po komórkę w lewym górnym rogu zakresu.
  • MatchCase
    Typ: System.Object
    true Aby wyszukiwać uwzględniana wielkość liter.Wartością domyślną jest false.
  • MatchByte
    Typ: System.Object
    Używane tylko wtedy, gdy wybrałeś lub zainstalowana obsługa języków określonej liczby bajtów. true znaki dwubajtowe pasuje tylko znaki dwubajtowe; falseAby dopasować ich odpowiedniki jednobajtowe znaki dwubajtowe.

Wartość zwracana

Typ: Microsoft.Office.Interop.Excel.Range
A Range , oznaczającą pierwszą komórkę, gdzie znaleźć określone informacje.

Uwagi

Ta metoda zwraca nullodwołanie o wartości null (Nothing w języku Visual Basic) Jeśli nie zostanie znaleziony.

Ta metoda nie ma wpływu na zaznaczenie aktywnej komórki.

Ustawienia dla LookIn, LookAt, SearchOrder, i MatchByte są zapisywane przy każdym użyciu tej metody.Jeśli nie określisz wartości dla tych argumentów, przy następnym wywołaniu metody zapisane wartości są używane.Ustawienie tych argumentów zmiany ustawień w oknie dialogowym Znajdź i zmianę ustawień w oknie dialogowym Znajdź zmiany zapisane wartości, które są używane, jeśli pominięto argumenty.Aby uniknąć problemów, należy ustawić następujące argumenty jawnie przy każdym użyciu tej metody.

Można użyć FindNext i FindPrevious metod, aby powtórzyć wyszukiwanie.

Przykłady

Poniższy przykład kodu ustawia wartość XmlMappedRange do ciągu "Kowalski", a następnie używa Find, FindNext, i FindPrevious metod, aby znaleźć pierwszą komórkę z łańcuchem "Kowalski".Ponieważ XmlMappedRange zawsze zawiera dokładnie jeden komórki, tej samej komórce znajduje się w każdym przypadku.W tym przykładzie kodu zakłada, że zawiera bieżący arkusz XmlMappedRange o nazwie CustomerLastNameCell.

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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

XmlMappedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel