XmlMappedRange.Find-Methode

  • Artikel

Sucht bestimmte Informationen in einem XmlMappedRange-Steuerelement und gibt einen Range zurück, der die erste Zelle darstellt, in der die Informationen gefunden werden.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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
)

Parameter

  • What
    Typ: System.Object
    Die zu suchenden Daten.Kann eine Zeichenfolge oder ein beliebiger Microsoft Office Excel-Datentyp sein.
  • After
    Typ: System.Object
    Die Zelle, nach der Sie die Suche beginnen möchten.Dies entspricht der Position der aktiven Zelle, wenn eine Suche über die Benutzeroberfläche durchgeführt wird.Beachten Sie, dass After eine einzelne Zelle im Bereich sein muss.Beachten Sie auch, dass die Suche nach dieser Zelle beginnt, wobei die angegebene Zelle erst dann durchsucht wird, wenn die Methode erneut diese Zelle erreicht hat.Wenn dieses Argument nicht angegeben wird, beginnt die Suche (räumlich betrachtet) nach der Zelle in der linken oberen Ecke des Bereichs.
  • MatchCase
    Typ: System.Object
    true , um bei der Suche Groß- und Kleinschreibung zu unterscheiden.Der Standardwert ist false.
  • MatchByte
    Typ: System.Object
    Wird nur verwendet, wenn Sie eine Doppelbyte-Sprachunterstützung ausgewählt oder installiert haben. true , wenn Doppelbytezeichen nur Doppelbytezeichen entsprechen sollen. false, wenn eine Übereinstimmung der Doppelbytezeichen mit ihren entsprechenden Einzelbytezeichen zulässig ist.

Rückgabewert

Typ: Microsoft.Office.Interop.Excel.Range
Ein Range, der die erste Zelle darstellt, in der die angegebenen Informationen gefunden wurden.

Hinweise

Diese Methode gibt nullein Nullverweis (Nothing in Visual Basic) zurück, wenn keine Übereinstimmung gefunden wird.

Diese Methode hat keine Auswirkungen auf die Auswahl oder die aktive Zelle.

Die Einstellungen für LookIn, LookAt, SearchOrder und MatchByte werden bei jeder Verwendung dieser Methode gespeichert.Wenn Sie für diese Argumente keine Werte angeben, werden beim nächsten Aufrufen der Methode die gespeicherten Werte verwendet.Durch das Festlegen dieser Argumente werden die Einstellungen im Dialogfeld Suchen geändert. Durch das Ändern der Einstellungen im Dialogfeld Suchen werden die gespeicherten Werte verändert, die verwendet werden, wenn Sie die Argumente weglassen.Zur Vermeidung dieser Probleme sollten Sie diese Argumente jedes Mal explizit festlegen, wenn Sie diese Methode verwenden.

Sie können die FindNext-Methode und die FindPrevious-Methode verwenden, um die Suche zu wiederholen.

Beispiele

Im folgenden Codebeispiel wird der Wert eines XmlMappedRange auf die Zeichenfolge "Smith" festgelegt und anschließend mit den Methoden Find, FindNext und FindPrevious die erste Zelle mit der Zeichenfolge "Smith" gesucht.Da ein XmlMappedRange immer genau eine Zelle enthält, wird jedesmal dieselbe Zelle gefunden.In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange mit dem Namen CustomerLastNameCell enthält.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace