SaveFileDialog Classe

Définition

Représente une boîte de dialogue courante qui permet à l'utilisateur de spécifier un nom sous lequel enregistrer un fichier.Represents a common dialog that allows the user to specify a filename to save a file as. SaveFileDialog ne peut pas être utilisée par une application qui s'exécute en confiance partielle.SaveFileDialog cannot be used by an application that is executing under partial trust.

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class SaveFileDialog : Microsoft.Win32.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
Héritage
SaveFileDialog

Exemples

L’exemple suivant montre comment créer un SaveFileDialog et traiter le résultat.The following example demonstrates how to create a SaveFileDialog and process the result.

// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show save file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process save file dialog box results
if (result == true)
{
    // Save document
    string filename = dlg.FileName;
}
' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dlg.FileName
End If

Remarques

L’illustration suivante montre un SaveFileDialog pour Windows VistaWindows Vista.The following figure shows a SaveFileDialog for Windows VistaWindows Vista.

![Enregistrer sous, boîte de dialogue] (~/add/media/dialogboxesoverviewfigure3.png "Enregistrer sous, boîte de dialogue")Save As dialog box

À compter Windows VistaWindows Vistade, les boîtes de dialogue Ouvrir et enregistrer un fichier comportent un panneau liens favoris sur le côté gauche de la boîte de dialogue qui permet à l’utilisateur d’accéder rapidement à un autre emplacement.Starting in Windows VistaWindows Vista, open and save file dialog boxes have a Favorite Links panel on the left side of the dialog box that allows the user to quickly navigate to a different location. Ces liens sont appelés emplacements personnalisés.These links are called custom places. Utilisez la CustomPlaces propriété pour définir cette liste de liens.Use the CustomPlaces property to set this list of links.

Utilisation de texte XAMLXAML Text Usage

Vous ne pouvez pas déclarer cette classe XAMLXAMLmanagée dans.You cannot declare this managed class in XAMLXAML.

Constructeurs

SaveFileDialog()

Initialise une nouvelle instance de la classe SaveFileDialog.Initializes a new instance of the SaveFileDialog class.

Propriétés

AddExtension

Obtient ou définit une valeur indiquant si une boîte de dialogue de fichier ajoute automatiquement une extension à un nom de fichier si l'utilisateur l'omet.Gets or sets a value indicating whether a file dialog automatically adds an extension to a file name if the user omits an extension.

(Hérité de FileDialog)
CheckFileExists

Obtient ou définit une valeur indiquant si une boîte de dialogue de fichier affiche un avertissement quand l'utilisateur spécifie un nom de fichier qui n'existe pas.Gets or sets a value indicating whether a file dialog displays a warning if the user specifies a file name that does not exist.

(Hérité de FileDialog)
CheckPathExists

Obtient ou définit une valeur qui spécifie si des avertissements s’affichent quand l’utilisateur tape des chemins d’accès et des noms de fichiers non valides.Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names.

(Hérité de FileDialog)
CreatePrompt

Obtient ou définit une valeur indiquant si la SaveFileDialog demande à l'utilisateur l'autorisation de créer un fichier lorsque l'utilisateur spécifie un nom de fichier qui n'existe pas.Gets or sets a value indicating whether SaveFileDialog prompts the user for permission to create a file if the user specifies a file that does not exist.

CustomPlaces

Obtient ou définit la liste des emplacements personnalisés pour les boîtes de dialogue de fichier.Gets or sets the list of custom places for file dialog boxes.

(Hérité de FileDialog)
DefaultExt

Obtient ou définit une valeur qui spécifie la chaîne d’extension par défaut à utiliser pour filtrer la liste des fichiers affichés.Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed.

(Hérité de FileDialog)
DereferenceLinks

Obtient ou définit une valeur indiquant si une boîte de dialogue de fichier retourne l'emplacement du fichier référencé par un raccourci ou l'emplacement du fichier de raccourci (.lnk).Gets or sets a value indicating whether a file dialog returns either the location of the file referenced by a shortcut or the location of the shortcut file (.lnk).

(Hérité de FileDialog)
FileName

Obtient ou définit une chaîne comportant le chemin d'accès complet du fichier sélectionné dans une boîte de dialogue de fichier.Gets or sets a string containing the full path of the file selected in a file dialog.

(Hérité de FileDialog)
FileNames

