Partager via

Guide pratique pour enregistrer des fichiers à l'aide du composant SaveFileDialog

  • Article

Le SaveFileDialog composant permet aux utilisateurs de parcourir le système de fichiers et de sélectionner des fichiers à enregistrer. La boîte de dialogue retourne le chemin et le nom du fichier que l’utilisateur a sélectionné dans la boîte de dialogue. Cependant, vous devez écrire le code pour écrire réellement les fichiers sur le disque.

Pour enregistrer un fichier à l’aide du composant SaveFileDialog

  • Affichez la boîte de dialogue Enregistrer le fichier et appelez une méthode pour enregistrer le fichier sélectionné par l’utilisateur.

    Utilisez la SaveFileDialog méthode du OpenFile composant pour enregistrer le fichier. Cette méthode vous donne un Stream objet dans lequel vous pouvez écrire.

    L’exemple ci-dessous utilise la DialogResult propriété pour obtenir le nom du fichier et la OpenFile méthode pour enregistrer le fichier. La OpenFile méthode vous donne un flux dans lequel écrire le fichier.

    Dans l’exemple ci-dessous, il existe un Button contrôle avec une image qui lui est affectée. Lorsque vous cliquez sur le bouton, un SaveFileDialog composant est instancié avec un filtre qui autorise les fichiers de type .gif, .jpeg et .bmp. Si un fichier de ce type est sélectionné dans la boîte de dialogue Enregistrer le fichier, l’image du bouton est enregistrée.

    Important

    Pour obtenir ou définir la FileName propriété, votre assembly nécessite un niveau de privilège accordé par la System.Security.Permissions.FileIOPermission classe. Si vous l’exécutez dans un contexte de confiance partielle, le processus peut lever une exception en raison de privilèges insuffisants. Pour plus d’informations, consultez Notions fondamentales de la sécurité d’accès du code.

    L’exemple suppose que votre formulaire a un Button contrôle avec sa Image propriété définie sur un fichier de type .gif, .jpeg ou .bmp.

    Remarque

    La FileDialog propriété de FilterIndex la classe (qui, en raison de l’héritage, fait partie de la SaveFileDialog classe) utilise un index à base unique. Ceci est important si vous écrivez du code pour enregistrer les données dans un format spécifique (par exemple pour enregistrer un fichier au format texte brut ou au format binaire). Cette propriété est présentée dans l’exemple ci-dessous.

    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# et Visual C++) Placez le code suivant dans le constructeur du formulaire pour inscrire le gestionnaire d’événements.

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

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

    Pour plus d’informations sur l’écriture de flux de fichiers, consultez BeginWrite et Write.

    Remarque

    Certains contrôles, tels que le RichTextBox contrôle, ont la possibilité d’enregistrer des fichiers.

Voir aussi