Método NamedRange.AutoFilter

Artigo
01/09/2014

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 é omitido, os critérios são All.Se Operator é xlTop10Items, Criteria1 especifica o número de itens (por exemplo, “10 ").

Operator
Tipo: Microsoft.Office.Interop.Excel.XlAutoFilterOperator
Pode ser uma das seguintes constantes de XlAutoFilterOperator :
xlAnd
xlBottom10Items
xlBottom10Percent
xlOr
xlTop10Items
xlTop10Percent
Use xlAnd e xlOr com Criteria1 e Criteria2 para construir critérios compostos.

Criteria2
Tipo: System.Object
Os segundos critérios (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 alterna apenas 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 diferentes de nome e usa o método de AutoFilter para filtrar o nome “Robert“.

Este exemplo é para uma personalização de um documento 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

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via