SaveFileDialog クラス

定義

ファイルを保存する際に使用するファイル名を指定できるコモン ダイアログ ボックスを表します。 SaveFileDialog は、部分信頼で実行されているアプリケーションでは使用できません。

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class SaveFileDialog : Microsoft.Win32.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
継承
SaveFileDialog

次の例では、結果を作成 SaveFileDialog して処理する方法を示します。

// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show save file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process save file dialog box results
if (result == true)
{
    // Save document
    string filename = dlg.FileName;
}
' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dlg.FileName
End If

注釈

次の図は、SaveFileDialogWindows Vista の場合を示しています。

[名前を付けて保存] ダイアログ ボックス

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

XAML テキストの使用法

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

コンストラクター

SaveFileDialog()

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

プロパティ

AddExtension

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

(継承元 FileDialog)
CheckFileExists

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

(継承元 FileDialog)
CheckPathExists

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

(継承元 FileDialog)
CreatePrompt

ユーザーが存在しないファイルを指定した場合に、ファイルを作成することを確認するメッセージを SaveFileDialog で表示するかどうかを示す値を取得または設定します。

CustomPlaces

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

(継承元 FileDialog)
DefaultExt

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

(継承元 FileDialog)
DereferenceLinks

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

(継承元 FileDialog)
FileName

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

(継承元 FileDialog)
FileNames

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

(継承元 FileDialog)
Filter

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

(継承元 FileDialog)
FilterIndex

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

(継承元 FileDialog)
InitialDirectory

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

(継承元 FileDialog)
Options

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

(継承元 FileDialog)
OverwritePrompt

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

RestoreDirectory

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

(継承元 FileDialog)
SafeFileName

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

(継承元 FileDialog)
SafeFileNames

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

(継承元 FileDialog)
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()

SaveFileDialog を使用してユーザーが選択したファイル名の読み書き可能ファイル ストリームを作成します。

Reset()

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

RunDialog(IntPtr)

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

(継承元 FileDialog)
ShowDialog()

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

(継承元 CommonDialog)
ShowDialog(Window)

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

(継承元 CommonDialog)
ToString()

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

(継承元 FileDialog)

イベント

FileOk

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

(継承元 FileDialog)

適用対象

こちらもご覧ください