Compartir vía


OpenFileDialog Clase

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.

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
OpenFileDialog
Herencia

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

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

Obtiene o establece un valor que indica si el cuadro de diálogo agregará el elemento que se abre o se guarda en la lista de documentos recientes.

(Heredado de CommonItemDialog)
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)
ClientGuid

Obtiene o establece un GUID que se va a asociar al estado persistente del cuadro de diálogo.

(Heredado de CommonItemDialog)
CustomPlaces

Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos.

(Heredado de FileDialog)
DefaultDirectory

Obtiene o establece el directorio mostrado por el cuadro de diálogo archivo si no hay ningún valor de directorio usado recientemente disponible.

(Heredado de CommonItemDialog)
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)
ForcePreviewPane

Obtiene o establece una marca de opción que indica si el cuadro de diálogo fuerza el panel de vista previa.

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

Obtiene o establece el directorio que se muestra como la raíz de navegación del cuadro de diálogo.

(Heredado de CommonItemDialog)
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)
ShowHiddenItems

Obtiene o establece un valor que indica si el cuadro de diálogo mostrará elementos ocultos y del sistema independientemente de las preferencias del usuario.

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

Se aplica a

Consulte también