Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
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
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

OpenFileDialog (Clase)

.NET Framework 4

Solicita al usuario que abra un archivo. Esta clase no puede heredarse.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
        System.Windows.Forms.FileDialog
          System.Windows.Forms.OpenFileDialog

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
public sealed class OpenFileDialog : FileDialog

El tipo OpenFileDialog expone los siguientes miembros.

  Nombre Descripción
Método público OpenFileDialog Inicializa una instancia de la clase OpenFileDialog.
Arriba
  Nombre Descripción
Propiedad pública AddExtension Obtiene o establece un valor que indica si el cuadro de diálogo agrega automáticamente una extensión a un nombre de archivo en caso de que el usuario omita dicha extensión. (Se hereda de FileDialog).
Propiedad pública AutoUpgradeEnabled Obtiene o establece un valor que indica si esta instancia de FileDialog debe actualizar automáticamente el aspecto y el comportamiento cuando se ejecute en Windows Vista. (Se hereda de FileDialog).
Propiedad protegida CanRaiseEvents Obtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad pública CheckFileExists Obtiene o establece un valor que indica si el cuadro de diálogo muestra una advertencia cuando el usuario especifica un nombre de archivo que no existe. (Invalida a FileDialog.CheckFileExists).
Propiedad pública CheckPathExists Obtiene o establece un valor que indica si el cuadro de diálogo muestra una advertencia cuando el usuario especifica una ruta de acceso que no existe. (Se hereda de FileDialog).
Propiedad pública Container Obtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad pública CustomPlaces Obtiene la colección de ubicaciones personalizadas de esta instancia de FileDialog. (Se hereda de FileDialog).
Propiedad pública DefaultExt Obtiene o establece la extensión de nombre de archivo predeterminada. (Se hereda de FileDialog).
Propiedad pública DereferenceLinks Obtiene o establece un valor que indica si el cuadro de diálogo devuelve la ubicación del archivo al que hace referencia el acceso directo o bien devuelve la ubicación del acceso directo (.lnk). (Se hereda de FileDialog).
Propiedad protegida DesignMode Obtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegida Events Obtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad pública FileName Obtiene o establece una cadena que contiene el nombre de archivo seleccionado en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública FileNames Obtiene los nombres de todos los archivos seleccionados en el cuadro de diálogo. (Se hereda de FileDialog).
Propiedad pública Filter Obtiene o establece la cadena actual de filtro de nombres de archivo, que determina las opciones que aparecen en los cuadros "Guardar como archivo de tipo" o "Archivos de tipo" del cuadro de diálogo. (Se hereda de FileDialog).
Propiedad pública FilterIndex Obtiene o establece el índice del filtro actualmente seleccionado en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública InitialDirectory Obtiene o establece el directorio inicial que muestra el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad protegida Instance Infraestructura. Obtiene el identificador de instancia Win32 de la aplicación. (Se hereda de FileDialog).
Propiedad pública Multiselect Obtiene o establece un valor que indica si el cuadro de diálogo permite seleccionar varios archivos.
Propiedad protegida Options Infraestructura. Obtiene los valores para inicializar el objeto FileDialog. (Se hereda de FileDialog).
Propiedad pública ReadOnlyChecked Obtiene o establece un valor que indica si la casilla de sólo lectura está activada.
Propiedad pública RestoreDirectory Obtiene o establece un valor que indica si el cuadro de diálogo restaura el directorio actual antes de cerrarse. (Se hereda de FileDialog).
Propiedad pública SafeFileName Obtiene el nombre y la extensión de archivo del archivo seleccionado en el cuadro de diálogo. El nombre del archivo no incluye la ruta de acceso.
Propiedad pública SafeFileNames Obtiene una matriz de nombres y extensiones de archivo para todos los archivos seleccionados del cuadro de diálogo. Los nombres de archivo no incluyen la ruta de acceso.
Propiedad pública ShowHelp Obtiene o establece un valor que indica si se muestra el botón Ayuda en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública ShowReadOnly Obtiene o establece un valor que indica si el cuadro de diálogo contiene una casilla de sólo lectura.
Propiedad pública Site Obtiene o establece ISite de Component. (Se hereda de Component).
Propiedad pública SupportMultiDottedExtensions Obtiene o establece si el cuadro de diálogo admite mostrar y guardar archivos que tienen varias extensiones de nombre de archivo. (Se hereda de FileDialog).
Propiedad pública Tag Obtiene o establece un objeto que contiene datos sobre el control . (Se hereda de CommonDialog).
Propiedad pública Title Obtiene o establece el título del cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública ValidateNames Obtiene o establece un valor que indica si el cuadro de diálogo acepta sólo nombres de archivo Win32 válidos. (Se hereda de FileDialog).
Arriba
  Nombre Descripción
