Sdílet prostřednictvím

XmlMappedRange.Find – metoda

  • Článek

Vyhledá specifické informace v XmlMappedRange prvek a vrátí Range , která představuje první buňky, kde se informace nacházejí.

Obor názvů:  Microsoft.Office.Tools.Excel
Sestavení:  Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
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
    Hledat data.Může být řetězec nebo libovolný datový typ aplikace Microsoft Office Excel.
  • After
    Typ: System.Object
    Buňka, po které se má vyhledávání začít.To odpovídá umístění aktivní buňky při vyhledávání se provádí z uživatelského rozhraní.Všimněte si, že After musí být na jedinou buňku v oblasti.Mějte na paměti, že hledání začne po této buňky; Zadaná buňka není prohledána, dokud metoda neobteče zpět do této buňky.Pokud tento argument nezadáte, spustí se hledání po buňku v levém horním rohu oblasti.
  • MatchCase
    Typ: System.Object
    true Chcete-li hledání velká a malá písmena.Výchozí hodnota je false.
  • MatchByte
    Typ: System.Object
    Použít pouze v případě, že je nainstalována podpora jazyka double-byte nebo vybrané. true mít dvoubajtové znaky odpovídají pouze dvoubajtové znaky; falseChcete-li mít odpovídající ekvivalenty jednobajtové dvoubajtové znaky.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Excel.Range
A Range , která představuje první buňky, kde se nacházejí požadované informace.

Poznámky

Tato metoda vrátí nullodkaz null (Nothing v jazyce Visual Basic) je-li nalezena žádná shoda.

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

Nastavení pro LookIn, LookAt, SearchOrder, a MatchByte jsou uloženy při každém použití této metody.Pokud nezadáte hodnoty pro tyto argumenty, při dalším volání metody uložené hodnoty jsou použity.Tyto argumenty nastavení změní nastavení v dialogovém okně Najít a změnit nastavení v dialogovém okně Najít změny uložené hodnoty, které budou použity, pokud vynecháte argumenty.Aby nedocházelo k problémům, tyto argumenty explicitně nastavte při každém použití této metody.

Lze použít FindNext a FindPrevious metody pro hledání opakovat.

Příklady

Následující příklad kódu nastaví hodnotu XmlMappedRange řetězec "Novák", a pak používá Find, FindNext, a FindPrevious metod k nalezení na první buňku s řetězcem "Smith".Protože XmlMappedRange vždy obsahuje právě jeden buňky, v každém případě je nalezen na stejnou buňku.Tento kód příklad předpokládá, že obsahuje aktuální list XmlMappedRange s názvem CustomerLastNameCell.

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

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

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

XmlMappedRange Rozhraní

Microsoft.Office.Tools.Excel – obor názvů