XmlMappedRange.FindNext(Object) 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.

Setzt die mit der Find(Object, Object, Object, Object, Object, XlSearchDirection, Object, Object, Object)-Methode begonnene Suche fort.

public Microsoft.Office.Interop.Excel.Range FindNext (object After);

abstract member FindNext : obj -> Microsoft.Office.Interop.Excel.Range

Public Function FindNext (Optional After As Object) As Range

Parameter

After: Object

Die Zelle nach der Zelle, die Sie suchen 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 XmlMappedRange Steuerelement 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 XmlMappedRange-Steuerelements.

Gibt zurück

Range

Ein Range, der eine Zelle mit den angegebenen Informationen darstellt.

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

Sucht nach der nächsten Zelle, die den für die Find -Methode angegebenen Bedingungen entspricht, und gibt eine Range zurück, die diese Zelle darstellt.

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

Wenn die Suche das Ende des angegebenen Suchbereichs erreicht, wird sie bis zum Anfang des Bereichs umbrochen. Um eine Suche zu beenden, wenn dieser Wraparound auftritt, speichern Sie die Adresse der ersten gefundenen Zelle, und testen Sie dann jede aufeinanderfolgende gefundene Zellenadresse anhand dieser gespeicherten Adresse.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über