Compartilhar via

Como salvar arquivos usando o componente SaveFileDialog

  • Artigo

O componente SaveFileDialog permite que os usuários naveguem pelo sistema de arquivos e selecionem arquivos a serem salvos. A caixa de diálogo retorna o caminho e o nome do arquivo que o usuário selecionou na caixa de diálogo. No entanto, você deve escrever o código para realmente gravar os arquivos no disco.

Para salvar um arquivo usando o componente SaveFileDialog

  • Exiba a caixa de diálogo Salvar Arquivo e chame um método para salvar o arquivo selecionado pelo usuário.

    Use o método OpenFile do componente SaveFileDialog para salvar o arquivo. Esse método fornece um objeto Stream para o qual você pode escrever.

    O exemplo a seguir usa a propriedade DialogResult para obter o nome do arquivo e o método OpenFile para salvar o arquivo. O método OpenFile fornece um fluxo para o qual gravar o arquivo.

    No exemplo abaixo, há um controle Button com uma imagem atribuída a ele. Quando você clica no botão, um componente SaveFileDialog é instanciado com um filtro que permite arquivos do tipo .gif, .jpeg e .bmp. Se um arquivo desse tipo estiver selecionado na caixa de diálogo Salvar Arquivo, a imagem do botão será salva.

    Importante

    Para obter ou definir a propriedade FileName, o conjunto requer um nível de privilégio concedido pela classe System.Security.Permissions.FileIOPermission. Se você estiver executando em um contexto de confiança parcial, o processo poderá gerar uma exceção devido a privilégios insuficientes. Para obter mais informações, consulte Noções Básicas de Segurança de Acesso ao Código.

    O exemplo pressupõe que seu formulário tenha um controle Button com sua propriedade Image definida como um arquivo do tipo .gif, .jpeg ou .bmp.

    Nota

    A propriedade FilterIndex da classe FileDialog (que, devido à herança, faz parte da classe SaveFileDialog) usa um índice baseado em um. Isso é importante se você estiver escrevendo código para salvar dados em um formato específico (por exemplo, salvando um arquivo em texto sem formatação versus formato binário). Essa propriedade é apresentada no exemplo abaixo.

    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# e Visual C++) Coloque o código a seguir no construtor do formulário para registrar o manipulador de eventos.

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

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

    Para obter mais informações sobre como escrever fluxos de arquivos, consulte BeginWrite e Write.

    Nota

    Determinados controles, como o controle RichTextBox, têm a capacidade de salvar arquivos.

Consulte também