OpenFileDialog OpenFileDialog OpenFileDialog OpenFileDialog Class

정의

사용자가 하나 이상의 파일 열기에 대 한 파일 이름을 지정 하도록 허용 하는 일반 대화 상자를 나타냅니다.Represents a common dialog box that allows a user to specify a filename for one or more files to open.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class OpenFileDialog : Microsoft.Win32.FileDialog
type OpenFileDialog = class
    inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
상속

예제

다음 예제에서는 만드는 방법을 보여 줍니다는 OpenFileDialog 기본 파일 이름 및 확장명 형식을 포함 하는 합니다.The following example shows how to create an OpenFileDialog that contains a default file name and extension type.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}
' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dlg.FileName
End If

설명

다음 그림에서는 OpenFileDialog 에 대 한 Windows VistaWindows Vista합니다.The following figure shows an OpenFileDialog for Windows VistaWindows Vista.

열기 대화 상자Open dialog box

부터 Windows VistaWindows Vista저장 파일 대화 상자를 열고는 즐겨찾기 링크 신속 하 게 다른 위치로 이동할 수 있는 대화 상자의 왼쪽에서 패널입니다.Starting in Windows VistaWindows Vista, open and save file dialog boxes have a Favorite Links panel on the left side of the dialog box that allows the user to quickly navigate to a different location. 이러한 링크는 사용자 지정 위치 라고 합니다.These links are called custom places. 사용 된 CustomPlaces 속성을이 링크 목록을 설정 합니다.Use the CustomPlaces property to set this list of links.

XAML 텍스트 사용XAML Text Usage

관리 되는이 클래스를 선언할 수 없습니다 XAMLXAML합니다.You cannot declare this managed class in XAMLXAML.

생성자

OpenFileDialog() OpenFileDialog() OpenFileDialog() OpenFileDialog()

OpenFileDialog 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OpenFileDialog class.

속성

AddExtension AddExtension AddExtension AddExtension

확장명이 생략된 경우 파일 대화 상자에서 파일 이름에 확장명을 자동으로 추가할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a file dialog automatically adds an extension to a file name if the user omits an extension.

(Inherited from FileDialog)
CheckFileExists CheckFileExists CheckFileExists CheckFileExists

존재하지 않는 파일 이름이 지정된 경우 파일 대화 상자에 경고를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a file dialog displays a warning if the user specifies a file name that does not exist.

(Inherited from FileDialog)
CheckPathExists CheckPathExists CheckPathExists CheckPathExists

경로 및 파일 이름이 잘못 입력된 경우 경고를 표시할지 여부를 지정하는 값을 가져오거나 설정합니다.Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names.

(Inherited from FileDialog)
CustomPlaces CustomPlaces CustomPlaces CustomPlaces

파일 대화 상자에 대한 사용자 지정 위치 목록을 가져오거나 설정합니다.Gets or sets the list of custom places for file dialog boxes.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt DefaultExt

표시되는 파일 목록을 필터링하는 데 사용되는 기본 확장명 문자열을 지정하는 값을 가져오거나 설정합니다.Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed.

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks DereferenceLinks

파일 대화 상자가 바로 가기로 참조되는 파일 위치를 반환하는지 아니면 바로 가기 파일(.lnk)의 위치를 반환하는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a file dialog returns either the location of the file referenced by a shortcut or the location of the shortcut file (.lnk).

(Inherited from FileDialog)
FileName FileName FileName FileName

파일 대화 상자에서 선택한 파일의 전체 경로가 들어 있는 문자열을 가져오거나 설정합니다.Gets or sets a string containing the full path of the file selected in a file dialog.

(Inherited from FileDialog)
FileNames FileNames FileNames FileNames

선택한 각 파일의 이름이 하나씩 들어 있는 배열을 가져옵니다.Gets an array that contains one file name for each selected file.

(Inherited from FileDialog)
Filter Filter Filter Filter

OpenFileDialog 또는 SaveFileDialog에 표시되는 파일 형식을 결정하는 필터 문자열을 가져오거나 설정합니다.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog.

(Inherited from FileDialog)
FilterIndex FilterIndex FilterIndex FilterIndex

파일 대화 상자에서 현재 선택한 필터의 인덱스를 가져오거나 설정합니다.Gets or sets the index of the filter currently selected in a file dialog.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory InitialDirectory

파일 대화 상자에 표시되는 초기 디렉터리를 가져오거나 설정합니다.Gets or sets the initial directory that is displayed by a file dialog.

