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 que uno o varios archivos se abran.

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
Herencia
Object
CommonDialog
CommonItemDialog
FileDialog
OpenFileDialog

Ejemplos

En el ejemplo siguiente se muestra cómo crear un OpenFileDialog 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.Value)
{
    // 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

Nombre Description
OpenFileDialog()

Inicializa una nueva instancia de la clase OpenFileDialog.

Propiedades

Nombre Description
AddExtension

Obtiene o establece un valor que indica si un cuadro de diálogo de archivo agrega automáticamente una extensión a un nombre de archivo si el usuario omite una extensión.

(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 un cuadro de diálogo de archivo muestra una advertencia si 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 si el usuario escribe 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 lugares personalizados para los cuadros de diálogo de archivo.

(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 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 para cada archivo seleccionado.

(Heredado de FileDialog)
Filter

Obtiene o establece la cadena de filtro que determina qué tipos de archivos se muestran desde o OpenFileDialogSaveFileDialog.

(Heredado de FileDialog)
FilterIndex

Obtiene o establece el índice del filtro seleccionado actualmente 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 archivos 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 la casilla de solo lectura mostrada por OpenFileDialog está seleccionada.
RestoreDirectory

Esta propiedad no está implementada.

(Heredado de FileDialog)
RootDirectory

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

(Heredado de CommonItemDialog)
SafeFileName

Obtiene una cadena que solo contiene el nombre de archivo del archivo seleccionado.

(Heredado de FileDialog)
SafeFileNames

Obtiene una matriz que contiene un nombre de archivo seguro para 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 solo lectura.
Tag

Obtiene o establece un objeto asociado al cuadro de diálogo. Esto proporciona la capacidad de adjuntar 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

Nombre Description
CheckPermissionsToShowDialog()

Determina si existen permisos suficientes para mostrar un cuadro de diálogo.

(Heredado de CommonDialog)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como 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 de diálogo de archivo común que se invalida para agregar funcionalidad común a un cuadro de diálogo de archivo.

(Heredado de FileDialog)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(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 solo lectura para el archivo seleccionado por el usuario mediante OpenFileDialog.
OpenFiles()

Crea una matriz que contiene una secuencia de solo lectura para cada archivo seleccionado por el usuario mediante OpenFileDialog.
Reset()

Restablece todas las OpenFileDialog propiedades a sus valores predeterminados.
RunDialog(IntPtr)

RunDialog(IntPtr) se llama a 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

Nombre Description
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