Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Representa el autofiltro para la hoja de cálculo especificada.
public class AutoFilter
Herencia
Miembros heredados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Ejemplos
//Creando un flujo de archivo que contiene el archivo de Excel a abrir
//Instanciando un objeto Workbook
Workbook workbook = new Workbook("template.xlsx");
//Accediendo a la primera hoja de cálculo en el archivo de Excel
Worksheet worksheet = workbook.Worksheets[0];
//Creando AutoFilter dando el rango de celdas de la fila de encabezado
worksheet.AutoFilter.Range = "A1:B1";
//Filtrando columnas con valores especificados
worksheet.AutoFilter.Filter(1, "Bananas");
//Guardando el archivo de Excel modificado.
workbook.Save("output.xls");
'Creando un flujo de archivo que contiene el archivo de Excel a abrir
'Instanciando un objeto Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'Accediendo a la primera hoja de cálculo en el archivo de Excel
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Creando AutoFilter dando el rango de celdas de la fila de encabezado
worksheet.AutoFilter.Range = "A1:B1"
'Filtrando columnas con valores especificados
Worksheet.AutoFilter.Filter(1, "Bananas")
'Guardando el archivo de Excel modificado
workbook.Save("output.xls")
Propiedades
FilterColumns
Obtiene la colección de las columnas de filtro.
public FilterColumnCollection FilterColumns { get; }
Valor de la propiedad
Range
Representa el rango al que se aplica el AutoFilter especificado.
public string Range { get; set; }
Valor de la propiedad
ShowFilterButton
Indica si el botón de AutoFilter para esta columna es visible.
public bool ShowFilterButton { get; set; }
Valor de la propiedad
Sorter
Obtiene el clasificador de datos.
public DataSorter Sorter { get; }
Valor de la propiedad
Métodos
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Agrega un filtro de fecha.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
dateTimeGroupingType
DateTimeGroupingType
El tipo de agrupación
year
int
El año.
month
int
El mes.
day
int
El día.
hour
int
La hora.
minute
int
El minuto.
second
int
El segundo.
Notas
Si DateTimeGroupingType es Year, solo el parámetro año afecta. Si DateTimeGroupingType es Month, solo los parámetros año y mes afectan.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
Agrega un filtro de color de relleno.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
pattern
BackgroundType
El tipo de patrón de fondo.
foregroundColor
CellsColor
El color de primer plano.
backgroundColor
CellsColor
El color de fondo.
AddFilter(int, string)
Agrega un filtro para una columna de filtro.
public void AddFilter(int fieldIndex, string criteria)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
criteria
string
Los criterios especificados (una cadena; por ejemplo, “101”). Solo puede ser nulo o uno de los valores de las celdas en esta columna.
Notas
MS Excel 2007 admite la selección múltiple en una columna de filtro.
AddFontColorFilter(int, CellsColor)
Agrega un filtro de color de fuente.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
color
CellsColor
El objeto Aspose.Cells.CellsColor.
AddIconFilter(int, IconSetType, int)
Agrega un filtro de icono.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
iconSetType
IconSetType
El tipo de conjunto de iconos.
iconId
int
El id del icono.
Notas
Solo admite agregar el filtro de icono. No admite verificar qué fila es visible si el filtro es un filtro de icono.
Custom(int, FilterOperatorType, object)
Filtra una lista con un criterio personalizado.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
operatorType1
FilterOperatorType
El tipo de operador de filtro
criteria1
object
Los criterios personalizados
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
Filtra una lista con criterios personalizados.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
operatorType1
FilterOperatorType
El tipo de operador de filtro
criteria1
object
Los criterios personalizados
isAnd
bool
operatorType2
FilterOperatorType
El tipo de operador de filtro
criteria2
object
Los criterios personalizados
DynamicFilter(int, DynamicFilterType)
Agrega un filtro dinámico.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
dynamicFilterType
DynamicFilterType
Tipo de filtro dinámico.
Filter(int, string)
Filtra una lista con criterios especificados.
public void Filter(int fieldIndex, string criteria)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
criteria
string
Los criterios especificados (una cadena; por ejemplo, “101”).
Notas
Aspose.Cells eliminará todas las demás configuraciones de filtro en este campo como Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
Filtra los 10 elementos principales en la lista
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
isTop
bool
Indica si filtra desde arriba o desde abajo
isPercent
bool
Indica si los elementos son porcentaje o cantidad
itemCount
int
El conteo de elementos
GetCellArea()
Obtiene el Aspose.Cells.CellArea donde se aplica este AutoFilter.
public CellArea GetCellArea()
Retorna
el área a la que se aplica este filtro
GetCellArea(bool)
Obtiene el Aspose.Cells.CellArea donde se aplica el AutoFilter especificado.
public CellArea GetCellArea(bool refreshAppliedRange)
Parámetros
refreshAppliedRange
bool
Si refrescar el rango aplicado. Para el rango aplicado del autofiltro, la última fila puede cambiar cuando cambian los datos de las celdas. Si esta bandera es verdadera, entonces la última fila del rango se recalculará de acuerdo con los datos actuales de las celdas.
Retorna
el área a la que se aplica este filtro
MatchBlanks(int)
Coincide con todas las celdas en blanco en la lista.
public void MatchBlanks(int fieldIndex)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
MatchNonBlanks(int)
Coincide con todas las celdas no en blanco en la lista.
public void MatchNonBlanks(int fieldIndex)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
Refresh()
Actualiza los autofiltros para ocultar o mostrar las filas.
public int[] Refresh()
Retorna
int[]
Devuelve todos los índices de filas ocultas.
Refresh(bool)
Obtiene todos los índices de filas ocultas.
public int[] Refresh(bool hideRows)
Parámetros
hideRows
bool
Si es verdadero, oculta las filas filtradas.
Retorna
int[]
Devuelve todos los índices de filas ocultas.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Elimina un filtro de fecha.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
dateTimeGroupingType
DateTimeGroupingType
El tipo de agrupación
year
int
El año.
month
int
El mes.
day
int
El día.
hour
int
La hora.
minute
int
El minuto.
second
int
El segundo.
Notas
Si DateTimeGroupingType es Year, solo el parámetro año afecta. Si DateTimeGroupingType es Month, solo los parámetros año y mes afectan.
RemoveFilter(int, string)
Elimina un filtro para una columna de filtro.
public void RemoveFilter(int fieldIndex, string criteria)
Parámetros
fieldIndex
int
El desplazamiento entero del campo en el que desea basar el filtro (desde la izquierda de la lista; el campo más a la izquierda es el campo 0).
criteria
string
Los criterios especificados (una cadena; por ejemplo, “101”). Solo puede ser nulo o uno de los valores de las celdas en esta columna.
RemoveFilter(int)
Elimina el filtro específico.
public void RemoveFilter(int fieldIndex)
Parámetros
fieldIndex
int
El índice del filtro específico
SetRange(int, int, int)
Establece el rango al que se aplica el AutoFilter especificado.
public void SetRange(int row, int startColumn, int endColumn)
Parámetros
row
int
Índice de fila.
startColumn
int
Índice de columna de inicio.
endColumn
int
Índice de columna final.
ShowAll()
Muestra todas las filas.
public void ShowAll()