OpenFileDialog 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
사용자가 하나 이상의 파일을 열 파일 이름을 지정할 수 있는 일반적인 대화 상자를 나타냅니다.
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 방법을 보여 줍니다.
// 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) |