OpenFileDialog Classe

Définition

Espace de noms:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Représente une boîte de dialogue commune qui permet à un utilisateur de spécifier un nom de fichier pour un ou plusieurs fichiers à ouvrir.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class OpenFileDialog : Microsoft.Win32.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Héritage

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

Exemples

L’exemple suivant montre comment créer un qui contient un nom de fichier par défaut et un type d’extension OpenFileDialog .

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

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

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}

' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

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

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

Remarques

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

Constructeurs

OpenFileDialog()

Initialise une nouvelle instance de la classe OpenFileDialog.

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)
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 de 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)
ForcePreviewPane	Obtient ou définit un indicateur d’option indiquant si la boîte de dialogue force le volet d’aperçu.
InitialDirectory	Obtient ou définit le répertoire initial affiché par une boîte de dialogue de fichier. (Hérité de FileDialog)
Multiselect	Obtient ou définit une option indiquant si la OpenFileDialog permet aux utilisateurs de sélectionner plusieurs fichiers.
Options	Obtient les indicateurs de boîte de dialogue de fichiers communs Win32 qui sont utilisés par les boîtes de dialogue de fichier pour l’initialisation. (Hérité de FileDialog)
ReadOnlyChecked	Obtient ou définit une valeur indiquant si la case à cocher en lecture seule affichée par la OpenFileDialog est activée.
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 utilisateur. (Hérité de CommonItemDialog)
ShowReadOnly	Obtient ou définit une valeur indiquant si la OpenFileDialog comporte une case à cocher en lecture seule.
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()	Ouvre un flux en lecture seule pour le fichier sélectionné par l'utilisateur à l'aide de la OpenFileDialog.
OpenFiles()	Crée un tableau qui contient un flux en lecture seule pour chaque fichier sélectionné par l'utilisateur à l'aide de OpenFileDialog.
Reset()	Rétablit les valeurs par défaut de toutes les propriétés OpenFileDialog.
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

• SaveFileDialog