FileDialog.Filter FileDialog.Filter FileDialog.Filter FileDialog.Filter Property

정의

OpenFileDialog 또는 SaveFileDialog에 표시되는 파일 형식을 결정하는 필터 문자열을 가져오거나 설정합니다.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or 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입니다.A String that contains the filter. 기본값은 필터가 적용되지 않고 모든 파일 형식이 표시됨을 의미하는 Empty입니다.The default is Empty, which means that no filter is applied and all file types are displayed.

예외

필터 문자열이 잘못 되었습니다.The filter string is invalid.

예제

다음 예제에서는 여러 유형의 사용 하 여 설정할 수 있는 필터 문자열을 보여 합니다 Filter 속성입니다.The following examples demonstrate several types of filter strings that can be set by using the Filter property.

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()

설명

하는 경우 Filter 중 하나는 null 또는 Empty, 모든 파일 표시 되 고 폴더는 항상 표시 됩니다.If Filter is either null or Empty, all files are displayed, and folders are always displayed.

설정 하 여 표시할 수 있는 파일 형식의 하위 집합을 지정할 수 있습니다는 Filter 속성입니다.You can specify a subset of file types to be displayed by setting the Filter property. 각 파일 형식에는 특정 유형의 파일을 다음과 같이 나타낼 수 있습니다.Each file type can represent a specific type of file, such as the following:

  • Word 문서 (*.doc)Word Documents (*.doc)

  • Excel 통합 문서 (*.xls)Excel Worksheets (*.xls)

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

또는 파일 형식에는 다음과 같은 관련된 파일 형식 그룹을 나타낼 수 있습니다.Alternatively, a file type can represent a group of related file types, such as the following:

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

  • 모든 파일 (*.*)All Files (*.*)

설정한 표시 되는 파일 형식의 하위 집합을 지정 하려면를 Filter 문자열 값을 갖는 속성 (합니다 필터 문자열) 하나 이상의로 필터링 할 파일 형식을 지정 하는 합니다.To specify a subset of the types of files that are displayed, you set the Filter property with a string value (the filter string) that specifies one or more types of files to filter by. 필터 문자열의 예상된 형식은 다음과 같습니다.The following shows the expected format of the filter string:

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

다음 형식을 사용 하 여 각 파일 형식에 설명 합니다.You use the following format to describe each file type:

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

합니다 레이블 부분은 다음과 같은 파일 형식을 설명 하는 사람이 읽을 수 있는 문자열 값:The Label part is a human-readable string value that describes the file type, such as the following:

  • "Word 문서""Word Documents"

  • "Excel 워크시트""Excel Worksheets"

  • "PowerPoint 프레젠테이션""PowerPoint Presentations"

  • "Office Files""Office Files"

  • 모든 파일"All Files"

각 파일 형식을 하나 이상에서 설명 해야 합니다 확장합니다.Each file type must be described by at least one Extension. 두 개 이상의 확장 를 사용할 각 확장 세미콜론으로 구분 해야 합니다 (";").If more than one Extension is used, each Extension must be separated by a semicolon (";"). 예를 들어 다음과 같습니다.For example:

  • "*.doc""*.doc"

  • "*.xls;""*.xls;"

  • "*.ppt""*.ppt"

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

  • "*.*""*.*"

다음은 전체 예제는 유효한 Filter 문자열 값:The following are complete examples of valid Filter string values:

  • 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|*.*

필터에 포함 된 각 파일 형식에 별도 항목으로 추가 됩니다는 파일 형식: 드롭 다운 목록에는 OpenFileDialog 또는 SaveFileDialog다음 그림에 나와 있는 것 처럼.Each file type that is included in the filter is added as a separate item to the Files of type: drop-down list in the OpenFileDialog or SaveFileDialog, as shown in the following figure.

열기 대화 상자에서 FileDialog.Filter 사용Using the FileDialog.Filter in the Open Dialog Box

사용자 기준으로 필터링 하려면이 목록에서 파일 형식을 선택할 수 있습니다.The user can choose a file type from this list to filter by. 기본적으로 첫 번째 항목 (예를 들어, 첫 번째 파일 형식) 목록에서 선택 하면 합니다 OpenFileDialog 또는 SaveFileDialog 표시 됩니다.By default, the first item in the list (for example, the first file type) is selected when the OpenFileDialog or SaveFileDialog is displayed. 설정 선택 하는 다른 파일 형식을 지정 하려면를 FilterIndex 표시 되기 전에 속성을 OpenFileDialog 또는 SaveFileDialog (호출 하 여 ShowDialog).To specify that another file type to be selected, you set the FilterIndex property before showing the OpenFileDialog or SaveFileDialog (by calling ShowDialog).

적용 대상

추가 정보