XmlMappedRange.Find Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Excel

Zestaw:: Microsoft.Office.Tools.Excel.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Znajduje określone informacje w kontrolce XmlMappedRange i zwraca wartość reprezentującą Range pierwszą komórkę, w której znaleziono te informacje.

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

Parametry

What: Object

Dane do wyszukania. Może być ciągiem lub dowolnym typem danych programu Microsoft Office Excel.

After: Object

Komórka, po której chcesz rozpocząć wyszukiwanie. Odpowiada to położeniu aktywnej komórki, gdy wyszukiwanie jest wykonywane z interfejsu użytkownika. Należy pamiętać, że After musi być pojedynczą komórką w zakresie. Należy pamiętać, że wyszukiwanie nie zaczyna się bezpośrednio od tej komórki; dana komórka nie zostanie przeszukana, dopóki metoda nie zawinie się i nie wróci do tej komórki. Jeśli ten argument nie zostanie określony, wyszukiwanie rozpocznie się po komórce w lewym górnym rogu zakresu.

LookIn: Object

Typ informacji.

LookAt: Object

Może być jedną z następujących XlLookAt wartości: xlWhole lub xlPart.

SearchOrder: Object

Może być jedną z następujących XlSearchOrder wartości: xlByRows lub xlByColumns.

SearchDirection: XlSearchDirection

Kierunek wyszukiwania. Może być jedną z następujących XlSearchDirection wartości: xlNext lub xlPrevious.

MatchCase: Object

true aby uwzględniać wielkość liter wyszukiwania. Wartość domyślna to false.

MatchByte: Object

Używane tylko w przypadku wybrania lub zainstalowania obsługi języków dwubajtowych. true aby mieć znaki dwubajtowe pasują tylko do znaków dwubajtowych; false aby znaki dwubajtowe odpowiadały ich odpowiednikom jednobajtowym.

SearchFormat: Object

Format wyszukiwania.

Zwraca

Range

Element Range reprezentujący pierwszą komórkę, w której znaleziono określone informacje.

Przykłady

Poniższy przykład kodu ustawia wartość XmlMappedRange ciągu "Smith", a następnie używa Findmetod , FindNexti FindPrevious , aby znaleźć pierwszą komórkę z ciągiem "Smith". XmlMappedRange Ponieważ zawsze zawiera dokładnie jedną komórkę, w każdym przypadku znajduje się ta sama komórka. W tym przykładzie kodu przyjęto założenie, że bieżący arkusz zawiera XmlMappedRange nazwę CustomerLastNameCell.

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

Uwagi

Ta metoda zwraca wartość null , jeśli nie znaleziono dopasowania.

Ta metoda nie wpływa na wybór lub aktywną komórkę.

Ustawienia , LookIn, LookAtSearchOrderi MatchByte są zapisywane za każdym razem, gdy używasz tej metody. Jeśli nie określisz wartości dla tych argumentów, przy następnym wywołaniu metody zostaną użyte zapisane wartości. Ustawienie tych argumentów zmienia ustawienia w oknie dialogowym Znajdowanie, a zmiana ustawień w oknie dialogowym Znajdowanie zmienia zapisane wartości, które są używane, jeśli pominięto argumenty. Aby uniknąć problemów, ustawiaj jawnie argumenty za każdym razem, gdy korzystasz z tej metody.

Metody i FindPrevious umożliwiają Microsoft.Office.Interop.Excel.Range.FindNext* powtórzenie wyszukiwania.

Dotyczy

Udostępnij za pośrednictwem