OpenFileDialog 클래스

정의

네임스페이스:

Microsoft.Win32

어셈블리:

PresentationFramework.dll

하나 이상의 파일 이름을 지정하여 열 수 있는 공용 대화 상자를 나타냅니다.

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

상속

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

예제

다음 예제에서는 기본 파일 이름 및 확장명 형식을 포함하는 을 만드는 OpenFileDialog 방법을 보여 줍니다.

// 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

설명

XAML에서는 이 관리되는 클래스를 선언할 수 없습니다.

생성자

OpenFileDialog()

OpenFileDialog 클래스의 새 인스턴스를 초기화합니다.

속성

AddExtension	확장명이 생략된 경우 파일 대화 상자에서 파일 이름에 확장명을 자동으로 추가할지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
AddToRecent	대화 상자에서 열려 있는 항목을 최근 문서 목록에 추가할지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 CommonItemDialog)
CheckFileExists	존재하지 않는 파일 이름이 지정된 경우 파일 대화 상자에 경고를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
CheckPathExists	경로 및 파일 이름이 잘못 입력된 경우 경고를 표시할지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
ClientGuid	대화 상자의 지속형 상태와 연결할 GUID를 가져오거나 설정합니다. (다음에서 상속됨 CommonItemDialog)
CustomPlaces	파일 대화 상자에 대한 사용자 지정 위치 목록을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
DefaultDirectory	최근에 사용한 디렉터리 값을 사용할 수 없는 경우 파일 대화 상자에 표시되는 디렉터리를 가져오거나 설정합니다. (다음에서 상속됨 CommonItemDialog)
DefaultExt	표시되는 파일 목록을 필터링하는 데 사용되는 기본 확장명 문자열을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
DereferenceLinks	파일 대화 상자가 바로 가기로 참조되는 파일 위치를 반환하는지 아니면 바로 가기 파일(.lnk)의 위치를 반환하는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
FileName	파일 대화 상자에서 선택한 파일의 전체 경로가 들어 있는 문자열을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
FileNames	선택한 각 파일의 이름이 하나씩 들어 있는 배열을 가져옵니다. (다음에서 상속됨 FileDialog)
Filter	OpenFileDialog 또는 SaveFileDialog에 표시되는 파일 형식을 결정하는 필터 문자열을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
FilterIndex	파일 대화 상자에서 현재 선택한 필터의 인덱스를 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
ForcePreviewPane	대화 상자가 미리 보기 창을 강제로 켜는지 여부를 나타내는 옵션 플래그를 가져오거나 설정합니다.
InitialDirectory	파일 대화 상자에 표시되는 초기 디렉터리를 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
Multiselect	OpenFileDialog에서 여러 파일을 선택할 수 있는지 여부를 나타내는 옵션을 가져오거나 설정합니다.
Options	초기화를 위해 파일 대화 상자에서 사용되는 Win32 일반 파일 대화 상자 플래그를 가져옵니다. (다음에서 상속됨 FileDialog)
ReadOnlyChecked	OpenFileDialog에 표시된 읽기 전용 확인란이 선택되었는지 여부를 나타내는 값을 가져오거나 설정합니다.
RestoreDirectory	이 속성이 구현되지 않습니다. (다음에서 상속됨 FileDialog)
RootDirectory	대화 상자의 탐색 루트로 표시되는 디렉터리를 가져오거나 설정합니다. (다음에서 상속됨 CommonItemDialog)
SafeFileName	선택한 파일의 파일 이름만 들어 있는 문자열을 가져옵니다. (다음에서 상속됨 FileDialog)
SafeFileNames	선택한 각 파일의 안전한 파일 이름이 하나씩 들어 있는 배열을 가져옵니다. (다음에서 상속됨 FileDialog)
ShowHiddenItems	사용자 기본 설정에 관계없이 대화 상자에 숨겨진 항목과 시스템 항목이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 CommonItemDialog)
ShowReadOnly	OpenFileDialog에 읽기 전용 확인란이 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
Tag	대화 상자에 연결된 개체를 가져오거나 설정합니다. 이를 통해 대화 상자에 임의의 개체를 연결할 수 있습니다. (다음에서 상속됨 CommonDialog)
Title	파일 대화 상자의 제목 표시줄에 나타나는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)
ValidateNames	대화 상자에서 유효한 Win32 파일 이름만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog)

메서드

CheckPermissionsToShowDialog()	대화 상자를 표시할 수 있는 충분한 권한이 있는지 확인합니다. (다음에서 상속됨 CommonDialog)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	파일 대화 상자에 공통 기능을 추가하기 위해 재정의된 공용 파일 대화 상자 후크 프로시저를 정의합니다. (다음에서 상속됨 FileDialog)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnFileOk(CancelEventArgs)	FileOk 이벤트를 발생시킵니다. (다음에서 상속됨 FileDialog)
OnItemOk(CancelEventArgs)	FileOk 이벤트를 발생시킵니다. (다음에서 상속됨 FileDialog)
OpenFile()	사용자가 OpenFileDialog를 사용하여 선택한 파일에 대한 읽기 전용 스트림을 엽니다.
OpenFiles()	사용자가 OpenFileDialog를 사용하여 선택한 각 파일에 대한 읽기 전용 스트림이 하나씩 들어 있는 배열을 만듭니다.
Reset()	모든 OpenFileDialog 속성을 기본값으로 다시 설정합니다.
RunDialog(IntPtr)	RunDialog(IntPtr)는 OpenFileDialog 및 SaveFileDialog 등의 파생 클래스에서 파일 대화 상자를 표시하기 위해 호출됩니다. (다음에서 상속됨 FileDialog)
ShowDialog()	공용 대화 상자를 표시합니다. (다음에서 상속됨 CommonDialog)
ShowDialog(Window)	공용 대화 상자를 표시합니다. (다음에서 상속됨 CommonDialog)
ToString()	파일 대화 상자를 나타내는 문자열을 반환합니다. (다음에서 상속됨 FileDialog)

이벤트

FileOk

사용자가 OpenFileDialog의 열기 단추나 SaveFileDialog의 저장 단추를 클릭하여 파일 이름을 선택할 때 발생합니다. (다음에서 상속됨 FileDialog)

추가 정보

• SaveFileDialog