OpenFileDialog 클래스
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
사용자가 파일을 열도록 요청하는 표준 대화 상자를 표시합니다. 이 클래스는 상속될 수 없습니다.
public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog
public sealed class OpenFileDialog : System.Windows.Forms.FileDialog
type OpenFileDialog = class
inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
- 상속
다음 코드 예제에서는 을 OpenFileDialog만들고 파일 확장명 필터 및 대화 동작을 정의하는 여러 속성을 설정하고 메서드를 사용하여 CommonDialog.ShowDialog 대화 상자를 표시합니다. 이 예제에서는 에 배치된 양식 Button 과 네임스페이스에 추가된 네임스페이스에 대한 참조가 System.IO 필요합니다.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
Stream^ myStream;
OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;
openFileDialog1->InitialDirectory = "c:\\";
openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog1->FilterIndex = 2;
openFileDialog1->RestoreDirectory = true;
if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
{
if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
{
// Insert code to read the stream here.
myStream->Close();
}
}
}
var fileContent = string.Empty;
var filePath = string.Empty;
using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
openFileDialog.InitialDirectory = "c:\\";
openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog.FilterIndex = 2;
openFileDialog.RestoreDirectory = true;
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
//Get the path of specified file
filePath = openFileDialog.FileName;
//Read the contents of the file into a stream
var fileStream = openFileDialog.OpenFile();
using (StreamReader reader = new StreamReader(fileStream))
{
fileContent = reader.ReadToEnd();
}
}
}
MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Dim myStream As Stream = Nothing
Dim openFileDialog1 As New OpenFileDialog()
openFileDialog1.InitialDirectory = "c:\"
openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
openFileDialog1.FilterIndex = 2
openFileDialog1.RestoreDirectory = True
If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
Try
myStream = openFileDialog1.OpenFile()
If (myStream IsNot Nothing) Then
' Insert code to read the stream here.
End If
Catch Ex As Exception
MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
Finally
' Check this again, since we need to make sure we didn't throw an exception on open.
If (myStream IsNot Nothing) Then
myStream.Close()
End If
End Try
End If
End Sub
이 클래스를 사용하면 파일이 있는지 여부를 검사 열 수 있습니다. 속성은 ShowReadOnly 대화 상자에 읽기 전용 검사 상자가 표시되는지 여부를 결정합니다. 속성은 ReadOnlyChecked 읽기 전용 검사 확인란이 선택되어 있는지 여부를 나타냅니다.
이 클래스의 핵심 기능은 대부분 클래스에서 찾을 수 FileDialog 있습니다.
오른쪽에서 왼쪽 운영 체제에서 포함 폼의 RightToLeft 속성을 로 설정하면 RightToLeft.Yes 대화 상자의 파일 이름, 열기 및 취소 단추가 지역화됩니다. 속성이 로 설정 RightToLeft.Yes되지 않은 경우 영어 텍스트가 대신 사용됩니다.
사용자에게 파일 대신 폴더를 선택할 수 있는 기능을 제공하려면 대신 을 사용합니다 FolderBrowserDialog .
Open |
OpenFileDialog 클래스의 인스턴스를 초기화합니다. |
Add |
확장명을 생략한 경우 대화 상자가 파일 이름에 확장명을 자동으로 추가할지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Add |
대화 상자에서 열려 있는 파일을 최근 목록에 추가할지 아니면 저장할지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Auto |
Windows Vista에서 실행할 때 이 FileDialog instance 모양과 동작을 자동으로 업그레이드해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Can |
구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
Check |
존재하지 않는 파일 이름을 지정할 때 대화 상자에 경고가 표시되는지를 나타내는 값을 가져오거나 설정합니다. |
Check |
존재하지 않는 경로를 지정할 때 대화 상자에 경고가 표시되는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Client |
이 대화 상자 상태에 연결할 GUID를 가져오거나 설정합니다. 일반적으로 마지막으로 방문한 폴더와 대화 상자의 위치 및 크기와 같은 상태는 실행 파일의 이름에 따라 유지됩니다. GUID를 지정하면 동일한 애플리케이션 내에서 대화 상자의 버전마다 지속 상태가 달라질 수 있습니다(예: 가져오기 대화 상자와 열기 대화 상자). 애플리케이션에서 비주얼 스타일을 사용하지 않거나 AutoUpgradeEnabled가 |
Container |
IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component) |
Custom |
이 FileDialog 인스턴스의 사용자 지정 위치 컬렉션을 가져옵니다. (다음에서 상속됨 FileDialog) |
Default |
기본 확장명을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Dereference |
대화 상자가 바로 가기(.lnk)의 위치 또는 바로 가기가 참조하는 파일의 위치를 반환할지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Design |
Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
Events |
이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component) |
File |
파일 대화 상자에서 선택한 파일 이름을 포함하는 문자열을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
File |
대화 상자에서 선택한 모든 파일의 파일 이름을 가져옵니다. (다음에서 상속됨 FileDialog) |
Filter |
대화 상자에서 "파일 형식으로 저장" 또는 "파일 형식" 상자에 표시되는 선택 옵션을 결정하는 현재 파일 이름 필터 문자열을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Filter |
파일 대화 상자에서 현재 선택한 필터의 인덱스를 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Initial |
파일 대화 상자가 표시하는 초기 디렉터리를 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Instance |
애플리케이션의 Win32 인스턴스 핸들을 가져옵니다. (다음에서 상속됨 FileDialog) |
Multiselect |
대화 상자에서 여러 파일을 선택할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
Ok |
사용자가 보기를 탐색하거나 파일 이름을 편집할 때까지 대화 상자의 확인 단추를 사용할 수 없는지 여부를 나타내는 값을 가져오거나 설정합니다(해당하는 경우). (다음에서 상속됨 FileDialog) |
Options |
FileDialog를 초기화할 값을 가져옵니다. (다음에서 상속됨 FileDialog) |
Read |
읽기 전용 확인란이 선택되었는지 여부를 나타내는 값을 가져오거나 설정합니다. |
Restore |
대화 상자를 닫기 전에 대화 상자에서 디렉터리를 이전에 선택한 디렉터리로 복원할지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Safe |
대화 상자에서 선택한 파일의 파일 이름과 확장명을 가져옵니다. 파일 이름에 경로는 포함되지 않습니다. |
Safe |
대화 상자에서 선택한 모든 파일의 파일 이름과 확장명의 배열을 가져옵니다. 파일 이름에 경로는 포함되지 않습니다. |
Select |
대화 상자에서 읽기 전용 파일을 선택할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
Show |
도움말 단추가 파일 대화 상자에 표시되는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Show |
대화 상자에 숨겨진 파일과 시스템 파일이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Show |
보기의 탐색 창에 기본적으로 표시되는 항목이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Show |
대화 상자에 선택한 파일의 미리 보기가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. |
Show |
대화 상자에 읽기 전용 확인란이 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
Site |
Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component) |
Support |
대화 상자에서 파일 확장명이 여러 개인 파일의 표시 및 저장을 지원하는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Tag |
컨트롤에 대한 데이터가 들어 있는 개체를 가져오거나 설정합니다. (다음에서 상속됨 CommonDialog) |
Title |
파일 대화 상자 제목을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Validate |
대화 상자에서 유효한 Win32 파일 이름만 사용할 수 있는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FileDialog) |
Create |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
Dispose() |
Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component) |
Dispose(Boolean) |
Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 Component) |
Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
Get |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
Get |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
Get |
Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component) |
Get |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
Hook |
파일 대화 상자에 특정 기능을 추가하도록 재정의된 일반 대화 상자의 후크 프로시저를 정의합니다. (다음에서 상속됨 FileDialog) |
Initialize |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject) |
Memberwise |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
Memberwise |
현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
On |
FileOk 이벤트를 발생시킵니다. (다음에서 상속됨 FileDialog) |
On |
HelpRequest 이벤트를 발생시킵니다. (다음에서 상속됨 CommonDialog) |
Open |
사용자가 선택한 파일을 읽기 전용 권한을 사용하여 엽니다. 이 파일은 FileName 속성을 사용하여 지정됩니다. |
Owner |
일반 대화 상자에 특정 기능을 추가하도록 재정의된 소유자 창 프로시저를 정의합니다. (다음에서 상속됨 CommonDialog) |
Reset() |
모든 속성을 기본값으로 다시 설정합니다. |
Run |
일반 대화 상자를 지정합니다. (다음에서 상속됨 FileDialog) |
Show |
기본 소유자로 일반 대화 상자를 실행합니다. (다음에서 상속됨 CommonDialog) |
Show |
지정된 소유자로 일반 대화 상자를 실행합니다. (다음에서 상속됨 CommonDialog) |
To |
이 개체의 문자열 버전을 제공합니다. (다음에서 상속됨 FileDialog) |
Disposed |
Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component) |
File |
사용자가 파일 대화 상자의 열기 또는 저장 단추를 클릭할 때 발생합니다. (다음에서 상속됨 FileDialog) |
Help |
일반 대화 상자의 도움말 단추를 클릭하면 발생합니다. (다음에서 상속됨 CommonDialog) |
제품 | 버전 |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.