OpenFileDialog 클래스

정의

사용자가 하나 이상의 파일을 열 파일 이름을 지정할 수 있는 일반적인 대화 상자를 나타냅니다.

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

예제

다음 예제에서는 기본 파일 이름 및 확장명 형식을 포함하는 파일을 만드는 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.Value)
{
    // 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에서는 이 관리되는 클래스를 선언할 수 없습니다.

생성자

Name Description
OpenFileDialog()

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

속성

Name Description
AddExtension

사용자가 확장명을 생략할 경우 파일 대화 상자에서 파일 이름에 확장명을 자동으로 추가할지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
CheckFileExists

사용자가 존재하지 않는 파일 이름을 지정하는 경우 파일 대화 상자에 경고가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
CheckPathExists

사용자가 잘못된 경로 및 파일 이름을 지정하는 경우 경고가 표시되는지 여부를 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
CustomPlaces

파일 대화 상자의 사용자 지정 위치 목록을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
DefaultExt

표시되는 파일 목록을 필터링하는 데 사용할 기본 확장 문자열을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
DereferenceLinks

파일 대화 상자가 바로 가기에서 참조하는 파일의 위치 또는 바로 가기 파일(.lnk)의 위치를 반환하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
FileName

파일 대화 상자에서 선택한 파일의 전체 경로를 포함하는 문자열을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
FileNames

선택한 각 파일에 대해 하나의 파일 이름을 포함하는 배열을 가져옵니다.

(다음에서 상속됨 FileDialog)
Filter

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

(다음에서 상속됨 FileDialog)
FilterIndex

파일 대화 상자에서 현재 선택된 필터의 인덱스 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
InitialDirectory

파일 대화 상자에 표시되는 초기 디렉터리를 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
Multiselect

사용자가 여러 파일을 선택할 수 있는지 여부를 OpenFileDialog 나타내는 옵션을 가져오거나 설정합니다.

Options

초기화를 위해 파일 대화 상자에서 사용하는 Win32 일반 파일 대화 상자 플래그를 가져옵니다.

(다음에서 상속됨 FileDialog)
ReadOnlyChecked

표시되는 OpenFileDialog 읽기 전용 확인란이 선택되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

RestoreDirectory

이 속성은 구현되지 않습니다.

(다음에서 상속됨 FileDialog)
SafeFileName

선택한 파일의 파일 이름만 포함하는 문자열을 가져옵니다.

(다음에서 상속됨 FileDialog)
SafeFileNames

선택한 각 파일에 대해 하나의 안전한 파일 이름을 포함하는 배열을 가져옵니다.

(다음에서 상속됨 FileDialog)
ShowReadOnly

읽기 전용 확인란이 포함되어 있는지 여부를 OpenFileDialog 나타내는 값을 가져오거나 설정합니다.

Tag

대화 상자와 연결된 개체를 가져오거나 설정합니다. 이렇게 하면 임의의 개체를 대화 상자에 연결할 수 있습니다.

(다음에서 상속됨 CommonDialog)
Title

파일 대화 상자의 제목 표시줄에 표시되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)
ValidateNames

대화 상자에서 유효한 Win32 파일 이름만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FileDialog)

메서드

Name Description
CheckPermissionsToShowDialog()

대화 상자를 표시할 수 있는 충분한 권한이 있는지 여부를 확인합니다.

(다음에서 상속됨 CommonDialog)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

파일 대화 상자에 공통 기능을 추가하도록 재정의되는 일반적인 파일 대화 상자 후크 프로시저를 정의합니다.

(다음에서 상속됨 FileDialog)
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnFileOk(CancelEventArgs)

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

(다음에서 상속됨 FileDialog)
OpenFile()

를 사용하여 OpenFileDialog사용자가 선택한 파일에 대한 읽기 전용 스트림을 엽니다.

OpenFiles()

를 사용하여 OpenFileDialog사용자가 선택한 각 파일에 대해 하나의 읽기 전용 스트림을 포함하는 배열을 만듭니다.

Reset()

모든 OpenFileDialog 속성을 기본값으로 다시 설정합니다.

RunDialog(IntPtr)

RunDialog(IntPtr) 는 다음과 같은 OpenFileDialogSaveFileDialog파생 클래스에 파일 대화 상자를 표시하기 위해 호출됩니다.

(다음에서 상속됨 FileDialog)
ShowDialog()

일반적인 대화 상자를 표시합니다.

(다음에서 상속됨 CommonDialog)
ShowDialog(Window)

일반적인 대화 상자를 표시합니다.

(다음에서 상속됨 CommonDialog)
ToString()

파일 대화 상자를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 FileDialog)

이벤트

Name Description
FileOk

사용자가 파일의 열기 단추 또는 OpenFileDialog단추를 SaveFileDialog 클릭하여 파일 이름을 선택할 때 발생합니다.

(다음에서 상속됨 FileDialog)

적용 대상

추가 정보