Udostępnij za pośrednictwem

Metoda NamedRange.Find —

  • Artykuł

Odnajduje określone informacje w NamedRange kontroli i zwraca Microsoft.Office.Interop.Excel.Range obiekt, który reprezentuje 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
    Aby wyszukać dane.Może być ciągiem lub dowolny typ danych programu Microsoft Office Excel.
  • After
    Typ: System.Object
    Komórka, po którym ma się rozpocząć 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ę od tej komórki. nie była przeszukiwana określonej komórki, dopóki 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 podczas wyszukiwania rozróżniana wielkość liter.Wartością domyślną jest false.
  • MatchByte
    Typ: System.Object
    Używane tylko wtedy, gdy obsługa języka znaków dwubajtowych zainstalowany lub wybrany. true znaki dwubajtowe pasuje tylko znaki dwubajtowe; falseAby dopasować ich odpowiedniki jednobajtowe znaki dwubajtowe.

Wartość zwracana

Typ: Microsoft.Office.Interop.Excel.Range
A Microsoft.Office.Interop.Excel.Range obiekt, który reprezentuje pierwszą komórkę, gdzie znaleźć informacje.

Uwagi

Ta metoda zwraca nullodwołanie o wartości null (Nothing w języku Visual Basic) , jeśli nie znaleziono.

Ta metoda nie wpływa na wybór lub 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 zmiana ustawień w oknie dialogowym Znajdź zmiany zapisane wartości, które są używane, jeśli pominięto argumenty.Aby uniknąć problemów, ustawić następujące argumenty jawnie każdym użyciu tej metody.

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

Gdy wyszukiwanie dojdzie do końca zakresu wyszukiwania, otaczająca początek zakresu.Aby zatrzymać wyszukiwanie po wystąpieniu tego wraparound, Zapisz adres pierwszej komórki znalezione, a następnie przetestuj każdy kolejnych adres komórki znalezione przed tym zapisany adres.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Następujący kod w przykładzie wykorzystano Find Metoda znajdowania pierwszą komórkę z wartością Seashell w NamedRange kontroli.Następnie w przykładzie FindNext i FindPrevious metod, aby znaleźć następną komórkę z wartością Seashell , a następnie powrócić do oryginalnego komórki.Wreszcie, w przykładzie użyto Cut sposobu na wycinanie zawartości pierwszej komórki z wartością muszli i wklej go w komórce B1.

W tym przykładzie jest dla dostosowania poziomu dokumentu.

    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


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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel