Método NamedRange.AutoFilter

  • Artigo

Filtra uma lista usando o AutoFilter.

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

Sintaxe

'Declaração
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
)

Parâmetros

  • Field
    Tipo: System.Object
    O deslocamento do campo em que você deseja basear o filtro (esquerda da lista; o campo mais à esquerda é o campo 1 (um).)
  • Criteria1
    Tipo: System.Object
    Os critérios (uma cadeia de caracteres; por exemplo, “101 ").Use “=” para localizar campos em branco, ou para usar o “<>” para localizar campos de nonblank.Se esse argumento for omitido, os critérios são All.Se Operator é xlTop10Items, Criteria1 especifica o número de itens (por exemplo, “10 ").
  • Criteria2
    Tipo: System.Object
    Os critérios segundos (uma cadeia de caracteres).Usado com Criteria1 e Operator para construir critérios compostos.
  • VisibleDropDown
    Tipo: System.Object
    true para exibir a seta suspensa de AutoFilter para o campo filtro; false para ocultar a seta suspensa de AutoFilter para o campo filtro. true por padrão.

Valor de retorno

Tipo: System.Object

Comentários

Se você omitir todos os argumentos, esse método ativa /desativar simplesmente a exibição das setas suspensas de AutoFilter no controle de NamedRange .

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir define as células A1 com o A5 a cinco cadeias de caracteres de nome e usa o método de AutoFilter para filtrar o nome “Robert“.

Este exemplo é para uma personalização da nível.

    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"].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);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel