NamedRange.AutoFilter Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

Filtra una lista mediante la función de Autofiltro.

public object AutoFilter (object Field, object Criteria1, Microsoft.Office.Interop.Excel.XlAutoFilterOperator Operator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, object Criteria2, object VisibleDropDown);

abstract member AutoFilter : obj * obj * Microsoft.Office.Interop.Excel.XlAutoFilterOperator * obj * obj -> obj

Public Function AutoFilter (Optional Field As Object, Optional Criteria1 As Object, Optional Operator As XlAutoFilterOperator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, Optional Criteria2 As Object, Optional VisibleDropDown As Object) As Object

Parámetros

Field

Object

Desplazamiento del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo del extremo izquierdo es el campo 1 (uno)).

Criteria1

Object

Criterios (una cadena; por ejemplo, "101"). Use "=" para encontrar campos vacíos o "<>" para encontrar campos no vacíos. Si se omite este argumento, el criterio es All. Si Operator es xlTop10Items, Criteria1 especifica el número de elementos (por ejemplo, "10").

Operator

XlAutoFilterOperator

Puede ser una de las siguientes XlAutoFilterOperator constantes: xlAndxlTop10ItemsxlTop10PercentxlBottom10ItemsxlOrxlBottom10Percentuse xlAnd y con Criteria1 y Criteria2xlOr para construir criterios compuestos.

Criteria2

Object

El segundo criterio (una cadena). Se usa con Criteria1 y Operator para construir criterios compuestos.

VisibleDropDown

Object

Es true para mostrar la flecha de la lista desplegable de Autofiltro para el campo filtrado; es false para ocultar la flecha de la lista desplegable de Autofiltro para el campo filtrado. true es el valor predeterminado.

Devoluciones

Object

Ejemplos

En el ejemplo de código siguiente se establecen las celdas A1 a A5 en cinco cadenas de nombre diferentes y, a continuación, se usa el método para filtrar por AutoFilter el nombre "Robert".

Este ejemplo es para una personalización de nivel de documento.

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

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

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

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

Comentarios

Si omite todos los argumentos, este método simplemente alterna la presentación de las flechas desplegables autofiltro en el NamedRange control.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.