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

注釈

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

コンストラクター

OpenFileDialog()

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

プロパティ

AddExtension

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

(継承元 FileDialog)
AddToRecent

ダイアログ ボックスで、開いているアイテムを追加するか、最近使用したドキュメント リストに保存するかを示す値を取得または設定します。

(継承元 CommonItemDialog)
CheckFileExists

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

(継承元 FileDialog)
CheckPathExists

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

(継承元 FileDialog)
ClientGuid

ダイアログの永続化された状態に関連付ける GUID を取得または設定します。

(継承元 CommonItemDialog)
CustomPlaces

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

(継承元 FileDialog)
DefaultDirectory

最近使用したディレクトリ値が使用できない場合に、ファイル ダイアログ ボックスに表示されるディレクトリを取得または設定します。

(継承元 CommonItemDialog)
DefaultExt

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

(継承元 FileDialog)
DereferenceLinks

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

(継承元 FileDialog)
FileName

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

(継承元 FileDialog)
FileNames

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

(継承元 FileDialog)
Filter

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

(継承元 FileDialog)
FilterIndex

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

(継承元 FileDialog)
ForcePreviewPane

ダイアログ ボックスでプレビュー ウィンドウを強制的にオンにするかどうかを示すオプション フラグを取得または設定します。

InitialDirectory

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

(継承元 FileDialog)
Multiselect

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

Options

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

(継承元 FileDialog)
ReadOnlyChecked

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

RestoreDirectory

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

(継承元 FileDialog)
RootDirectory

ダイアログのナビゲーション ルートとして表示されるディレクトリを取得または設定します。

(継承元 CommonItemDialog)
SafeFileName

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

(継承元 FileDialog)
SafeFileNames

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

(継承元 FileDialog)
ShowHiddenItems

ユーザー設定に関係なく、ダイアログ ボックスに非表示およびシステム項目が表示されるかどうかを示す値を取得または設定します。

(継承元 CommonItemDialog)
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)
OnItemOk(CancelEventArgs)

FileOk イベントを発生させます。

(継承元 FileDialog)
OpenFile()

OpenFileDialog を使用してユーザーが選択するファイルの読み取り専用ストリームを開きます。

OpenFiles()

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

Reset()

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

RunDialog(IntPtr)

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

(継承元 FileDialog)
ShowDialog()

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

(継承元 CommonDialog)
ShowDialog(Window)

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

(継承元 CommonDialog)
ToString()

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

(継承元 FileDialog)

イベント

FileOk

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

(継承元 FileDialog)

適用対象

こちらもご覧ください