SaveFileDialog Classe

  • Référence

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
FileDialog
SaveFileDialog
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)

S’applique à

Voir aussi