Obtient un tableau qui contient un nom de fichier pour chaque fichier sélectionné.Gets an array that contains one file name for each selected file.

(Hérité de FileDialog)
Filter

Obtient ou définit la chaîne de filtrage qui détermine les types de fichiers affichés dans OpenFileDialog ou SaveFileDialog.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog.

(Hérité de FileDialog)
FilterIndex

Obtient ou définit l'index du filtre actuellement sélectionné dans une boîte de dialogue de fichier.Gets or sets the index of the filter currently selected in a file dialog.

(Hérité de FileDialog)
InitialDirectory

Obtient ou définit le répertoire initial affiché par une boîte de dialogue de fichier.Gets or sets the initial directory that is displayed by a file dialog.

(Hérité de FileDialog)
Options

Obtient les indicateurs communs aux boîtes de dialogue de fichier Win32Win32 utilisés par les boîtes de dialogue de fichier pour l'initialisation.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

(Hérité de FileDialog)
OverwritePrompt

Obtient ou définit une valeur indiquant si la SaveFileDialog affiche un avertissement lorsque l'utilisateur spécifie le nom d'un fichier qui existe déjà.Gets or sets a value indicating whether SaveFileDialog displays a warning if the user specifies the name of a file that already exists.

RestoreDirectory

Cette propriété n'est pas implémentée.This property is not implemented.

(Hérité de FileDialog)
SafeFileName

Obtient une chaîne qui ne contient que le nom du fichier sélectionné.Gets a string that only contains the file name for the selected file.

(Hérité de FileDialog)
SafeFileNames

Obtient un tableau qui contient un nom de fichier sécurisé pour chaque fichier sélectionné.Gets an array that contains one safe file name for each selected file.

(Hérité de FileDialog)
Tag

Obtient ou définit un objet associé à la boîte de dialogue.Gets or sets an object associated with the dialog. Cela permet de joindre un objet arbitraire à la boîte de dialogue.This provides the ability to attach an arbitrary object to the dialog.

(Hérité de CommonDialog)
Title

Obtient ou définit le texte qui s'affiche dans la barre de titre d'une boîte de dialogue de fichier.Gets or sets the text that appears in the title bar of a file dialog.

(Hérité de FileDialog)
ValidateNames

Obtient ou définit une valeur indiquant si la boîte de dialogue n’accepte que les noms de fichiers Win32Win32 valides.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

(Hérité de FileDialog)

Méthodes

CheckPermissionsToShowDialog()

Détermine si les autorisations sont suffisantes pour afficher une boîte de dialogue.Determines whether sufficient permissions for displaying a dialog exist.

(Hérité de CommonDialog)
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Définit la procédure de raccordement commune aux boîtes de dialogue de fichier qui est substituée pour ajouter des fonctionnalités communes à une boîte de dialogue de fichier.Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog.

(Hérité de FileDialog)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnFileOk(CancelEventArgs)

Déclenche l'événement FileOk.Raises the FileOk event.

(Hérité de FileDialog)
OpenFile()

Crée un flux de fichier en lecture-écriture pour le nom de fichier sélectionné par l'utilisateur à l'aide de SaveFileDialog.Creates a read-write file stream for the filename selected by the user using SaveFileDialog.

Reset()

Rétablit les valeurs par défaut de toutes les propriétés SaveFileDialog.Resets all SaveFileDialog properties to their default values.

RunDialog(IntPtr)

RunDialog(IntPtr) est appelé pour afficher une boîte de dialogue de fichier dans une classe dérivée (OpenFileDialog et SaveFileDialog, par exemple).RunDialog(IntPtr) is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog.

(Hérité de FileDialog)
ShowDialog()

Ouvre une boîte de dialogue commune.Displays a common dialog.

(Hérité de CommonDialog)
ShowDialog(Window)

Ouvre une boîte de dialogue commune.Displays a common dialog.

(Hérité de CommonDialog)
ToString()

Retourne une chaîne qui représente une boîte de dialogue de fichier.Returns a string that represents a file dialog.

(Hérité de FileDialog)

Événements

FileOk

Se produit quand l’utilisateur sélectionne un nom de fichier en cliquant soit sur le bouton Ouvrir de OpenFileDialog, soit sur le bouton Enregistrer de SaveFileDialog.Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog.

(Hérité de FileDialog)

S’applique à

Voir aussi