Método público CreateObjRef Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método público Dispose() Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegido Dispose(Boolean) Libera los recursos no administrados usados por Component y, opcionalmente, los recursos administrados. (Se hereda de Component).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido GetService Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido HookProc Define el procedimiento de enlace para cuadros de diálogo comunes que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo de archivo. (Se hereda de FileDialog).
Método público InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido MemberwiseClone() Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MemberwiseClone(Boolean) Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegido OnFileOk Desencadena el evento FileOk. (Se hereda de FileDialog).
Método protegido OnHelpRequest Provoca el evento HelpRequest. (Se hereda de CommonDialog).
Método público OpenFile Abre el archivo seleccionado por el usuario con permiso de sólo lectura. La propiedad FileName especifica el archivo.
Método protegido OwnerWndProc Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Se hereda de CommonDialog).
Método público Reset Restablece los valores predeterminados de todas las propiedades. (Invalida a FileDialog.Reset()).
Método protegido RunDialog Infraestructura. Especifica un cuadro de diálogo común. (Se hereda de FileDialog).
Método público ShowDialog() Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Se hereda de CommonDialog).
Método público ShowDialog(IWin32Window) Ejecuta un cuadro de diálogo común con el propietario especificado. (Se hereda de CommonDialog).
Método público ToString Infraestructura. Devuelve una versión de cadena de este objeto . (Se hereda de FileDialog).
Arriba
  Nombre Descripción
Evento público Disposed Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento público FileOk Se desencadena cuando el usuario hace clic en el botón Abrir o Guardar de un cuadro de diálogo de archivo. (Se hereda de FileDialog).
Evento público HelpRequest Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Se hereda de CommonDialog).
Arriba

Esta clase permite comprobar si existe un archivo y abrirlo. La propiedad ShowReadOnly determina si aparece una casilla de sólo lectura en el cuadro de diálogo. La propiedad ReadOnlyChecked indica si la casilla de sólo lectura está activada.

La mayor parte de la funcionalidad de esta clase se encuentra en la clase FileDialog.

Si desea dar al usuario la capacidad de seleccionar una carpeta en lugar de un archivo, utilice FolderBrowserDialog en su lugar.

En el siguiente ejemplo de código se crea OpenFileDialog, se establecen varias propiedades y se muestra el cuadro de diálogo mediante el método CommonDialog.ShowDialog. En el ejemplo se requiere un formulario con un objeto Button colocado en él y el espacio de nombres System.IO agregado al mismo.

C#
C++
VB
Copiar 

private void button1_Click(object sender, System.EventArgs e)
{
    Stream myStream = null;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();

    openFileDialog1.InitialDirectory = "c:\\" ;
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
    openFileDialog1.FilterIndex = 2 ;
    openFileDialog1.RestoreDirectory = true ;

    if(openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        try
        {
            if ((myStream = openFileDialog1.OpenFile()) != null)
            {
                using (myStream)
                {
                    // Insert code to read the stream here.
                }
            }
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error: Could not read file from disk. Original error: " + ex.Message);
        }
    }
}

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, 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.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes