OpenFileDialog Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Muestra un cuadro de diálogo que pide al usuario que abra un archivo. Esta clase no puede heredarse.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Herencia

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Ejemplos

En el ejemplo de código siguiente se crea un OpenFileDialog, se establecen varias propiedades para definir el filtro de extensión de archivo y el comportamiento del cuadro de diálogo, y se muestra el cuadro de diálogo mediante el CommonDialog.ShowDialog método . En el ejemplo se requiere un formulario con un Button colocado en él y una referencia al System.IO espacio de nombres agregado.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

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

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

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

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

Comentarios

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

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

En un sistema operativo de derecha a izquierda, establezca la propiedad del RightToLeft formulario contenedor para RightToLeft.Yes localizar los botones Nombre de archivo, Abrir y Cancelar del cuadro de diálogo. Si la propiedad no está establecida RightToLeft.Yesen , se usa texto en inglés en su lugar.

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

Constructores

OpenFileDialog()

Inicializa una instancia de la clase OpenFileDialog.

Propiedades

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. (Heredado de FileDialog)
AddToRecent	Obtiene o establece un valor que indica si el cuadro de diálogo agrega el archivo que se abre o guarda en la lista reciente. (Heredado de FileDialog)
AutoUpgradeEnabled	Obtiene o establece un valor que indica si esta FileDialog instancia debe actualizar automáticamente la apariencia y el comportamiento al ejecutarse en Windows Vista. (Heredado de FileDialog)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
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.
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. (Heredado de FileDialog)
ClientGuid	Obtiene o establece el GUID que se va a asociar a este estado de este cuadro de diálogo. Normalmente, el estado como la última carpeta visitada y la posición y el tamaño del cuadro de diálogo se conservan en función del nombre del archivo ejecutable. Al especificar un GUID, una aplicación puede tener distintos estados persistentes para las distintas versiones del cuadro de diálogo dentro de la misma aplicación (por ejemplo, un cuadro de diálogo de importación y un cuadro de diálogo abierto). Esta funcionalidad no está disponible si una aplicación no usa estilos visuales o si AutoUpgradeEnabled está establecido en false. (Heredado de FileDialog)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
CustomPlaces	Obtiene la colección de ubicaciones personalizadas de esta instancia de FileDialog. (Heredado de FileDialog)
DefaultExt	Obtiene o establece la extensión de nombre de archivo predeterminada. (Heredado de FileDialog)
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). (Heredado de FileDialog)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
FileName	Obtiene o establece una cadena que contiene el nombre de archivo seleccionado en el cuadro de diálogo de archivo. (Heredado de FileDialog)
FileNames	Obtiene los nombres de todos los archivos seleccionados en el cuadro de diálogo. (Heredado de FileDialog)
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. (Heredado de FileDialog)
FilterIndex	Obtiene o establece el índice del filtro actualmente seleccionado en el cuadro de diálogo de archivo. (Heredado de FileDialog)
InitialDirectory	Obtiene o establece el directorio inicial que muestra el cuadro de diálogo de archivo. (Heredado de FileDialog)
Instance	Obtiene el identificador de instancia Win32 de la aplicación. (Heredado de FileDialog)
Multiselect	Obtiene o establece un valor que indica si el cuadro de diálogo permite seleccionar varios archivos.
OkRequiresInteraction	Obtiene o establece un valor que indica si el botón Aceptar del cuadro de diálogo está deshabilitado hasta que el usuario navega por la vista o edita el nombre de archivo (si procede). (Heredado de FileDialog)
Options	Obtiene los valores para inicializar el objeto FileDialog. (Heredado de FileDialog)
ReadOnlyChecked	Obtiene o establece un valor que indica si la casilla de solo lectura está activada.
RestoreDirectory	Obtiene o establece un valor que indica si el cuadro de diálogo restaura el directorio al directorio seleccionado previamente antes de cerrarse. (Heredado de FileDialog)
SafeFileName	Obtiene el nombre y la extensión de archivo del archivo seleccionado en el cuadro de diálogo. El nombre de archivo no incluye la ruta de acceso.
SafeFileNames	Obtiene una matriz de nombres y extensiones de archivo para todos los archivos seleccionados en el cuadro de diálogo. Los nombres de archivo no incluyen la ruta de acceso.
SelectReadOnly	Obtiene o establece un valor que indica si el cuadro de diálogo permite la selección de archivos de solo lectura.
ShowHelp	Obtiene o establece un valor que indica si se muestra el botón Ayuda en el cuadro de diálogo de archivo. (Heredado de FileDialog)
ShowHiddenFiles	Obtiene o establece un valor que indica si el cuadro de diálogo muestra archivos ocultos y del sistema. (Heredado de FileDialog)
ShowPinnedPlaces	Obtiene o establece un valor que indica si se muestran los elementos que se muestran de forma predeterminada en el panel de navegación de la vista. (Heredado de FileDialog)
ShowPreview	Obtiene o establece un valor que indica si el cuadro de diálogo muestra una vista previa de los archivos seleccionados.
ShowReadOnly	Obtiene o establece un valor que indica si el cuadro de diálogo contiene una casilla de solo lectura.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
SupportMultiDottedExtensions	Obtiene o establece si el cuadro de diálogo admite mostrar y guardar archivos que tienen varias extensiones de nombre de archivo. (Heredado de FileDialog)
Tag	Obtiene o establece un objeto que contiene datos sobre el control. (Heredado de CommonDialog)
Title	Obtiene o establece el título del 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

CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
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)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
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 comunes que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo de archivo. (Heredado de FileDialog)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnFileOk(CancelEventArgs)	Genera el evento FileOk. (Heredado de FileDialog)
OnHelpRequest(EventArgs)	Genera el evento HelpRequest. (Heredado de CommonDialog)
OpenFile()	Abre el archivo seleccionado por el usuario con permiso de solo lectura. La propiedad FileName especifica el archivo.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
Reset()	Restablece los valores predeterminados de todas las propiedades.
RunDialog(IntPtr)	Especifica un cuadro de diálogo común. (Heredado de FileDialog)
ShowDialog()	Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Heredado de CommonDialog)
ShowDialog(IWin32Window)	Ejecuta un cuadro de diálogo común con el propietario especificado. (Heredado de CommonDialog)
ToString()	Devuelve una versión de cadena de este objeto. (Heredado de FileDialog)

Eventos

Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)
FileOk	Se produce cuando el usuario hace clic en el botón Abrir o Guardar de un cuadro de diálogo de archivo. (Heredado de FileDialog)
HelpRequest	Se produce cuando el usuario hace clic en el botón Ayuda de un cuadro de diálogo común. (Heredado de CommonDialog)

Consulte también

• FileDialog
• CommonDialog
• SaveFileDialog
• Cómo: Leer texto de un archivo