NamedRange.Find(Object, Object, Object, Object, Object, XlSearchDirection, Object, Object, Object) Methode

Definition

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

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 in einem-Steuerelement zu suchen Seashell NamedRange . Im Beispiel werden dann die FindNext -Methode und die- FindPrevious Methode verwendet, um die nächste Zelle mit dem Wert zu suchen Seashell und dann zur ursprünglichen Zelle zurückzukehren. Schließlich wird in diesem Beispiel die Cut -Methode verwendet, um den Inhalt der ersten Zelle mit dem Wert auszuschneiden Seashell und in Zelle B1 einzufügen.

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.

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 Entsprechung gefunden wird.

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

Die Einstellungen für LookIn , LookAt , SearchOrder und MatchByte werden jedes Mal gespeichert, wenn Sie diese Methode verwenden. Wenn Sie beim nächsten Aufruf der-Methode keine Werte für diese Argumente angeben, werden die gespeicherten Werte verwendet. Wenn Sie diese Argumente festlegen, werden die Einstellungen im Dialogfeld Suchen geändert, und durch das Ä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.

FindNextMit der-Methode und der-Methode können Sie FindPrevious die Suche wiederholen.

Wenn die Suche das Ende des angegebenen Suchbereichs erreicht, wird Sie bis zum Anfang des Bereichs umschlossen. Wenn Sie eine Suche beenden möchten, wenn dieses wraeach auftritt, speichern Sie die Adresse der ersten gefundenen Zelle, und testen Sie dann jede aufeinander folgende gefundene Zellen Adresse mit dieser gespeicherten Adresse.

Optionale Parameter

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

Gilt für