XmlMappedRange.Find Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Excel

Sestavení:: Microsoft.Office.Tools.Excel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vyhledá v ovládacím prvku XmlMappedRange konkrétní informace a vrátí hodnotu , Range 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 byla malá a velká písmena vyhledávání citlivá. 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

A Range představující první buňku, ve které jsou nalezeny zadané informace.

Příklady

Následující příklad kódu nastaví hodnotu XmlMappedRange na řetězec "Smith" a pak použije Findmetody , FindNexta FindPrevious k vyhledání první buňky s řetězcem "Smith". Protože objekt XmlMappedRange vždy obsahuje přesně jednu buňku, najde se v každém případě stejná buňka. Tento příklad kódu předpokládá, že aktuální list obsahuje objekt s XmlMappedRange názvem 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

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 se použijí 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 Microsoft.Office.Interop.Excel.Range.FindNext* metody a FindPrevious .

Platí pro

Sdílet prostřednictvím