(Inherited from FileDialog)
Multiselect Multiselect Multiselect Multiselect

표시 되는 옵션을 가져오거나 여부 OpenFileDialog 여러 파일을 선택할 수 있습니다.Gets or sets an option indicating whether OpenFileDialog allows users to select multiple files.

Options Options Options Options

파일 대화 상자에서 초기화에 사용하는 Win32Win32 공용 파일 대화 상자 플래그를 가져옵니다.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

(Inherited from FileDialog)
ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked

읽기 전용 확인란이 표시 되는지를 나타내는 값을 가져오거나 설정 합니다. OpenFileDialog 을 선택 합니다.Gets or sets a value indicating whether the read-only check box displayed by OpenFileDialog is selected.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

이 속성이 구현되지 않습니다.This property is not implemented.

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName SafeFileName

선택한 파일의 파일 이름만 들어 있는 문자열을 가져옵니다.Gets a string that only contains the file name for the selected file.

(Inherited from FileDialog)
SafeFileNames SafeFileNames SafeFileNames SafeFileNames

선택한 각 파일의 안전한 파일 이름이 하나씩 들어 있는 배열을 가져옵니다.Gets an array that contains one safe file name for each selected file.

(Inherited from FileDialog)
ShowReadOnly ShowReadOnly ShowReadOnly ShowReadOnly

나타내는 값을 가져오거나 여부 OpenFileDialog 읽기 전용 확인란이 있습니다.Gets or sets a value indicating whether OpenFileDialog contains a read-only check box.

Tag Tag Tag Tag

대화 상자를 사용 하 여 연결 된 개체를 가져오거나 설정 합니다.Gets or sets an object associated with the dialog. 이 대화 상자에 임의의 개체를 연결 하는 기능을 제공 합니다.This provides the ability to attach an arbitrary object to the dialog.

(Inherited from CommonDialog)
Title Title Title Title

파일 대화 상자의 제목 표시줄에 나타나는 텍스트를 가져오거나 설정합니다.Gets or sets the text that appears in the title bar of a file dialog.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames ValidateNames

대화 상자에서 유효한 Win32Win32 파일 이름만 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

(Inherited from FileDialog)

메서드

CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog()

대화 상자를 표시 하는 것에 대 한 충분 한 권한이 있는지 확인 합니다.Determines whether sufficient permissions for displaying a dialog exist.

(Inherited from CommonDialog)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr)

파일 대화 상자에 공통 기능을 추가하기 위해 재정의된 공용 파일 대화 상자 후크 프로시저를 정의합니다.Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog.

(Inherited from FileDialog)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

FileOk 이벤트를 발생시킵니다.Raises the FileOk event.

(Inherited from FileDialog)
OpenFile() OpenFile() OpenFile() OpenFile()

사용 하 여 사용자가 선택한 파일에 대 한 읽기 전용 스트림을 엽니다 OpenFileDialog합니다.Opens a read-only stream for the file that is selected by the user using OpenFileDialog.

OpenFiles() OpenFiles() OpenFiles() OpenFiles()

사용 하 여 사용자가 선택한 각 파일에 대 한 읽기 전용 스트림을 두 개를 포함 하는 배열을 만듭니다 OpenFileDialog합니다.Creates an array that contains one read-only stream for each file selected by the user using OpenFileDialog.

Reset() Reset() Reset() Reset()

모든 다시 설정 OpenFileDialog 기본값으로 속성입니다.Resets all OpenFileDialog properties to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

RunDialog(IntPtr)OpenFileDialog, SaveFileDialog 등의 파생 클래스에 파일 대화 상자를 표시하기 위해 호출됩니다.RunDialog(IntPtr) is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog.

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() ShowDialog()

공용 대화 상자를 표시합니다.Displays a common dialog.

(Inherited from CommonDialog)
ShowDialog(Window) ShowDialog(Window) ShowDialog(Window) ShowDialog(Window)

공용 대화 상자를 표시합니다.Displays a common dialog.

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

파일 대화 상자를 나타내는 문자열을 반환합니다.Returns a string that represents a file dialog.

(Inherited from FileDialog)

이벤트

FileOk FileOk FileOk FileOk

사용자가 OpenFileDialog열기 단추나 SaveFileDialog저장 단추를 클릭하여 파일 이름을 선택할 때 발생합니다.Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog.

(Inherited from FileDialog)

적용 대상

추가 정보