Postupy: Ukládání souborů pomocí součásti SaveFileDialog

Článek
10/18/2023

Komponenta SaveFileDialog umožňuje uživatelům procházet systém souborů a vybírat soubory, které se mají uložit. Dialogové okno vrátí cestu a název souboru, který uživatel vybral v dialogovém okně. Je však nutné napsat kód, který skutečně zapíše soubory na disk.

Uložení souboru pomocí komponenty SaveFileDialog

Zobrazí dialogové okno Uložit soubor a zavolá metodu pro uložení souboru vybraného uživatelem.

SaveFileDialog K uložení souboru použijte metodu komponentyOpenFile. Tato metoda poskytuje Stream objekt, do který můžete zapisovat.

Následující příklad používá DialogResult vlastnost k získání názvu souboru a metodu OpenFile pro uložení souboru. Metoda OpenFile poskytuje datový proud pro zápis souboru do.

V následujícím příkladu je Button ovládací prvek s přiřazeným obrázkem. Když kliknete na tlačítko, SaveFileDialog vytvoří se instance komponenty s filtrem, který umožňuje soubory typu .gif, .jpeg a .bmp. Pokud je v dialogovém okně Uložit soubor vybraný soubor tohoto typu, uloží se obrázek tlačítka.

Důležité

K získání nebo nastavení FileName vlastnosti vyžaduje sestavení úroveň oprávnění udělenou System.Security.Permissions.FileIOPermission třídou. Pokud běžíte v kontextu částečné důvěryhodnosti, může proces vyvolat výjimku kvůli nedostatečným oprávněním. Další informace naleznete v tématu Základy zabezpečení přístupu kódu.

Příklad předpokládá, že formulář má Button ovládací prvek s jeho Image vlastností nastavenou na soubor typu .gif, .jpeg nebo .bmp.

Poznámka:

Vlastnost FileDialog třídy FilterIndex (která je kvůli dědičnosti součástí SaveFileDialog třídy) používá index založený na jednom. To je důležité, pokud píšete kód pro ukládání dat v určitém formátu (například uložení souboru ve formátu prostého textu a binárního formátu). Tato vlastnost je doporučená v následujícím příkladu.

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# a Visual C++) Do konstruktoru formuláře umístěte následující kód pro registraci obslužné rutiny události.

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

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

Další informace o zápisu datových proudů souborů naleznete BeginWrite a Write.

Poznámka:

Některé ovládací prvky, například RichTextBox ovládací prvek, mají možnost ukládat soubory.

Sdílet prostřednictvím

Postupy: Ukládání souborů pomocí součásti SaveFileDialog

Uložení souboru pomocí komponenty SaveFileDialog

Viz také

Další materiály