OpenFileDialog

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

OpenFileDialog イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	FileOk	ファイル ダイアログ ボックスの [開く] ボタンまたは [保存] ボタンをユーザーがクリックすると発生します。 ( FileDialog から継承されます。)
	HelpRequest	ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。 ( CommonDialog から継承されます。)

参照

関連項目

OpenFileDialog クラス
System.Windows.Forms 名前空間
FileDialog クラス
CommonDialog クラス
SaveFileDialog

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

OpenFileDialog コンストラクタ

OpenFileDialog クラスのインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OpenFileDialog

C#

public OpenFileDialog ()

C++

public:
OpenFileDialog ()

J#

public OpenFileDialog ()

JScript

public function OpenFileDialog ()

解説

これは、コンパイラが提供する OpenFileDialog クラスの既定のコンストラクタです。

プラットフォーム

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 クラス
OpenFileDialog メンバ
System.Windows.Forms 名前空間

OpenFileDialog プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AddExtension	ユーザーが拡張子を指定しない場合、ダイアログ ボックスがファイル名に自動的に拡張子を付けるかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)
	CheckFileExists	オーバーライドされます。 存在しないファイルの名前をユーザーが指定した場合に、ダイアログ ボックスが警告を表示するかどうかを示す値を取得または設定します。
	CheckPathExists	存在しないパスをユーザーが指定したときに、ダイアログ ボックスに警告を表示するかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	DefaultExt	既定のファイル名の拡張子を取得または設定します。 ( FileDialog から継承されます。)
	DereferenceLinks	ダイアログ ボックスが、ショートカットで参照されたファイルの場所を返すかどうか、またはショートカットの場所 (.lnk) を返すかどうかを指定する値を取得または設定します。 ( FileDialog から継承されます。)
	FileName	ファイル ダイアログ ボックスで選択されたファイル名を含む文字列を取得または設定します。 ( FileDialog から継承されます。)
	FileNames	ダイアログ ボックスで選択されたすべてのファイルの名前を取得します。 ( FileDialog から継承されます。)
	Filter	ダイアログ ボックスの [ファイルの種類] ボックスに表示される選択肢を決定する、現在のファイル名のフィルタ文字列を取得または設定します。 ( FileDialog から継承されます。)
	FilterIndex	ファイル ダイアログ ボックスで現在選択されているフィルタのインデックスを取得または設定します。 ( FileDialog から継承されます。)
	InitialDirectory	ファイル ダイアログ ボックスに表示される起動ディレクトリを取得または設定します。 ( FileDialog から継承されます。)
	Multiselect	ダイアログ ボックスで複数のファイルを選択できるかどうかを示す値を取得または設定します。
	ReadOnlyChecked	読み取り専用チェック ボックスがオンかオフかを示す値を取得または設定します。
	RestoreDirectory	ダイアログ ボックスを閉じる前に、現在のディレクトリを復元するかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)
	ShowHelp	ファイル ダイアログ ボックスに [ヘルプ] ボタンを表示するかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	SupportMultiDottedExtensions	複数のファイル名拡張子を持つファイルの表示および保存をダイアログ ボックスがサポートするかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 ( CommonDialog から継承されます。)
	Title	ファイル ダイアログ ボックスのタイトルを取得または設定します。 ( FileDialog から継承されます。)
	ValidateNames	ダイアログ ボックスが有効な Win32 ファイル名だけを受け入れるかどうかを示す値を取得または設定します。 ( FileDialog から継承されます。)

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

OpenFileDialog クラス
System.Windows.Forms 名前空間
FileDialog クラス
CommonDialog クラス
SaveFileDialog

