Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

OpenFileDialog classe

 

Date de publication : novembre 2016

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.

Espace de noms:   Microsoft.Win32
Assembly:  PresentationFramework (dans PresentationFramework.dll)

System.Object
  Microsoft.Win32.CommonDialog
    Microsoft.Win32.FileDialog
      Microsoft.Win32.OpenFileDialog

public sealed class OpenFileDialog : FileDialog

NomDescription
System_CAPS_pubmethodOpenFileDialog()

Initialise une nouvelle instance de la classe OpenFileDialog.

NomDescription
System_CAPS_pubpropertyAddExtension

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.)

System_CAPS_pubpropertyCheckFileExists

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.)

System_CAPS_pubpropertyCheckPathExists

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.)

System_CAPS_pubpropertyCustomPlaces

Obtient ou définit la liste des emplacements personnalisés pour les boîtes de dialogue de fichier.(Hérité de FileDialog.)

System_CAPS_pubpropertyDefaultExt

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.)

System_CAPS_pubpropertyDereferenceLinks

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.)

System_CAPS_pubpropertyFileName

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.)

System_CAPS_pubpropertyFileNames

Obtient un tableau qui contient un nom de fichier pour chaque fichier sélectionné.(Hérité de FileDialog.)

System_CAPS_pubpropertyFilter

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.)

System_CAPS_pubpropertyFilterIndex

Obtient ou définit l'index du filtre actuellement sélectionné dans une boîte de dialogue de fichier.(Hérité de FileDialog.)

System_CAPS_pubpropertyInitialDirectory

Obtient ou définit le répertoire initial affiché par une boîte de dialogue de fichier.(Hérité de FileDialog.)

System_CAPS_pubpropertyMultiselect

Obtient ou définit une option indiquant si OpenFileDialog permet aux utilisateurs de sélectionner plusieurs fichiers.

System_CAPS_pubpropertyReadOnlyChecked

Obtient ou définit une valeur indiquant si la case à cocher en lecture seule affichée par OpenFileDialog est sélectionnée.

System_CAPS_pubpropertyRestoreDirectory

Cette propriété n'est pas implémentée.(Hérité de FileDialog.)

System_CAPS_pubpropertySafeFileName

Obtient une chaîne qui ne contient que le nom du fichier sélectionné.(Hérité de FileDialog.)

System_CAPS_pubpropertySafeFileNames

Obtient un tableau qui contient un nom de fichier sécurisé pour chaque fichier sélectionné.(Hérité de FileDialog.)

System_CAPS_pubpropertyShowReadOnly

Obtient ou définit une valeur qui indique si OpenFileDialog contient une case à cocher en lecture seule.

System_CAPS_pubpropertyTag

Obtient ou définit un objet associé à la boîte de dialogue. Cela offre la possibilité de joindre un objet arbitraire à la boîte de dialogue.(Hérité de CommonDialog.)

System_CAPS_pubpropertyTitle

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.)

System_CAPS_pubpropertyValidateNames

Obtient ou définit une valeur indiquant si la boîte de dialogue n'accepte que les noms de fichiers Win32 valides.(Hérité de FileDialog.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodOpenFile()

Ouvre un flux en lecture seule pour le fichier sélectionné par l’utilisateur à l’aide de OpenFileDialog.

System_CAPS_pubmethodOpenFiles()

Crée un tableau qui contient un flux en lecture seule pour chaque fichier sélectionné par l’utilisateur à l’aide de OpenFileDialog.

System_CAPS_pubmethodReset()

Réinitialise tous les OpenFileDialog propriétés à leurs valeurs par défaut.(Remplace FileDialog.Reset().)

System_CAPS_pubmethodShowDialog()

Affiche une boîte de dialogue commune.(Hérité de CommonDialog.)

System_CAPS_pubmethodShowDialog(Window)

Affiche une boîte de dialogue commune.(Hérité de CommonDialog.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente une boîte de dialogue de fichier.(Hérité de FileDialog.)

NomDescription
System_CAPS_pubeventFileOk

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.)

L’illustration suivante montre un OpenFileDialog pour Windows Vista.

Boîte de dialogue Ouvrir

À compter de Windows Vista, ouvrir et enregistrer les boîtes de dialogue de fichier ont un liens favoris Panneau de configuration sur le côté gauche de la boîte de dialogue qui permet à l’utilisateur de naviguer rapidement vers un autre emplacement. Ces liens sont appelés emplacements personnalisés. Utilisez le CustomPlaces propriété à définir cette liste de liens.

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

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

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

.NET Framework
Disponible depuis 3.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: