FileDialog.Filter 속성

정의

네임스페이스:

Microsoft.Win32

어셈블리:

PresentationFramework.dll

OpenFileDialog 또는 SaveFileDialog에 표시되는 파일 형식을 결정하는 필터 문자열을 가져오거나 설정합니다.

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };

public string Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

속성 값

String

필터가 들어 있는 String입니다. 기본값은 필터가 적용되지 않고 모든 파일 형식이 표시됨을 의미하는 Empty입니다.

예외

ArgumentException

필터 문자열이 잘못된 경우

예제

다음 예제에서는 사용 하 여 설정할 수 있는 필터 문자열의 여러 형식을 보여 줍니다는 Filter 속성입니다.

OpenFileDialog dlg = new OpenFileDialog();

// Show all files
dlg.Filter = string.Empty;

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Show all files
dlg.Filter = String.Empty

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Show all files
dlg.Filter = null;

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Show all files
dlg.Filter = Nothing

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Word Documents
dlg.Filter = "Word Documents|*.doc";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Word Documents
dlg.Filter = "Word Documents|*.doc"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Excel Worksheets
dlg.Filter = "Excel Worksheets|*.xls";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Excel Worksheets
dlg.Filter = "Excel Worksheets|*.xls"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by PowerPoint Presentations
dlg.Filter = "PowerPoint Presentations|*.ppt";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by PowerPoint Presentations
dlg.Filter = "PowerPoint Presentations|*.ppt"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Office Files
dlg.Filter = "Office Files|*.doc;*.xls;*.ppt";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Office Files
dlg.Filter = "Office Files|*.doc;*.xls;*.ppt"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by All Files
dlg.Filter = "All Files|*.*";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by All Files
dlg.Filter = "All Files|*.*"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Word Documents OR Excel Worksheets OR PowerPoint Presentations 
//           OR Office Files 
//           OR All Files
dlg.Filter = "Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt" +
             "|Office Files|*.doc;*.xls;*.ppt" +
             "|All Files|*.*";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Word Documents OR Excel Worksheets OR PowerPoint Presentations 
'           OR Office Files 
'           OR All Files
dlg.Filter = "Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt" & "|Office Files|*.doc;*.xls;*.ppt" & "|All Files|*.*"

dlg.ShowDialog()

설명

가 null 또는 Empty이면 Filter 모든 파일이 표시되고 폴더가 항상 표시됩니다.

속성을 설정하여 표시할 파일 형식의 하위 집합을 Filter 지정할 수 있습니다. 각 파일 형식은 다음과 같은 특정 형식의 파일을 나타낼 수 있습니다.

• Word 문서(*.doc)

• Excel 워크시트(*.xls)

• PowerPoint 프레젠테이션(*.ppt)

또는 파일 형식은 다음과 같은 관련 파일 형식의 그룹을 나타낼 수 있습니다.

• Office 파일(*.doc, *.xls, *.ppt)

• 모든 파일(*.*)

표시 되는 파일 형식의 하위 집합을 지정 하려면 설정 Filter 된 문자열 값 ( 필터 문자열) 필터링할 파일의 하나 이상의 형식을 지정 하는 속성입니다. 다음은 필터 문자열의 예상 형식을 보여줍니다.

FileType1[[|FileType2]...[|FileTypeN]]

다음 형식을 사용하여 각 파일 형식을 설명합니다.

Label|Extension1[[;Extension2]...[;ExtensionN]]

레이블 부분은 다음과 같이 파일 형식을 설명하는 사람이 읽을 수 있는 문자열 값입니다.

• "Word 문서"

• "Excel 워크시트"

• "PowerPoint 프레젠테이션"

• "Office 파일"

• "모든 파일"

각 파일 형식은 하나 이상의 확장명에서 설명해야 합니다. 둘 이상의 확장을 사용하는 경우 각 확장을 세미콜론(";")으로 구분해야 합니다. 예를 들면 다음과 같습니다.

• "*.doc"

• "*.xls;"

• "*.ppt"

• "*.doc;*.xls;*.ppt"

• "*.*"

다음은 유효한 Filter 문자열 값의 전체 예제입니다.

• Word Documents|*.doc

• Excel Worksheets|*.xls

• PowerPoint Presentations|*.ppt

• Office Files|*.doc;*.xls;*.ppt

• All Files|*.*

• Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt|Office Files|*.doc;*.xls;*.ppt|All Files|*.*

필터에 포함된 각 파일 형식은 다음 그림과 같이 또는 SaveFileDialog의 파일 형식 드롭다운 목록에 OpenFileDialog 별도의 항목으로 추가됩니다.

사용자는 필터링할 파일 형식을 이 목록에서 선택할 수 있습니다. 기본적으로 목록의 첫 번째 항목(예: 첫 번째 파일 형식)은 또는 SaveFileDialog 가 표시될 때 OpenFileDialog 선택됩니다. 다른 파일 형식을 선택하도록 지정하려면 또는 를 FilterIndex 표시 OpenFileDialog 하기 전에 속성을 설정합니다(를 호출ShowDialog하여).SaveFileDialog

추가 정보

• FileName
• FilterIndex