Udostępnij za pośrednictwem

Metoda NamedRange.Find —

  • Artykuł

Wyszukuje informacje określone 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
    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ć z uwzględnieniem wielkości 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 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 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.

Gdy wyszukiwanie dojdzie do końca zakresu wyszukiwania, otaczająca na początek zakresu.Aby zatrzymać wyszukiwanie, gdy wystąpi to wraparound, Zapisz adres pierwszej komórki znalezionych, a następnie testować każdego kolejnych adres komórki znalezione przed tym zapisany adres.

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

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

Ten przykład dotyczy dostosowywania poziomie 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