OpenFileDialog Clase

Definición

Espacio de nombres:

Microsoft.Win32

Ensamblado:

PresentationFramework.dll

Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para abrir uno o varios archivos.

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

Object

CommonDialog

FileDialog

OpenFileDialog

Ejemplos

En el ejemplo siguiente se muestra cómo crear un OpenFileDialog objeto que contiene un nombre de archivo y un tipo de extensión predeterminados.

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

En la ilustración siguiente se muestra un OpenFileDialog para Windows Vista.

A partir de Windows Vista, los cuadros de diálogo abrir y guardar archivo tienen un panel Vínculos favoritos en el lado izquierdo del cuadro de diálogo que permite al usuario navegar rápidamente a otra ubicación. Estos vínculos se denominan lugares personalizados. Utilice la CustomPlaces propiedad para establecer esta lista de vínculos.

Uso de texto XAML

No puedes declarar esta clase administrada en XAML.

Constructores

OpenFileDialog()

Inicializa una nueva instancia de la clase OpenFileDialog.

Propiedades

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. (Heredado de FileDialog)
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. (Heredado de FileDialog)
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. (Heredado de FileDialog)
CustomPlaces	Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos. (Heredado de FileDialog)
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. (Heredado de FileDialog)
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). (Heredado de FileDialog)
FileName	Obtiene o establece una cadena que contiene la ruta de acceso completa del archivo seleccionado en un cuadro de diálogo de archivo. (Heredado de FileDialog)
FileNames	Obtiene una matriz que contiene un nombre de archivo de cada archivo seleccionado. (Heredado de FileDialog)
Filter	Obtiene o establece la cadena de filtro que determina qué tipos de archivo se muestran desde OpenFileDialog o SaveFileDialog. (Heredado de FileDialog)
FilterIndex	Obtiene o establece el índice del filtro que está seleccionado en un cuadro de diálogo de archivo. (Heredado de FileDialog)
InitialDirectory	Obtiene o establece el directorio inicial que muestra un cuadro de diálogo de archivo. (Heredado de FileDialog)
Multiselect	Obtiene o establece una opción que indica si OpenFileDialog permite a los usuarios seleccionar varios archivos.
Options	Obtiene las marcas de diálogo de archivo comunes de Win32 que usan los diálogos de archivo para la inicialización. (Heredado de FileDialog)
ReadOnlyChecked	Obtiene o establece un valor que indica si está activada la casilla de sólo lectura mostrada por OpenFileDialog.
RestoreDirectory	Esta propiedad no está implementada. (Heredado de FileDialog)
SafeFileName	Obtiene una cadena que solo contiene el nombre del archivo seleccionado. (Heredado de FileDialog)
SafeFileNames	Obtiene una matriz que contiene un nombre de archivo seguro de cada archivo seleccionado. (Heredado de FileDialog)
ShowReadOnly	Obtiene o establece un valor que indica si OpenFileDialog contiene una casilla de sólo lectura.
Tag	Obtiene o establece un objeto asociado al cuadro de diálogo. De esta forma, se ofrece posibilidad de asociar un objeto arbitrario al cuadro de diálogo. (Heredado de CommonDialog)
Title	Obtiene o establece el texto que aparece en la barra de título de un cuadro de diálogo de archivo. (Heredado de FileDialog)
ValidateNames	Obtiene o establece un valor que indica si el cuadro de diálogo acepta solo nombres de archivo Win32 válidos. (Heredado de FileDialog)

Métodos

CheckPermissionsToShowDialog()	Determina si hay suficientes permisos para mostrar un cuadro de diálogo. (Heredado de CommonDialog)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
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. (Heredado de FileDialog)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnFileOk(CancelEventArgs)	Genera el evento FileOk. (Heredado de FileDialog)
OnItemOk(CancelEventArgs)	Genera el evento FileOk. (Heredado de FileDialog)
OpenFile()	Abre una secuencia de sólo lectura del archivo seleccionado por el usuario utilizando OpenFileDialog.
OpenFiles()	Crea una matriz que contiene una secuencia de sólo lectura para cada archivo seleccionado por el usuario utilizando OpenFileDialog.
Reset()	Restablece todas las propiedades de OpenFileDialog a sus valores predeterminados.
RunDialog(IntPtr)	Se llama a RunDialog(IntPtr) para mostrar un cuadro de diálogo de archivo en una clase derivada, como OpenFileDialog y SaveFileDialog. (Heredado de FileDialog)
ShowDialog()	Muestra un cuadro de diálogo común. (Heredado de CommonDialog)
ShowDialog(Window)	Muestra un cuadro de diálogo común. (Heredado de CommonDialog)
ToString()	Devuelve una cadena que representa un cuadro de diálogo de archivo. (Heredado de FileDialog)

Eventos

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. (Heredado de FileDialog)

Consulte también

• SaveFileDialog