Class AutoFilter

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

지정된 워크시트에 대한 자동 필터링을 나타냅니다.

public class AutoFilter

상속

object ← AutoFilter

상속된 멤버

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

예제

//열어야 하는 Excel 파일을 포함하는 파일 스트림 생성
//Workbook 객체 인스턴스화
Workbook workbook = new Workbook("template.xlsx");
//Excel 파일에서 첫 번째 워크시트에 접근
Worksheet worksheet = workbook.Worksheets[0];
//헤딩 행의 셀 범위를 지정하여 AutoFilter 생성
worksheet.AutoFilter.Range = "A1:B1";
//지정된 값으로 열 필터링
worksheet.AutoFilter.Filter(1, "Bananas");
//수정된 Excel 파일 저장
workbook.Save("output.xls");

'열어야 하는 Excel 파일을 포함하는 파일 스트림 생성
'Workbook 객체 인스턴스화
Dim workbook As Workbook = New Workbook("template.xlsx")
'Excel 파일에서 첫 번째 워크시트에 접근
Dim worksheet As Worksheet = workbook.Worksheets(0)
'헤딩 행의 셀 범위를 지정하여 AutoFilter 생성
worksheet.AutoFilter.Range = "A1:B1"
'지정된 값으로 열 필터링
Worksheet.AutoFilter.Filter(1, "Bananas")
'수정된 Excel 파일 저장 
workbook.Save("output.xls")

속성

FilterColumns

필터 열의 컬렉션을 가져옵니다.

public FilterColumnCollection FilterColumns { get; }

속성 값

FilterColumnCollection

Range

지정된 AutoFilter가 적용되는 범위를 나타냅니다.

public string Range { get; set; }

속성 값

string

ShowFilterButton

이 열의 AutoFilter 버튼이 보이는지를 나타냅니다.

public bool ShowFilterButton { get; set; }

속성 값

bool

Sorter

데이터 정렬기를 가져옵니다.

public DataSorter Sorter { get; }

속성 값

DataSorter

메서드

AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)

날짜 필터를 추가합니다.

public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

dateTimeGroupingType DateTimeGroupingType

그룹화 유형

year int

연도.

month int

월.

day int

일.

hour int

시.

minute int

분.

second int

초.

비고

DateTimeGroupingType가 Year인 경우, year 매개변수만 영향을 미칩니다. DateTimeGroupingType가 Month인 경우, year 및 month 매개변수만 영향을 미칩니다.

AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)

채우기 색상 필터를 추가합니다.

public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

pattern BackgroundType

배경 패턴 유형.

foregroundColor CellsColor

전경 색상.

backgroundColor CellsColor

배경 색상.

AddFilter(int, string)

필터 열에 대한 필터를 추가합니다.

public void AddFilter(int fieldIndex, string criteria)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

criteria string

지정된 기준(문자열; 예: “101”). null이거나 이 열의 셀 값 중 하나일 수 있습니다.

비고

MS Excel 2007은 필터 열에서 다중 선택을 지원합니다.

AddFontColorFilter(int, CellsColor)

글꼴 색상 필터를 추가합니다.

public void AddFontColorFilter(int fieldIndex, CellsColor color)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

color CellsColor

Aspose.Cells.CellsColor 객체.

AddIconFilter(int, IconSetType, int)

아이콘 필터를 추가합니다.

public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

iconSetType IconSetType

아이콘 세트 유형.

iconId int

아이콘 ID.

비고

아이콘 필터 추가만 지원합니다. 아이콘 필터가 필터인 경우 어떤 행이 보이는지 확인하는 것은 지원하지 않습니다.

Custom(int, FilterOperatorType, object)

사용자 정의 기준으로 목록을 필터링합니다.

public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

operatorType1 FilterOperatorType

필터 연산자 유형

criteria1 object

사용자 정의 기준

Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)

사용자 정의 기준으로 목록을 필터링합니다.

public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

operatorType1 FilterOperatorType

