Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
OpenFileDialog (Clase)
Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para abrir uno o varios archivos.
Microsoft.Win32.CommonDialog
Microsoft.Win32.FileDialog
Microsoft.Win32.OpenFileDialog
Ensamblado: PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: No asignado a un xmlns.
El tipo OpenFileDialog expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
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. (Se hereda 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. (Se hereda 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. (Se hereda de FileDialog). |
|
CustomPlaces | Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos. (Se hereda 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. (Se hereda 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). (Se hereda 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. (Se hereda de FileDialog). |
|
FileNames | Obtiene una matriz que contiene un nombre de archivo de cada archivo seleccionado. (Se hereda de FileDialog). |
|
Filter | Obtiene o establece la cadena de filtro que determina qué tipos de archivo se muestran desde OpenFileDialog o SaveFileDialog. (Se hereda de FileDialog). |
|
FilterIndex | Obtiene o establece el índice del filtro que está seleccionado en un cuadro de diálogo de archivo. (Se hereda de FileDialog). |
|
InitialDirectory | Obtiene o establece el directorio inicial que muestra un cuadro de diálogo de archivo. (Se hereda de FileDialog). |
|
Multiselect | Obtiene o establece una opción que indica si OpenFileDialog permite a los usuarios seleccionar varios archivos. |
|
Options | Obtiene los marcadores del cuadro de diálogo común de Win32 que usan los cuadros de diálogo de archivo para la inicialización. (Se hereda 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. (Se hereda de FileDialog). |
|
SafeFileName | Obtiene una cadena que solo contiene el nombre de archivo del archivo seleccionado. (Se hereda de FileDialog). |
|
SafeFileNames | Obtiene una matriz que contiene un nombre de archivo seguro de cada archivo seleccionado. (Se hereda 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. (Se hereda de CommonDialog). |
|
Title | Obtiene o establece el texto que aparece en la barra de título de un cuadro de diálogo de archivo. (Se hereda de FileDialog). |
|
ValidateNames | Obtiene o establece un valor que indica si el cuadro de diálogo acepta exclusivamente nombres de archivo de Win32 válidos. (Se hereda de FileDialog). |
| Nombre | Descripción | |
|---|---|---|
|
CheckPermissionsToShowDialog | Determina si hay suficientes permisos para mostrar un cuadro de diálogo. (Se hereda de CommonDialog). |
|
Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
|
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). |
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
HookProc | 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. (Se hereda de FileDialog). |
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
OnFileOk | Provoca el evento FileOk. (Se hereda 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. (Invalida a FileDialog.Reset()). |
|
RunDialog | Se llama a RunDialog para mostrar un cuadro de diálogo de archivo en una clase derivada, como OpenFileDialog y SaveFileDialog. (Se hereda de FileDialog). |
|
ShowDialog() | Muestra un cuadro de diálogo común. (Se hereda de CommonDialog). |
|
ShowDialog(Window) | Muestra un cuadro de diálogo común. (Se hereda de CommonDialog). |
|
ToString | Devuelve una cadena que representa un cuadro de diálogo de archivo. (Se hereda de FileDialog). |
| Nombre | Descripción | |
|---|---|---|
|
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. (Se hereda de FileDialog). |
En la ilustración siguiente se muestra un OpenFileDialog para Windows Vista.
Empezando por Windows Vista, los cuadros de diálogo de abrir y guardar archivos tienen un panel Vínculos favoritos en el lado izquierdo del cuadro de diálogo que le permite al usuario desplazarse rápidamente hasta una ubicación diferente. Estos vínculos se denominan lugares personalizados. Utilice la propiedad CustomPlaces para agregar esta lista de vínculos.
En el siguiente ejemplo 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 == true) { // Open document string filename = dlg.FileName; }
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.