OpenFileDialog Class

Definition

Muestra un cuadro de diálogo que pide al usuario que abra un archivo.Displays a standard dialog box that prompts the user to open a file. No se puede heredar esta clase.This class cannot be inherited.

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
Inheritance

Examples

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 de diálogo, y se muestra el cuadro de diálogo con el método CommonDialog.ShowDialog.The following code example creates an OpenFileDialog, sets several properties to define the file extension filter and dialog behavior, and displays the dialog box using the CommonDialog.ShowDialog method. El ejemplo requiere un formulario con una Button colocada en él y una referencia al espacio de nombres System.IO que se le ha agregado.The example requires a form with a Button placed on it and a reference to the System.IO namespace added to it.

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

Remarks

Esta clase le permite comprobar si existe un archivo y abrirlo.This class allows you to check whether a file exists and to open it. La propiedad ShowReadOnly determina si en el cuadro de diálogo aparece una casilla de solo lectura.The ShowReadOnly property determines whether a read-only check box appears in the dialog box. La propiedad ReadOnlyChecked indica si la casilla de solo lectura está activada.The ReadOnlyChecked property indicates whether the read-only check box is checked.

La mayor parte de la funcionalidad básica de esta clase se encuentra en la clase FileDialog.Most of the core functionality for this class is found in the FileDialog class.

En un sistema operativo de derecha a izquierda, al establecer la propiedad RightToLeft del formulario contenedor en RightToLeft.Yes se localizan los botones nombre de archivo, abriry Cancelar del cuadro de diálogo.On a right-to-left operating system, setting the containing form's RightToLeft property to RightToLeft.Yes localizes the dialog's File Name, Open, and Cancel buttons. Si la propiedad no está establecida en RightToLeft.Yes, se usa el texto en inglés.If the property is not set to RightToLeft.Yes, English text is used instead.

Si desea conceder al usuario la posibilidad de seleccionar una carpeta en lugar de un archivo, use FolderBrowserDialog en su lugar.If you want to give the user the ability to select a folder instead of a file, use FolderBrowserDialog instead.

Constructors

OpenFileDialog()

Inicializa una instancia de la clase OpenFileDialog.Initializes an instance of the OpenFileDialog class.

Properties

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.Gets or sets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.

(Inherited from FileDialog)
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 VistaWindows Vista.Gets or sets a value indicating whether this FileDialog instance should automatically upgrade appearance and behavior when running on Windows VistaWindows Vista.

(Inherited from FileDialog)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Inherited from 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.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.

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.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.

(Inherited from FileDialog)
ClientGuid (Inherited from FileDialog)
Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Inherited from Component)
CustomPlaces

Obtiene la colección de ubicaciones personalizadas de esta instancia de FileDialog.Gets the custom places collection for this FileDialog instance.

(Inherited from FileDialog)
DefaultExt

Obtiene o establece la extensión de nombre de archivo predeterminada.Gets or sets the default file name extension.

(Inherited from 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).Gets or sets a value indicating whether the dialog box returns the location of the file referenced by the shortcut or whether it returns the location of the shortcut (.lnk).

(Inherited from FileDialog)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FileName

Obtiene o establece una cadena que contiene el nombre de archivo seleccionado en el cuadro de diálogo de archivo.Gets or sets a string containing the file name selected in the file dialog box.

(Inherited from FileDialog)
FileNames

Obtiene los nombres de todos los archivos seleccionados en el cuadro de diálogo.Gets the file names of all selected files in the dialog box.

