NamedRange.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 NamedRange i zwraca obiekt reprezentujący pierwszą komórkę Range , w której znajdują się 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 znaki dwubajtowe odpowiadały tylko znakom dwubajtowym; false aby znaki dwubajtowe pasowały do ich odpowiedników jednobajtowych.

SearchFormat: Object

Format wyszukiwania.

Zwraca

Range

Range Obiekt reprezentujący pierwszą komórkę, w której znajdują się informacje.

Przykłady

W poniższym przykładzie kodu użyto Find metody , aby znaleźć pierwszą komórkę z wartością Seashell w kontrolce NamedRange . W przykładzie użyto FindNext metod i FindPrevious , aby znaleźć następną komórkę z wartością Seashell , a następnie wrócić do oryginalnej komórki. Na koniec w przykładzie użyto Cut metody , aby wyciąć zawartość pierwszej komórki z wartością Seashell i wkleić ją do komórki B1.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

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

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

Ustawienia dla 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 zapisane wartości będą używane. 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.

Aby powtórzyć wyszukiwanie, możesz użyć FindNext metod i FindPrevious .

Gdy wyszukiwanie osiągnie koniec określonego zakresu wyszukiwania, zawija się na początek zakresu. Aby zatrzymać wyszukiwanie po wystąpieniu zapętlenia, zapisz adres pierwszej znalezionej komórki, a następnie sprawdzaj każdy kolejny adres znalezionej komórki, zestawiając go z zapisanym adresem.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.

Dotyczy