NamedRange.AutoFilter-Methode

Artikel
08/10/2011

Filtert eine Liste mit AutoFilter.

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

Syntax

'Declaration
Function AutoFilter ( _
    Field As Object, _
    Criteria1 As Object, _
    Operator As XlAutoFilterOperator, _
    Criteria2 As Object, _
    VisibleDropDown As Object _
) As Object

Object AutoFilter(
    Object Field,
    Object Criteria1,
    XlAutoFilterOperator Operator,
    Object Criteria2,
    Object VisibleDropDown
)

Parameter

Field
Typ: System.Object
Der Abstand des Felds, das Sie als Basis für den Filter verwenden möchten (ausgehend von der linken Seite der Liste; ist das Feld ganz links das Feld 1 (eins)).

Criteria1
Typ: System.Object
Die Kriterien (eine Zeichenfolge, z. B. "101").Verwenden Sie "=", um leere Felder zu suchen, oder "<>", um nicht leere Felder zu suchen.Wenn dieses Argument weggelassen wird, lautet das Kriterium All.Wenn der Operator OperatorxlTop10Items ist, gibt Criteria1 die Anzahl der Elemente an (z. B. "10").

Operator
Typ: Microsoft.Office.Interop.Excel.XlAutoFilterOperator
Kann eine der folgenden XlAutoFilterOperator-Konstanten sein:
xlAnd
xlBottom10Items
xlBottom10Percent
xlOr
xlTop10Items
xlTop10Percent
Verwenden Sie xlAnd und xlOr mit Criteria1 und Criteria2, um Kriterien miteinander zu kombinieren.

Criteria2
Typ: System.Object
Das zweite Kriterium (eine Zeichenfolge).Wird mit Criteria1 und Operator verwendet, um Kriterien miteinander zu kombinieren.

VisibleDropDown
Typ: System.Object
true, um den AutoFilter-Dropdownpfeil für das gefilterte Feld anzuzeigen; false, um den AutoFilter-Dropdownpfeil für das gefilterte Feld auszublenden.Standardmäßig true.

Rückgabewert

Typ: System.Object

Hinweise

Wenn Sie alle Argumente weglassen, wechselt diese Methode einfach die Anzeige der AutoFilter-Dropdownpfeile für das gefilterte Feld im NamedRange-Steuerelement.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel werden die Zellen A1 bis A5 auf fünf verschiedene Namenszeichenfolgen festgelegt. Anschließend wird mithilfe der AutoFilter-Methode nach dem Namen "Robert" gefiltert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub SetAutoFilter()
        Me.Range("A1").Value2 = "Kathleen"
        Me.Range("A2").Value2 = "Robert"
        Me.Range("A3").Value2 = "Paul"
        Me.Range("A4").Value2 = "Harry"
        Me.Range("A5").Value2 = "George"

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

        namedRange1.AutoFilter(1, "Robert", _
            Excel.XlAutoFilterOperator.xlAnd, , True)
    End Sub

private void SetAutoFilter()
{
    this.Range["A1", missing].Value2 = "Kathleen";
    this.Range["A2", missing].Value2 = "Robert";
    this.Range["A3", missing].Value2 = "Paul";
    this.Range["A4", missing].Value2 = "Harry";
    this.Range["A5", missing].Value2 = "George";

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

    namedRange1.AutoFilter(1, "Robert",
        Excel.XlAutoFilterOperator.xlAnd, missing, true);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via