OpenFileDialog クラス

.NET Framework クラス ライブラリ リファレンス

OpenFileDialog クラス

ユーザーにファイルを開くよう要求します。このクラスは継承できません。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OpenFileDialog
    Inherits FileDialog

Visual Basic (使用法)

Dim instance As OpenFileDialog

C#

public sealed class OpenFileDialog : FileDialog

C++

public ref class OpenFileDialog sealed : public
 FileDialog

J#

public final class OpenFileDialog extends FileDialog

JScript

public final class OpenFileDialog extends
 FileDialog

解説

このクラスを使用すると、ファイルが存在するかどうかを確認してから、そのファイルを開くことができます。ShowReadOnly プロパティは、ダイアログ ボックスに読み取り専用チェック ボックスを表示するかどうかを決定します。ReadOnlyChecked プロパティは、読み取り専用チェック ボックスがオンかオフかを示します。

このクラスのほとんどの機能は FileDialog クラスにあります。

ユーザーがファイルではなくフォルダを選択できるようにする場合は、代わりに FolderBrowserDialog を使用します。

使用例

OpenFileDialog を作成し、いくつかのプロパティを設定し、CommonDialog.ShowDialog メソッドを使用してダイアログ ボックスを表示するコード例を次に示します。この例では、フォームに Button が配置されており、System.IO 名前空間が追加されている必要があります。

Visual Basic

Private 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#

private 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++

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() == ::DialogResult::OK
 )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr
 )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

J#

protected void button1_Click(Object sender,
 System.EventArgs e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();
    openFileDialog1.set_InitialDirectory("c:\\");
    openFileDialog1.set_Filter(
        "txt files (*.txt)|*.txt|All files (*.*)|*.*");
    openFileDialog1.set_FilterIndex(2);
    openFileDialog1.set_RestoreDirectory(true);
    if (openFileDialog1.ShowDialog().Equals(get_DialogResult().OK))
 {
        if ((myStream = openFileDialog1.OpenFile()) != null)
 {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
} //button1_Click

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
OpenFileDialog メンバ
System.Windows.Forms 名前空間
FileDialog クラス
CommonDialog クラス
SaveFileDialog