OpenFileDialog クラス

定義

1 つ以上の開くファイルの名前を指定できるコモン ダイアログ ボックスを表します。

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

次の例は、既定のファイル名と拡張子の種類を含む を 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 == true)
{
    // 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

注釈

次の図は、Windows Vista の を OpenFileDialog 示しています。

[開く] ダイアログ ボックス

Windows Vista 以降では、ファイルを開いて保存するダイアログ ボックスの左側に [お気に入りのリンク ] パネルが表示され、ユーザーは別の場所にすばやく移動できます。 これらのリンクは、カスタム の場所と呼ばれます。 プロパティを CustomPlaces 使用して、このリンクの一覧を設定します。

XAML テキストの使用法

XAML でこのマネージド クラスを宣言することはできません。

コンストラクター

OpenFileDialog()

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

プロパティ

AddExtension

ユーザーが拡張子を省略した場合に、ファイル ダイアログで自動的にファイル名に拡張子を付けるかどうかを示す値を取得または設定します。

(継承元 FileDialog)
CheckFileExists

存在しないファイル名をユーザーが指定した場合に、ファイル ダイアログで警告を表示するかどうかを示す値を取得または設定します。

(継承元 FileDialog)
CheckPathExists

ユーザーが無効なパスとファイル名を入力した場合に警告を表示するかどうかを指定する値を取得または設定します。

(継承元 FileDialog)
CustomPlaces

ファイル ダイアログ ボックスのカスタム プレースのリストを取得または設定します。

(継承元 FileDialog)
DefaultExt

表示されるファイル リストにフィルターを適用するための既定の拡張子文字列を指定する値を取得または設定します。

(継承元 FileDialog)
DereferenceLinks

ファイル ダイアログが、ショートカットで参照されたファイルの場所を返すか、ショートカット ファイル (.lnk) の場所を返すかを示す値を取得または設定します。

(継承元 FileDialog)
FileName

ファイル ダイアログで選択されたファイルの完全なパスを含む文字列を取得または設定します。

(継承元 FileDialog)
FileNames

選択されたファイルごとに 1 つずつファイル名を格納する配列を取得します。

(継承元 FileDialog)
Filter

OpenFileDialog または SaveFileDialog で表示されるファイルの種類を決定するフィルター文字列を取得または設定します。

(継承元 FileDialog)
FilterIndex

ファイル ダイアログで現在選択されているフィルターのインデックスを取得または設定します。

(継承元 FileDialog)
InitialDirectory

ファイル ダイアログに表示される初期ディレクトリを取得または設定します。

(継承元 FileDialog)
Multiselect

OpenFileDialog でユーザーが複数のファイルを選択できるかどうかを示すオプションを取得または設定します。

Options

初期化のためにファイル ダイアログで使用される Win32 共通ファイル ダイアログ フラグを取得します。

(継承元 FileDialog)
ReadOnlyChecked

OpenFileDialog で表示される読み取り専用チェック ボックスがオンかオフかを示す値を取得または設定します。

RestoreDirectory

このプロパティは実装されていません。

(継承元 FileDialog)
SafeFileName

選択されたファイルのファイル名のみを格納する文字列を取得します。

(継承元 FileDialog)
SafeFileNames

選択されたファイルごとに 1 つずつ安全なファイル名を格納する配列を取得します。

(継承元 FileDialog)
ShowReadOnly

OpenFileDialog に読み取り専用チェック ボックスが表示されているかどうかを示す値を取得または設定します。

Tag

ダイアログ ボックスに関連付けられているオブジェクトを取得または設定します。 これにより、ダイアログ ボックスに任意のオブジェクトを結びつけることができます。

(継承元 CommonDialog)
Title

ファイル ダイアログのタイトル バーに表示されるテキストを取得または設定します。

(継承元 FileDialog)
ValidateNames

ダイアログが有効な Win32 ファイル名のみを受け入れるかどうかを示す値を取得または設定します。

(継承元 FileDialog)

メソッド

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 を使用してユーザーが選択したファイルごとに 1 つの読み取り専用ストリームを含む配列を作成します。

Reset()

すべての OpenFileDialog プロパティを既定値にリセットします。

RunDialog(IntPtr)

RunDialog(IntPtr) は、派生クラス (OpenFileDialogSaveFileDialog など) のファイル ダイアログを表示するために呼び出されます。

(継承元 FileDialog)
ShowDialog()

コモン ダイアログ ボックスを表示します。

(継承元 CommonDialog)
ShowDialog(Window)

コモン ダイアログ ボックスを表示します。

(継承元 CommonDialog)
ToString()

ファイル ダイアログを表す文字列を返します。

(継承元 FileDialog)

events

FileOk

ユーザーが OpenFileDialog[開く] ボタンまたは SaveFileDialog[保存] ボタンをクリックして、ファイル名を選択したときに発生します。

(継承元 FileDialog)

適用対象

こちらもご覧ください