필터 연산자 유형

criteria1 object

사용자 정의 기준

isAnd bool

operatorType2 FilterOperatorType

필터 연산자 유형

criteria2 object

사용자 정의 기준

DynamicFilter(int, DynamicFilterType)

동적 필터를 추가합니다.

public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

dynamicFilterType DynamicFilterType

동적 필터 유형.

Filter(int, string)

지정된 기준으로 목록을 필터링합니다.

public void Filter(int fieldIndex, string criteria)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

criteria string

지정된 기준(문자열; 예: “101”).

비고

Aspose.Cells는 MS Excel 97-2003처럼 이 필드의 모든 다른 필터 설정을 제거합니다.

FilterTop10(int, bool, bool, int)

목록에서 상위 10개 항목을 필터링합니다.

public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

isTop bool

상위 또는 하위에서 필터링할지를 나타냅니다.

isPercent bool

항목이 비율인지 수치를 나타냅니다.

itemCount int

항목 수.

GetCellArea()

이 AutoFilter가 적용되는 Aspose.Cells.CellArea를 가져옵니다.

public CellArea GetCellArea()

반환

CellArea

이 필터가 적용되는 영역

GetCellArea(bool)

지정된 AutoFilter가 적용되는 Aspose.Cells.CellArea를 가져옵니다.

public CellArea GetCellArea(bool refreshAppliedRange)

매개변수

refreshAppliedRange bool

적용된 범위를 새로 고칠지를 나타냅니다. 자동 필터의 적용된 범위는 셀 데이터 변경 시 마지막 행이 변경될 수 있습니다. 이 플래그가 true이면 현재 셀 데이터에 따라 범위의 마지막 행이 재계산됩니다.

반환

CellArea

이 필터가 적용되는 영역

MatchBlanks(int)

목록에서 모든 빈 셀과 일치합니다.

public void MatchBlanks(int fieldIndex)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

MatchNonBlanks(int)

목록에서 모든 비어 있지 않은 셀과 일치합니다.

public void MatchNonBlanks(int fieldIndex)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

Refresh()

자동 필터를 새로 고쳐 행을 숨기거나 표시합니다.

public int[] Refresh()

반환

int[]

모든 숨겨진 행의 인덱스를 반환합니다.

Refresh(bool)

모든 숨겨진 행의 인덱스를 가져옵니다.

public int[] Refresh(bool hideRows)

매개변수

hideRows bool

true인 경우 필터링된 행을 숨깁니다.

반환

int[]

모든 숨겨진 행의 인덱스를 반환합니다.

RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)

날짜 필터를 제거합니다.

public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

dateTimeGroupingType DateTimeGroupingType

그룹화 유형

year int

연도.

month int

월.

day int

일.

hour int

시.

minute int

분.

second int

초.

비고

DateTimeGroupingType가 Year인 경우, year 매개변수만 영향을 미칩니다. DateTimeGroupingType가 Month인 경우, year 및 month 매개변수만 영향을 미칩니다.

RemoveFilter(int, string)

필터 열에 대한 필터를 제거합니다.

public void RemoveFilter(int fieldIndex, string criteria)

매개변수

fieldIndex int

필터를 기준으로 할 필드의 정수 오프셋 (목록의 왼쪽에서; 가장 왼쪽 필드는 필드 0입니다).

criteria string

지정된 기준(문자열; 예: “101”). null이거나 이 열의 셀 값 중 하나일 수 있습니다.

RemoveFilter(int)

특정 필터를 제거합니다.

public void RemoveFilter(int fieldIndex)

매개변수

fieldIndex int

특정 필터 인덱스

SetRange(int, int, int)

지정된 AutoFilter가 적용되는 범위를 설정합니다.

public void SetRange(int row, int startColumn, int endColumn)

매개변수

row int

행 인덱스.

startColumn int

시작 열 인덱스.

endColumn int

끝 열 인덱스.

ShowAll()

모든 행을 표시합니다.

public void ShowAll()