SaveFileDialog クラス

ユーザーがファイルの保存に関するオプションを指定するコモン ダイアログ ボックスを表します。このクラスは継承できません。

この型のすべてのメンバの一覧については、SaveFileDialog メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.CommonDialog
            System.Windows.Forms.FileDialog
               System.Windows.Forms.SaveFileDialog

NotInheritable Public Class SaveFileDialog
   Inherits FileDialog
[C#]
public sealed class SaveFileDialog : FileDialog
[C++]
public __gc __sealed class SaveFileDialog : public FileDialog
[JScript]
public class SaveFileDialog extends FileDialog

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

このクラスは、既存のファイルを開いたり、上書きしたり、または新しいファイルを作成したりできるようにします。

このクラスのほとんどの機能は FileDialog クラスにあります。

.NET Compact Framework - Windows CE .NET プラットフォームに関する注意点: Pocket PC では、ファイル名の拡張子の指定を省略すると、ダイアログ ボックスで選択した種類の拡張子が自動的に追加されます。Windows CE .NET の場合、拡張子は追加されません。

選択した拡張子フィルタのインデックスを返す FilterIndex プロパティは、すべてのプラットフォームでサポートされています。

使用例

[Visual Basic, C#, C++] SaveFileDialog を作成し、そのメンバを設定し、 ShowDialog メソッドを使用してこのダイアログ ボックスを呼び出し、選択したファイルを開く方法を次の例に示します。この例は、フォーム上に 1 つのボタンが配置されていることを前提にしています。

 
Protected 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 Not (myStream Is Nothing) Then
            ' Code to write the stream goes here.
            myStream.Close()
        End If
    End If
End Sub


[C#] 
protected 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();
         }
     }
 }


[C++] 
protected:
void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/)
 {
     Stream* myStream ;
     SaveFileDialog* saveFileDialog1 = new SaveFileDialog();
 
     saveFileDialog1->Filter = S"txt files (*.txt)|*.txt|All files (*.*)|*.*"  ;
     saveFileDialog1->FilterIndex = 2 ;
     saveFileDialog1->RestoreDirectory = true ;
 
     if(saveFileDialog1->ShowDialog() == DialogResult::OK)
     {
         if((myStream = saveFileDialog1->OpenFile()) != 0)
         {
             // Code to write the stream goes here.
             myStream->Close();
         }
     }
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

SaveFileDialog メンバ | System.Windows.Forms 名前空間 | FileDialog | CommonDialog