SaveFileDialog クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーにファイルの保存場所を選択するよう要求します。 このクラスは継承できません。
public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class SaveFileDialog : System.Windows.Forms.FileDialogtype SaveFileDialog = class
inherit FileDialogPublic NotInheritable Class SaveFileDialog
Inherits FileDialog- 継承
例
次のコード例は、 の作成、メンバーの SaveFileDialog設定、メソッドを使用した ShowDialog ダイアログ ボックスの呼び出し、現在のファイルの保存を示しています。 この例では、ボタンが配置されたフォームが必要です。
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
Stream^ myStream;
SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
saveFileDialog1->FilterIndex = 2;
saveFileDialog1->RestoreDirectory = true;
if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
{
if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
{
// Code to write the stream goes here.
myStream->Close();
}
}
}
private void button1_Click(object sender, System.EventArgs e)
{
Stream myStream ;
SaveFileDialog saveFileDialog1 = new SaveFileDialog();
saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
saveFileDialog1.FilterIndex = 2 ;
saveFileDialog1.RestoreDirectory = true ;
if(saveFileDialog1.ShowDialog() == DialogResult.OK)
{
if((myStream = saveFileDialog1.OpenFile()) != null)
{
// Code to write the stream goes here.
myStream.Close();
}
}
}
Private Sub button1_Click(sender As Object, e As System.EventArgs)
Dim myStream As Stream
Dim saveFileDialog1 As New SaveFileDialog()
saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
saveFileDialog1.FilterIndex = 2
saveFileDialog1.RestoreDirectory = True
If saveFileDialog1.ShowDialog() = DialogResult.OK Then
myStream = saveFileDialog1.OpenFile()
If (myStream IsNot Nothing) Then
' Code to write the stream goes here.
myStream.Close()
End If
End If
End Sub
注釈
このクラスは、既存のファイルを開いて上書きするか、新しいファイルを作成できます。
このクラスのほとんどの機能は、 クラスにあります FileDialog 。
コンストラクター
| SaveFileDialog() |
このクラスの新しいインスタンスを初期化します。 |
プロパティ
| AddExtension |
ユーザーが拡張子を指定しない場合、ダイアログ ボックスがファイル名に自動的に拡張子を付けるかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| AddToRecent |
ダイアログ ボックスが開いているファイルを追加するか、最近のリストに保存するかを示す値を取得または設定します。 (継承元 FileDialog) |
| AutoUpgradeEnabled |
Windows Vista で実行するときに、この FileDialog インスタンスの外観と動作を自動的にアップグレードするかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| CanRaiseEvents |
コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component) |
| CheckFileExists |
存在しないファイルの名前をユーザーが指定した場合に、ダイアログ ボックスが警告を表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| CheckPathExists |
存在しないパスをユーザーが指定したときに、ダイアログ ボックスに警告を表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| CheckWriteAccess |
指定したファイルの作成が成功するかどうかをダイアログ ボックスで確認するかどうかを示す値を取得または設定します。 このフラグが設定されていない場合、呼び出し元のアプリケーションは、アイテムの作成時に検出されたアクセス拒否などのエラーを処理する必要があります。 |
| ClientGuid |
このダイアログの状態に関連付ける GUID を取得または設定します。 通常、最後にアクセスしたフォルダーやダイアログの位置やサイズなどの状態は、実行可能ファイルの名前に基づいて保持されます。 GUID を指定することにより、アプリケーションでは、異なるバージョンのダイアログ (たとえばインポート ダイアログや [開く] ダイアログなど) に対して、同じアプリケーション内で異なる状態を保持することができます。 アプリケーションで視覚スタイルを使用していない場合や、AutoUpgradeEnabled が |
| Container |
IContainer を含む Component を取得します。 (継承元 Component) |
| CreatePrompt |
ユーザーが存在しないファイルを指定した場合に、ファイルを作成することを確認するメッセージをダイアログ ボックスで表示するかどうかを示す値を取得または設定します。 |
| CustomPlaces |
この FileDialog インスタンスに対するカスタム プレイスのコレクションを取得します。 (継承元 FileDialog) |
| DefaultExt |
既定のファイル名の拡張子を取得または設定します。 (継承元 FileDialog) |
| DereferenceLinks |
ダイアログ ボックスが、ショートカットで参照されたファイルの場所を返すかどうか、またはショートカットの場所 (.lnk) を返すかどうかを指定する値を取得または設定します。 (継承元 FileDialog) |
| DesignMode |
Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component) |
| Events |
Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component) |
| ExpandedMode |
ダイアログ ボックスを展開モードで常に開くかどうかを示す値を取得または設定します。 |
| FileName |
ファイル ダイアログ ボックスで選択されたファイル名を含む文字列を取得または設定します。 (継承元 FileDialog) |
| FileNames |
ダイアログ ボックスで選択されたすべてのファイルの名前を取得します。 (継承元 FileDialog) |
| Filter |
ダイアログ ボックスの [保存先ファイルの種類] または [ファイルの種類] ボックスに表示される選択肢を決定する、現在のファイル名のフィルター文字列を取得または設定します。 (継承元 FileDialog) |
| FilterIndex |
ファイル ダイアログ ボックスで現在選択されているフィルターのインデックスを取得または設定します。 (継承元 FileDialog) |
| InitialDirectory |
ファイル ダイアログ ボックスに表示される起動ディレクトリを取得または設定します。 (継承元 FileDialog) |
| Instance |
アプリケーションの Win32 インスタンス ハンドルを取得します。 (継承元 FileDialog) |
| OkRequiresInteraction |
ユーザーがビューを移動するか、ファイル名を編集するまでダイアログ ボックスの [OK] ボタンを無効にするかどうかを示す値を取得または設定します (該当する場合)。 (継承元 FileDialog) |
| Options |
FileDialog を初期化するための値を取得します。 (継承元 FileDialog) |
| OverwritePrompt |
ユーザーが既に存在するファイル名を指定した場合に [ |
| RestoreDirectory |
ダイアログ ボックスを閉じる前に、ディレクトリを以前選択されていたディレクトリに復元するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| ShowHelp |
ファイル ダイアログ ボックスに [ヘルプ] ボタンを表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| ShowHiddenFiles |
ダイアログ ボックスに非表示ファイルとシステム ファイルを表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| ShowPinnedPlaces |
ビューのナビゲーション ウィンドウに既定で表示される項目を表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| Site |
Component の ISite を取得または設定します。 (継承元 Component) |
| SupportMultiDottedExtensions |
複数のファイル名拡張子を持つファイルの表示および保存をダイアログ ボックスがサポートするかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| Tag |
コントロールに関するデータを格納するオブジェクトを取得または設定します。 (継承元 CommonDialog) |
| Title |
ファイル ダイアログ ボックスのタイトルを取得または設定します。 (継承元 FileDialog) |
| ValidateNames |
ダイアログ ボックスが有効な Win32 ファイル名だけを受け入れるかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
メソッド
| CreateObjRef(Type) |
リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject) |
| Dispose() |
Component によって使用されているすべてのリソースを解放します。 (継承元 Component) |
| Dispose(Boolean) |
Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 Component) |
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetLifetimeService() |
古い.
対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| GetService(Type) |
Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
ファイル ダイアログ ボックスに特定の機能を追加するためにオーバーライドされる、コモン ダイアログ ボックスのフック プロシージャを定義します。 (継承元 FileDialog) |
| InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
| OnFileOk(CancelEventArgs) |
FileOk イベントを発生させます。 (継承元 FileDialog) |
| OnHelpRequest(EventArgs) |
HelpRequest イベントを発生させます。 (継承元 CommonDialog) |
| OpenFile() |
ユーザーが選択した、読み書きアクセス許可が設定されているファイルを開きます。 |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
コモン ダイアログ ボックスに特定の機能を追加するためにオーバーライドされる、オーナー ウィンドウ プロシージャを定義します。 (継承元 CommonDialog) |
| Reset() |
ダイアログ ボックスのオプションをすべて既定値にリセットします。 |
| RunDialog(IntPtr) |
コモン ダイアログ ボックスを指定します。 (継承元 FileDialog) |
| ShowDialog() |
既定のオーナーを使用してコモン ダイアログ ボックスを実行します。 (継承元 CommonDialog) |
| ShowDialog(IWin32Window) |
指定したオーナーを使用してコモン ダイアログ ボックスを実行します。 (継承元 CommonDialog) |
| ToString() |
このオブジェクトの文字列形式を示します。 (継承元 FileDialog) |
イベント
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| FileOk |
ファイル ダイアログ ボックスの [開く] ボタンまたは [保存] ボタンをユーザーがクリックすると発生します。 (継承元 FileDialog) |
| HelpRequest |
ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。 (継承元 CommonDialog) |
適用対象
こちらもご覧ください
.NET