FileDialog クラス

ユーザーがファイルを選択するダイアログ ボックスを表示します。

この型のすべてのメンバの一覧については、FileDialog メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.CommonDialog
            System.Windows.Forms.FileDialog
               System.Windows.Forms.OpenFileDialog
               System.Windows.Forms.SaveFileDialog

MustInherit Public Class FileDialog
   Inherits CommonDialog
[C#]
public abstract class FileDialog : CommonDialog
[C++]
public __gc __abstract class FileDialog : public CommonDialog
[JScript]
public abstract class FileDialog extends CommonDialog

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

FileDialog は抽象クラスであり、直接作成することはできません。また、このクラスから継承することもできません。ファイルの選択または保存を行うためのダイアログ ボックスを作成するには、 OpenFileDialog または SaveFileDialog を使用します。

FileDialog はモーダル ダイアログ ボックスです。このため、このダイアログ ボックスが表示されているときは、ユーザーがファイルを選択するまでアプリケーションの他の機能は動作しません。ダイアログ ボックスがモーダルとして表示されている場合、キーボードやマウス クリックによる入力は、ダイアログ ボックスのオブジェクトに対してしか発生しません。呼び出しプログラムに対する入力が発生する前に、プログラムが (通常、何らかのユーザーの操作に対する応答として) ダイアログ ボックスを非表示にするか、または終了する必要があります。

使用例

[Visual Basic, C#, C++] FileDialog の OpenFileDialog 実装を使用し、ダイアログ ボックスの作成、そのプロパティの設定、およびダイアログ ボックスの表示を実行する例を次に示します。この例では、 ShowDialog メソッドを使用してダイアログ ボックスを表示し、 DialogResult を返しています。この例は、フォームに Button が配置され、 System.IO 名前空間が追加されていることを前提にしています。

 
Protected Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    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() = DialogResult.OK Then
        myStream = openFileDialog1.OpenFile()
        If Not (myStream Is Nothing) Then
            ' Insert code to read the stream here.
            myStream.Close()
        End If
    End If
End Sub


[C#] 
protected void button1_Click(object sender, System.EventArgs e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();

    openFileDialog1.InitialDirectory = "c:\\" ;
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
    openFileDialog1.FilterIndex = 2 ;
    openFileDialog1.RestoreDirectory = true ;

    if(openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        if((myStream = openFileDialog1.OpenFile())!= null)
        {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
}


[C++] 
protected:
 void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/)
 {
     Stream* myStream;
     OpenFileDialog* openFileDialog1 = new OpenFileDialog();
 
     openFileDialog1->InitialDirectory = S"c:\\" ;
     openFileDialog1->Filter = S"txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
     openFileDialog1->FilterIndex = 2 ;
     openFileDialog1->RestoreDirectory = true ;
 
     if(openFileDialog1->ShowDialog() == DialogResult::OK)
     {
         if((myStream = openFileDialog1->OpenFile())!= 0)
         {
             // Insert code to read the stream here.
             myStream->Close();
         }
     }
 }
 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

FileDialog メンバ | System.Windows.Forms 名前空間 | CommonDialog | OpenFileDialog | SaveFileDialog