SaveFileDialog Classe

Définition

Espace de noms:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Représente une boîte de dialogue courante qui permet à l'utilisateur de spécifier un nom sous lequel enregistrer un fichier. SaveFileDialog ne peut pas être utilisée par une application qui s'exécute en confiance partielle.

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

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

Exemples

L’exemple suivant montre comment créer un SaveFileDialog et traiter le résultat.

// 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

Vous ne pouvez pas déclarer cette classe managée en XAML.

Constructeurs

SaveFileDialog()

Initialise une nouvelle instance de la classe SaveFileDialog.

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. (Hérité de FileDialog)
AddToRecent	Obtient ou définit une valeur indiquant si la boîte de dialogue ajoute l’élément en cours d’ouverture ou d’enregistrement à la liste des documents récents. (Hérité de CommonItemDialog)
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. (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. (Hérité de FileDialog)
ClientGuid	Obtient ou définit un GUID à associer à l’état persistant de la boîte de dialogue. (Hérité de CommonItemDialog)
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.
CreateTestFile	Obtient ou définit une valeur indiquant si la boîte de dialogue tente de créer un fichier de test au niveau du chemin d’accès sélectionné.
CustomPlaces	Obtient ou définit la liste des emplacements personnalisés pour les boîtes de dialogue de fichier. (Hérité de FileDialog)
DefaultDirectory	Obtient ou définit le répertoire affiché par la boîte de dialogue fichier si aucune valeur de répertoire récemment utilisée n’est disponible. (Hérité de CommonItemDialog)
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. (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). (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. (Hérité de FileDialog)
FileNames	Obtient un tableau qui contient un nom de fichier pour chaque fichier sélectionné. (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. (Hérité de FileDialog)
FilterIndex	Obtient ou définit l'index du filtre actuellement sélectionné dans une boîte de dialogue de fichier. (Hérité de FileDialog)
InitialDirectory	Obtient ou définit le répertoire initial affiché par une boîte de dialogue de fichier. (Hérité de FileDialog)
Options	Obtient les indicateurs de boîte de dialogue de fichiers communs Win32 utilisés par les boîtes de dialogue de fichiers pour l’initialisation. (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à.
RestoreDirectory	Cette propriété n'est pas implémentée. (Hérité de FileDialog)
RootDirectory	Obtient ou définit le répertoire affiché comme racine de navigation pour la boîte de dialogue. (Hérité de CommonItemDialog)
SafeFileName	Obtient une chaîne qui ne contient que le nom du fichier sélectionné. (Hérité de FileDialog)
SafeFileNames	Obtient un tableau qui contient un nom de fichier sécurisé pour chaque fichier sélectionné. (Hérité de FileDialog)
ShowHiddenItems	Obtient ou définit une valeur indiquant si la boîte de dialogue affiche les éléments masqués et système, quelles que soient les préférences de l’utilisateur. (Hérité de CommonItemDialog)
Tag	Obtient ou définit un objet associé à la boîte de dialogue. Cela permet de joindre un objet arbitraire à la boîte de dialogue. (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. (Hérité de FileDialog)
ValidateNames	Obtient ou définit une valeur indiquant si la boîte de dialogue accepte uniquement les noms de fichiers Win32 valides. (Hérité de FileDialog)

Méthodes

CheckPermissionsToShowDialog()	Détermine si les autorisations sont suffisantes pour afficher une boîte de dialogue. (Hérité de CommonDialog)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (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. (Hérité de FileDialog)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnFileOk(CancelEventArgs)	Déclenche l’événement FileOk. (Hérité de FileDialog)
OnItemOk(CancelEventArgs)	Déclenche l’événement FileOk. (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.
Reset()	Rétablit les valeurs par défaut de toutes les propriétés SaveFileDialog.
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). (Hérité de FileDialog)
ShowDialog()	Ouvre une boîte de dialogue commune. (Hérité de CommonDialog)
ShowDialog(Window)	Ouvre une boîte de dialogue commune. (Hérité de CommonDialog)
ToString()	Retourne une chaîne qui représente une boîte de dialogue de fichier. (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. (Hérité de FileDialog)

Voir aussi

• OpenFileDialog