(Inherited from 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.Gets or sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.

(Inherited from FileDialog)
FilterIndex

Obtiene o establece el índice del filtro actualmente seleccionado en el cuadro de diálogo de archivo.Gets or sets the index of the filter currently selected in the file dialog box.

(Inherited from FileDialog)
InitialDirectory

Obtiene o establece el directorio inicial que muestra el cuadro de diálogo de archivo.Gets or sets the initial directory displayed by the file dialog box.

(Inherited from FileDialog)
Instance

Obtiene el identificador de instancia Win32 de la aplicación.Gets the Win32 instance handle for the application.

(Inherited from FileDialog)
Multiselect

Obtiene o establece un valor que indica si el cuadro de diálogo permite seleccionar varios archivos.Gets or sets a value indicating whether the dialog box allows multiple files to be selected.

Options

Obtiene los valores para inicializar el objeto FileDialog.Gets values to initialize the FileDialog.

(Inherited from FileDialog)
ReadOnlyChecked

Obtiene o establece un valor que indica si la casilla de solo lectura está activada.Gets or sets a value indicating whether the read-only check box is selected.

RestoreDirectory

Obtiene o establece un valor que indica si el cuadro de diálogo restaura el directorio al directorio seleccionado previamente antes de cerrarse.Gets or sets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.

(Inherited from FileDialog)
SafeFileName

Obtiene el nombre y la extensión de archivo del archivo seleccionado en el cuadro de diálogo.Gets the file name and extension for the file selected in the dialog box. El nombre de archivo no incluye la ruta de acceso.The file name does not include the path.

SafeFileNames

Obtiene una matriz de nombres y extensiones de archivo para todos los archivos seleccionados en el cuadro de diálogo.Gets an array of file names and extensions for all the selected files in the dialog box. Los nombres de archivo no incluyen la ruta de acceso.The file names do not include the path.

ShowHelp

Obtiene o establece un valor que indica si se muestra el botón Ayuda en el cuadro de diálogo de archivo.Gets or sets a value indicating whether the Help button is displayed in the file dialog box.

(Inherited from FileDialog)
ShowReadOnly

Obtiene o establece un valor que indica si el cuadro de diálogo contiene una casilla de solo lectura.Gets or sets a value indicating whether the dialog box contains a read-only check box.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
SupportMultiDottedExtensions

Obtiene o establece si el cuadro de diálogo admite mostrar y guardar archivos que tienen varias extensiones de nombre de archivo.Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.

(Inherited from FileDialog)
Tag

Obtiene o establece un objeto que contiene datos sobre el control.Gets or sets an object that contains data about the control.

(Inherited from CommonDialog)
Title

Obtiene o establece el título del cuadro de diálogo de archivo.Gets or sets the file dialog box title.

(Inherited from FileDialog)
ValidateNames

Obtiene o establece un valor que indica si el cuadro de diálogo acepta solo nombres de archivo Win32 válidos.Gets or sets a value indicating whether the dialog box accepts only valid Win32 file names.

(Inherited from FileDialog)

Methods

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose()

Libera todos los recursos que utiliza Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean)

Libera los recursos no administrados utilizados por Component y, opcionalmente, libera también los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from 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.Defines the common dialog box hook procedure that is overridden to add specific functionality to the file dialog box.

(Inherited from FileDialog)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnFileOk(CancelEventArgs)

Inicia el evento FileOk.Raises the FileOk event.

(Inherited from FileDialog)
OnHelpRequest(EventArgs)

Inicia el evento HelpRequest.Raises the HelpRequest event.

(Inherited from CommonDialog)
OpenFile()

Abre el archivo seleccionado por el usuario con permiso de solo lectura.Opens the file selected by the user, with read-only permission. La propiedad FileName especifica el archivo.The file is specified by the FileName property.

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.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(Inherited from CommonDialog)
Reset()

Restablece los valores predeterminados de todas las propiedades.Resets all properties to their default values.

RunDialog(IntPtr)

Especifica un cuadro de diálogo común.Specifies a common dialog box.

(Inherited from FileDialog)
ShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.Runs a common dialog box with a default owner.

(Inherited from CommonDialog)
ShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.Runs a common dialog box with the specified owner.

(Inherited from CommonDialog)
ToString()

Devuelve una versión de cadena de este objeto.Provides a string version of this object.

(Inherited from FileDialog)

Events

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FileOk

Se produce cuando el usuario hace clic en el botón Abrir o Guardar de un cuadro de diálogo de archivo.Occurs when the user clicks on the Open or Save button on a file dialog box.

(Inherited from FileDialog)
HelpRequest

Se produce cuando el usuario hace clic en el botón Ayuda de un cuadro de diálogo común.Occurs when the user clicks the Help button on a common dialog box.

(Inherited from CommonDialog)

Applies to

See also