NamedRange.Find Metoda

Definice

Obor názvů:

Microsoft.Office.Tools.Excel

Sestavení:

Microsoft.Office.Tools.Excel.dll

Vyhledá v ovládacím NamedRange prvku konkrétní informace a vrátí Range objekt, který představuje první buňku, ve které jsou informace nalezeny.

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

Data, která chcete vyhledat. Může to být řetězec nebo libovolný datový typ Microsoft Office Excelu.

After

Object

Buňka, za kterou má hledání začít. To odpovídá umístění aktivní buňky při vyhledávání z uživatelského rozhraní. Všimněte si, že After musí být jedna buňka v oblasti. Mějte na paměti, že hledání začne za touto buňkou; zadaná buňka není prohledána, dokud se metoda zase k této buňce nevrátí. Pokud tento argument nezadáte, začne hledání za buňkou v levém horním rohu oblasti.

LookIn

Object

Typ informací.

LookAt

Object

Může mít jednu z následujících XlLookAt hodnot: xlWhole nebo xlPart.

SearchOrder

Object

Může mít jednu z následujících XlSearchOrder hodnot: xlByRows nebo xlByColumns.

SearchDirection

XlSearchDirection

Směr hledání Může mít jednu z následujících XlSearchDirection hodnot: xlNext nebo xlPrevious.

MatchCase

Object

true , aby se v hledání rozlišovala malá a velká písmena. Výchozí hodnota je false.

MatchByte

Object

Používá se pouze v případě, že jste vybrali nebo nainstalovali podporu dvoubabajtů jazyka. true dvoubavové znaky odpovídají pouze dvoubavovým znakům; false dvoubajtové znaky odpovídají jejich jednobajtovým ekvivalentům.

SearchFormat

Object

Formát hledání.

Návraty

Range

Objekt Range , který představuje první buňku, ve které jsou nalezeny informace.

Příklady

Následující příklad kódu používá metodu Find k vyhledání první buňky s hodnotou Seashell v ovládacím prvku NamedRange . Příklad pak pomocí FindNext metod a FindPrevious najde další buňku s hodnotou Seashell a vrátí se k původní buňce. Nakonec příklad používá metodu Cut k vyjmutí obsahu první buňky s hodnotou Seashell a jejímu vložení do buňky B1.

Tento příklad je pro přizpůsobení na úrovni 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

Poznámky

Tato metoda vrátí null , pokud není nalezena žádná shoda.

Tato metoda nemá vliv na výběr nebo aktivní buňku.

Nastavení pro LookIn, , LookAtSearchOrdera MatchByte se uloží při každém použití této metody. Pokud nezadáte hodnoty pro tyto argumenty při příštím volání metody, použijí se uložené hodnoty. Nastavením těchto argumentů se změní nastavení v dialogovém okně Najít a změnou nastavení v dialogovém okně Najít se změní uložené hodnoty, které se použijí, pokud argumenty vynecháte. Aby nedocházelo k problémům, nastavte tyto argumenty explicitně při každém použití této metody.

K opakování hledání můžete použít FindNext metody a FindPrevious .

Když hledání dosáhne konce zadaného rozsahu hledání, zalomí se kolem začátku rozsahu. Chcete-li zastavit vyhledávání pro vrácení zpět na začátek, uložte adresu první nalezené buňky a na základě ní otestujte adresu všech následně nalezených buněk.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro systém Office.