XmlMappedRange.Find Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

Parameter

What: Object

Die zu suchenden Daten. Kann eine Zeichenfolge oder ein beliebiger Microsoft Office Excel-Datentyp sein.

After: 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.

LookIn: Object

Der Informationstyp.

LookAt: Object

Kann einer der folgenden XlLookAt-Werte sein: xlWhole oder xlPart.

SearchOrder: Object

Kann einer der folgenden XlSearchOrder-Werte sein: xlByRows oder xlByColumns.

SearchDirection: XlSearchDirection

Die Suchrichtung. Kann einer der folgenden XlSearchDirection Werte sein: xlNext oder xlPrevious.

MatchCase: Object

true, um bei der Suche Groß- und Kleinschreibung zu unterscheiden. Der Standardwert ist false.

MatchByte: 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.

SearchFormat: Object

Das Suchformat.

Gibt zurück

Range

Ein Range, der die erste Zelle darstellt, in der die angegebenen Informationen gefunden wurden.

Beispiele

Im folgenden Codebeispiel wird der Wert von XmlMappedRange auf die Zeichenfolge "Smith" festgelegt. Anschließend werden die FindMethoden , FindNextund FindPrevious verwendet, um die erste Zelle mit der Zeichenfolge "Smith" zu suchen. Da immer XmlMappedRange genau eine Zelle enthält, wird in jedem Fall dieselbe Zelle gefunden. In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange namens CustomerLastNameCellenthält.

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

Hinweise

Diese Methode gibt zurück null , wenn keine Übereinstimmung gefunden wird.

Diese Methode wirkt sich nicht auf die Auswahl oder die aktive Zelle aus.

Die Einstellungen für LookIn, LookAt, SearchOrderund MatchByte werden bei jeder Verwendung dieser Methode gespeichert. Wenn Sie keine Werte für diese Argumente angeben, werden beim nächsten Aufruf der -Methode die gespeicherten Werte verwendet. Durch das Festlegen dieser Argumente werden die Einstellungen im Dialogfeld Suchen geändert, und beim Ändern der Einstellungen im Dialogfeld Suchen werden die gespeicherten Werte geändert, die verwendet werden, wenn Sie die Argumente weglassen. Um Probleme zu vermeiden, legen Sie diese Argumente bei jeder Verwendung dieser Methode explizit fest.

Sie können die Microsoft.Office.Interop.Excel.Range.FindNext* Methoden und FindPrevious verwenden, um die Suche zu wiederholen.

Gilt für:

Freigeben über