OpenFileDialog メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	OpenFile	ユーザーが選択したファイルを読み取り専用で開きます。このファイルは、FileName プロパティで指定されます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Reset	オーバーライドされます。 すべてのプロパティを既定値にリセットします。
	ShowDialog	オーバーロードされます。 コモン ダイアログ ボックスを実行します。 ( CommonDialog から継承されます。)
	ToString	このオブジェクトの文字列形式を示します。 ( FileDialog から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

OpenFileDialog クラス
System.Windows.Forms 名前空間
FileDialog クラス
CommonDialog クラス
SaveFileDialog

OpenFileDialog メンバ

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

OpenFileDialog データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	OpenFileDialog	OpenFileDialog クラスのインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AddExtension	ユーザーが拡張子を指定しない場合、ダイアログ ボックスがファイル名に自動的に拡張子を付けるかどうかを示す値を取得または設定します。(FileDialog から継承されます。)
	CheckFileExists	オーバーライドされます。 存在しないファイルの名前をユーザーが指定した場合に、ダイアログ ボックスが警告を表示するかどうかを示す値を取得または設定します。
	CheckPathExists	存在しないパスをユーザーが指定したときに、ダイアログ ボックスに警告を表示するかどうかを示す値を取得または設定します。(FileDialog から継承されます。)
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	DefaultExt	既定のファイル名の拡張子を取得または設定します。(FileDialog から継承されます。)
	DereferenceLinks	ダイアログ ボックスが、ショートカットで参照されたファイルの場所を返すかどうか、またはショートカットの場所 (.lnk) を返すかどうかを指定する値を取得または設定します。(FileDialog から継承されます。)
	FileName	ファイル ダイアログ ボックスで選択されたファイル名を含む文字列を取得または設定します。(FileDialog から継承されます。)
	FileNames	ダイアログ ボックスで選択されたすべてのファイルの名前を取得します。(FileDialog から継承されます。)
	Filter	ダイアログ ボックスの [ファイルの種類] ボックスに表示される選択肢を決定する、現在のファイル名のフィルタ文字列を取得または設定します。(FileDialog から継承されます。)
	FilterIndex	ファイル ダイアログ ボックスで現在選択されているフィルタのインデックスを取得または設定します。(FileDialog から継承されます。)
	InitialDirectory	ファイル ダイアログ ボックスに表示される起動ディレクトリを取得または設定します。(FileDialog から継承されます。)
	Multiselect	ダイアログ ボックスで複数のファイルを選択できるかどうかを示す値を取得または設定します。
	ReadOnlyChecked	読み取り専用チェック ボックスがオンかオフかを示す値を取得または設定します。
	RestoreDirectory	ダイアログ ボックスを閉じる前に、現在のディレクトリを復元するかどうかを示す値を取得または設定します。(FileDialog から継承されます。)
	ShowHelp	ファイル ダイアログ ボックスに [ヘルプ] ボタンを表示するかどうかを示す値を取得または設定します。(FileDialog から継承されます。)
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	SupportMultiDottedExtensions	複数のファイル名拡張子を持つファイルの表示および保存をダイアログ ボックスがサポートするかどうかを示す値を取得または設定します。(FileDialog から継承されます。)
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 (CommonDialog から継承されます。)
	Title	ファイル ダイアログ ボックスのタイトルを取得または設定します。(FileDialog から継承されます。)
	ValidateNames	ダイアログ ボックスが有効な Win32 ファイル名だけを受け入れるかどうかを示す値を取得または設定します。(FileDialog から継承されます。)

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	OpenFile	ユーザーが選択したファイルを読み取り専用で開きます。このファイルは、FileName プロパティで指定されます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Reset	オーバーライドされます。 すべてのプロパティを既定値にリセットします。
	ShowDialog	オーバーロードされます。 コモン ダイアログ ボックスを実行します。 (CommonDialog から継承されます。)
	ToString	このオブジェクトの文字列形式を示します。 (FileDialog から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	FileOk	ファイル ダイアログ ボックスの [開く] ボタンまたは [保存] ボタンをユーザーがクリックすると発生します。(FileDialog から継承されます。)
	HelpRequest	ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。(CommonDialog から継承されます。)

参照

関連項目

OpenFileDialog クラス
System.Windows.Forms 名前空間
FileDialog クラス
CommonDialog クラス
SaveFileDialog