如何：使用 SaveFileDialog 组件保存文件

项目
05/04/2023

SaveFileDialog 组件让用户可以浏览文件系统并选择要保存的文件。对话框返回用户在对话框中所选的文件路径和名称。但是必须编写代码才能真正地将文件写入磁盘。

使用 SaveFileDialog 组件保存文件

显示“保存文件”对话框，并调用来方法保存用户选择的文件。

使用 SaveFileDialog 组件的 OpenFile 方法保存文件。此方法提供一个可以写入的 Stream 对象。

下面的示例使用 DialogResult 属性获取文件的名称，并使用 OpenFile 方法保存文件。 OpenFile 方法提供可以将文件写入的流。

在下面的示例中，有一个分配了图像的 Button 控件。单击该按钮时，将使用允许 .gif、.jpeg 和 .bmp 类型文件的筛选器实例化 SaveFileDialog 组件。如果在“保存文件”对话框中选择了此类型的文件，那么按钮的图像将会保存。

重要

若要获取或设置 FileName 属性，程序集需要 System.Security.Permissions.FileIOPermission 类授予的权限级别。如果在部分信任上下文中运行，该进程可能会因特权不足而引发异常。有关详细信息，请参阅 Code Access Security Basics。

该示例假设窗体具有一个 Button 控件，其 Image 属性设置为 .gif、.jpeg 或 .bmp 类型的文件。

注意

FileDialog 类的 FilterIndex 属性（按照继承是 SaveFileDialog 类的一部分）使用从 1 开始的索引。如果要通过编写代码以特定格式保存数据（例如，以纯文本或二进制格式保存文件），那么这一点很重要。以下示例介绍了该属性。

Private Sub Button2_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button2.Click
    ' Displays a SaveFileDialog so the user can save the Image
    ' assigned to Button2.
    Dim saveFileDialog1 As New SaveFileDialog()
    saveFileDialog1.Filter = "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif"
    saveFileDialog1.Title = "Save an Image File"
    saveFileDialog1.ShowDialog()

    ' If the file name is not an empty string open it for saving.
    If saveFileDialog1.FileName <> "" Then
      ' Saves the Image via a FileStream created by the OpenFile method.
      Dim fs As System.IO.FileStream = Ctype _
          (saveFileDialog1.OpenFile(), System.IO.FileStream)
      ' Saves the Image in the appropriate ImageFormat based upon the
      ' file type selected in the dialog box.
      ' NOTE that the FilterIndex property is one-based.
      Select Case saveFileDialog1.FilterIndex
          Case 1
            Me.button2.Image.Save(fs, _
                System.Drawing.Imaging.ImageFormat.Jpeg)

          Case 2
            Me.button2.Image.Save(fs, _
                System.Drawing.Imaging.ImageFormat.Bmp)

          Case 3
            Me.button2.Image.Save(fs, _
                System.Drawing.Imaging.ImageFormat.Gif)
        End Select

        fs.Close()
    End If
End Sub

private void button2_Click(object sender, System.EventArgs e)
{
    // Displays a SaveFileDialog so the user can save the Image
    // assigned to Button2.
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.Filter = "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif";
    saveFileDialog1.Title = "Save an Image File";
    saveFileDialog1.ShowDialog();

    // If the file name is not an empty string open it for saving.
    if(saveFileDialog1.FileName != "")
    {
      // Saves the Image via a FileStream created by the OpenFile method.
      System.IO.FileStream fs =
          (System.IO.FileStream)saveFileDialog1.OpenFile();
      // Saves the Image in the appropriate ImageFormat based upon the
      // File type selected in the dialog box.
      // NOTE that the FilterIndex property is one-based.
      switch(saveFileDialog1.FilterIndex)
      {
          case 1 :
          this.button2.Image.Save(fs,
            System.Drawing.Imaging.ImageFormat.Jpeg);
          break;

          case 2 :
          this.button2.Image.Save(fs,
            System.Drawing.Imaging.ImageFormat.Bmp);
          break;

          case 3 :
          this.button2.Image.Save(fs,
            System.Drawing.Imaging.ImageFormat.Gif);
          break;
      }

    fs.Close();
    }
}

private:
    System::Void button2_Click(System::Object ^ sender,
      System::EventArgs ^ e)
    {
      // Displays a SaveFileDialog so the user can save the Image
      // assigned to Button2.
      SaveFileDialog ^ saveFileDialog1 = new SaveFileDialog();
      saveFileDialog1->Filter =
          "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif";
      saveFileDialog1->Title = "Save an Image File";
      saveFileDialog1->ShowDialog();
      // If the file name is not an empty string, open it for saving.
      if(saveFileDialog1->FileName != "")
      {
          // Saves the Image through a FileStream created by
          // the OpenFile method.
          System::IO::FileStream ^ fs =
            safe_cast\<System::IO::FileStream*>(
            saveFileDialog1->OpenFile());
          // Saves the Image in the appropriate ImageFormat based on
          // the file type selected in the dialog box.
          // Note that the FilterIndex property is one based.
          switch(saveFileDialog1->FilterIndex)
          {
            case 1 :
                this->button2->Image->Save(fs,
                  System::Drawing::Imaging::ImageFormat::Jpeg);
                break;
            case 2 :
                this->button2->Image->Save(fs,
                  System::Drawing::Imaging::ImageFormat::Bmp);
                break;
            case 3 :
                this->button2->Image->Save(fs,
                  System::Drawing::Imaging::ImageFormat::Gif);
                break;
          }
      fs->Close();
      }
    }

（Visual C# 和 Visual C++）将以下代码放在窗体的构造函数中以注册事件处理程序。

this.button2.Click += new System.EventHandler(this.button2_Click);

this->button2->Click += gcnew
    System::EventHandler(this, &Form1::button2_Click);

有关写入文件流的详细信息，请参阅 BeginWrite 和 Write。

注意

某些控件（如 RichTextBox 控件）具有保存文件的功能。

如何：使用 SaveFileDialog 组件保存文件

使用 SaveFileDialog 组件保存文件

另请参阅

反馈

其他资源