OpenFileDialog OpenFileDialog OpenFileDialog OpenFileDialog Class

Définition

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.Represents a common dialog box that allows a user to specify a filename for one or more files to open.

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

Exemples

L’exemple suivant montre comment créer un OpenFileDialog qui contient un nom de fichier et un type d’extension par défaut.The following example shows how to create an OpenFileDialog that contains a default file name and extension type.

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

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

![Ouvrir la boîte de dialogue] (~/add/media/dialogboxesoverviewfigure2.png "Ouvrir la boîte de dialogue")Open 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

OpenFileDialog() OpenFileDialog() OpenFileDialog() OpenFileDialog()

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

Propriétés

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

(Inherited from FileDialog)
CheckFileExists CheckFileExists CheckFileExists 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.

(Inherited from FileDialog)
CheckPathExists CheckPathExists CheckPathExists 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.

(Inherited from FileDialog)
CustomPlaces CustomPlaces CustomPlaces 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.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt 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.

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks 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).

(Inherited from FileDialog)
FileName FileName FileName 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.

(Inherited from FileDialog)
FileNames FileNames FileNames 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.

(Inherited from FileDialog)
Filter Filter Filter 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.

(Inherited from FileDialog)
FilterIndex FilterIndex FilterIndex 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.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory 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.

(Inherited from FileDialog)
Multiselect Multiselect Multiselect Multiselect

Obtient ou définit une option indiquant si la OpenFileDialog permet aux utilisateurs de sélectionner plusieurs fichiers.Gets or sets an option indicating whether OpenFileDialog allows users to select multiple files.

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

(Inherited from FileDialog)
ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked

Obtient ou définit une valeur indiquant si la case à cocher en lecture seule affichée par la OpenFileDialog est activée.Gets or sets a value indicating whether the read-only check box displayed by OpenFileDialog is selected.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

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

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName 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.

(Inherited from FileDialog)
SafeFileNames SafeFileNames SafeFileNames 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.

(Inherited from FileDialog)
ShowReadOnly ShowReadOnly ShowReadOnly ShowReadOnly

Obtient ou définit une valeur indiquant si la OpenFileDialog comporte une case à cocher en lecture seule.Gets or sets a value indicating whether OpenFileDialog contains a read-only check box.

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

(Inherited from CommonDialog)
Title Title Title 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.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames 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.

(Inherited from FileDialog)

Méthodes

CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog()

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

(Inherited from CommonDialog)
Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) 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.

(Inherited from FileDialog)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

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

(Inherited from FileDialog)
OpenFile() OpenFile() OpenFile() OpenFile()

Ouvre un flux en lecture seule pour le fichier sélectionné par l'utilisateur à l'aide de la OpenFileDialog.Opens a read-only stream for the file that is selected by the user using OpenFileDialog.

OpenFiles() OpenFiles() OpenFiles() OpenFiles()

Crée un tableau qui contient un flux en lecture seule pour chaque fichier sélectionné par l'utilisateur à l'aide de OpenFileDialog.Creates an array that contains one read-only stream for each file selected by the user using OpenFileDialog.

Reset() Reset() Reset() Reset()

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

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) 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.

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() ShowDialog()

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

(Inherited from CommonDialog)
ShowDialog(Window) ShowDialog(Window) ShowDialog(Window) ShowDialog(Window)

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

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

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

(Inherited from FileDialog)

Événements

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

(Inherited from FileDialog)

S’applique à

Voir aussi