NamedRange.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 dem NamedRange-Steuerelement und gibt ein Range-Objekt zurück, das die erste Zelle darstellt, in der die Informationen gefunden wurden.

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, wenn bei der Suche die Groß-/Kleinschreibung berücksichtigt werden soll. 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-Objekt, das die erste Zelle darstellt, in der die Informationen gefunden wurden.

Beispiele

Im folgenden Codebeispiel wird die Find -Methode verwendet, um die erste Zelle mit dem Wert Seashell in einem NamedRange Steuerelement zu suchen. Im Beispiel werden dann die FindNext Methoden und FindPrevious verwendet, um die nächste Zelle mit dem Wert Seashell zu finden und dann zur ursprünglichen Zelle zurückzukehren. Schließlich verwendet das Beispiel die Cut -Methode, um den Inhalt der ersten Zelle mit dem Wert Seashell zu schneiden und in Zelle B1 einzufügen.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

private void FindValue()
{
    this.Range["A1"].Value2 = "Barnacle";
    this.Range["A2"].Value2 = "Seashell";
    this.Range["A3"].Value2 = "Star Fish";
    this.Range["A4"].Value2 = "Seashell";
    this.Range["A5"].Value2 = "Clam Shell";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell",
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1"]);
}

Private Sub FindValue()
    Me.Range("A1").Value2 = "Barnacle"
    Me.Range("A2").Value2 = "Seashell"
    Me.Range("A3").Value2 = "Star Fish"
    Me.Range("A4").Value2 = "Seashell"
    Me.Range("A5").Value2 = "Clam Shell"

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Find the first occurrence of "Seashell".
    Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
        False, False, )

    ' Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1)

    ' Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1)

    ' Cut the range with the first "Seashell" and copy it to cell B1.
    Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Range1, "namedRange2")
    namedRange2.Cut(Me.Range("B1"))
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 beim nächsten Aufruf der -Methode keine Werte für diese Argumente angeben, werden 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 FindNext Methoden und FindPrevious verwenden, um die Suche zu wiederholen.

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