OpenFileDialog OpenFileDialog OpenFileDialog OpenFileDialog Class

Definición

Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para abrir uno o varios archivos.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
Herencia

Ejemplos

El ejemplo siguiente muestra cómo crear un OpenFileDialog que contiene un tipo de nombre y la extensión de archivo predeterminada.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

Comentarios

La siguiente ilustración muestra un OpenFileDialog para Windows VistaWindows Vista.The following figure shows an OpenFileDialog for Windows VistaWindows Vista.

Cuadro de diálogo AbrirOpen dialog box

A partir de Windows VistaWindows Vista, abrir y guardar los cuadros de diálogo de archivo tiene un vínculos favoritos panel en el lado izquierdo del cuadro de diálogo que permite al usuario navegar rápidamente a una ubicación diferente.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. Estos vínculos se denominan ubicaciones personalizadas.These links are called custom places. Use el CustomPlaces propiedad para establecer esta lista de vínculos.Use the CustomPlaces property to set this list of links.

Uso de texto XAMLXAML Text Usage

No se puede declarar esta clase administrada en XAMLXAML.You cannot declare this managed class in XAMLXAML.

Constructores

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

Inicializa una nueva instancia de la clase OpenFileDialog.Initializes a new instance of the OpenFileDialog class.

Propiedades

AddExtension AddExtension AddExtension AddExtension

Obtiene o establece un valor que indica si el cuadro de diálogo de archivo agrega automáticamente una extensión a un nombre de archivo en caso de que el usuario la omita.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

Obtiene o establece un valor que indica si el cuadro de diálogo de archivo muestra una advertencia cuando el usuario especifica un nombre de archivo que no existe.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

Obtiene o establece un valor que especifica si se muestran advertencias en caso de que el usuario escriba rutas de acceso y nombres de archivo no válidos.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

Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos.Gets or sets the list of custom places for file dialog boxes.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt DefaultExt

Obtiene o establece un valor que especifica la cadena de la extensión predeterminada que se va a usar para filtrar la lista de archivos que se muestran.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

Obtiene o establece un valor que indica si un cuadro de diálogo de archivo devuelve la ubicación del archivo al que hace referencia un acceso directo o la ubicación del archivo de acceso directo (.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

Obtiene o establece una cadena que contiene la ruta de acceso completa del archivo seleccionado en un cuadro de diálogo de archivo.Gets or sets a string containing the full path of the file selected in a file dialog.

(Inherited from FileDialog)
FileNames FileNames FileNames FileNames

Obtiene una matriz que contiene un nombre de archivo de cada archivo seleccionado.Gets an array that contains one file name for each selected file.

(Inherited from FileDialog)
Filter Filter Filter Filter

Obtiene o establece la cadena de filtro que determina qué tipos de archivo se muestran desde OpenFileDialog o 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

Obtiene o establece el índice del filtro que está seleccionado en un cuadro de diálogo de archivo.Gets or sets the index of the filter currently selected in a file dialog.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory InitialDirectory

Obtiene o establece el directorio inicial que muestra un cuadro de diálogo de archivo.Gets or sets the initial directory that is displayed by a file dialog.

(Inherited from FileDialog)
Multiselect Multiselect Multiselect Multiselect

Obtiene o establece una opción que indica si OpenFileDialog permite a los usuarios seleccionar varios archivos.Gets or sets an option indicating whether OpenFileDialog allows users to select multiple files.

Options Options Options Options

Obtiene los marcadores del cuadro de diálogo común de Win32Win32 que usan los cuadros de diálogo de archivo para la inicialización.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

(Inherited from FileDialog)
ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked

Obtiene o establece un valor que indica si está activada la casilla de sólo lectura mostrada por OpenFileDialog.Gets or sets a value indicating whether the read-only check box displayed by OpenFileDialog is selected.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

Esta propiedad no está implementada.This property is not implemented.

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName SafeFileName

Obtiene una cadena que solo contiene el nombre de archivo del archivo seleccionado.Gets a string that only contains the file name for the selected file.

(Inherited from FileDialog)
SafeFileNames SafeFileNames SafeFileNames SafeFileNames

Obtiene una matriz que contiene un nombre de archivo seguro de cada archivo seleccionado.Gets an array that contains one safe file name for each selected file.

(Inherited from FileDialog)
ShowReadOnly ShowReadOnly ShowReadOnly ShowReadOnly

Obtiene o establece un valor que indica si OpenFileDialog contiene una casilla de sólo lectura.Gets or sets a value indicating whether OpenFileDialog contains a read-only check box.

Tag Tag Tag Tag

Obtiene o establece un objeto asociado al cuadro de diálogo.Gets or sets an object associated with the dialog. De esta forma, se ofrece posibilidad de asociar un objeto arbitrario al cuadro de diálogo.This provides the ability to attach an arbitrary object to the dialog.

(Inherited from CommonDialog)
Title Title Title Title

Obtiene o establece el texto que aparece en la barra de título de un cuadro de diálogo de archivo.Gets or sets the text that appears in the title bar of a file dialog.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames ValidateNames

Obtiene o establece un valor que indica si el cuadro de diálogo acepta exclusivamente nombres de archivo de Win32Win32 válidos.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

(Inherited from FileDialog)

Métodos

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

Determina si hay suficientes permisos para mostrar un cuadro de diálogo.Determines whether sufficient permissions for displaying a dialog exist.

(Inherited from CommonDialog)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.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)

Define el procedimiento de enlace para cuadros de diálogo de archivos comunes que se invalida para agregar una funcionalidad común a un cuadro de diálogo de archivo.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()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Genera el evento FileOk.Raises the FileOk event.

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

Abre una secuencia de sólo lectura del archivo seleccionado por el usuario utilizando OpenFileDialog.Opens a read-only stream for the file that is selected by the user using OpenFileDialog.

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

Crea una matriz que contiene una secuencia de sólo lectura para cada archivo seleccionado por el usuario utilizando OpenFileDialog.Creates an array that contains one read-only stream for each file selected by the user using OpenFileDialog.

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

Restablece todas las propiedades de OpenFileDialog a sus valores predeterminados.Resets all OpenFileDialog properties to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

Se llama a RunDialog(IntPtr) para mostrar un cuadro de diálogo de archivo en una clase derivada, como OpenFileDialog y SaveFileDialog.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()

Muestra un cuadro de diálogo común.Displays a common dialog.

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

Muestra un cuadro de diálogo común.Displays a common dialog.

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

Devuelve una cadena que representa un cuadro de diálogo de archivo.Returns a string that represents a file dialog.

(Inherited from FileDialog)

Eventos

FileOk FileOk FileOk FileOk

Se produce cuando el usuario selecciona un nombre de archivo haciendo clic en el botón Abrir de OpenFileDialog o en el botón Guardar 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)

Se aplica a

Consulte también: