OpenFileDialog OpenFileDialog OpenFileDialog OpenFileDialog Class

Definición

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. Esta clase no puede heredarse.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
Herencia

Ejemplos

En el ejemplo de código siguiente se crea un OpenFileDialog, Establece varias propiedades para definir el comportamiento de filtro y el cuadro de diálogo de la extensión de archivo y se muestra el cuadro de diálogo mediante la CommonDialog.ShowDialog método.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 un Button colocado en él y una referencia a la System.IO espacio de nombres que se agregan a él.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

Comentarios

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. El ShowReadOnly propiedad determina si aparece una casilla de solo lectura en el cuadro de diálogo.The ShowReadOnly property determines whether a read-only check box appears in the dialog box. El ReadOnlyChecked propiedad indica si está activada la casilla de solo lectura.The ReadOnlyChecked property indicates whether the read-only check box is checked.

La mayoría de las funcionalidades principales de esta clase se encuentra en el FileDialog clase.Most of the core functionality for this class is found in the FileDialog class.

En un sistema operativo de derecha a izquierda, establecer el formulario que contiene RightToLeft propiedad RightToLeft.Yes localiza el cuadro de diálogo nombre de archivo, abierto, y cancelar botones.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 se establece en RightToLeft.Yes, texto en inglés se usa en su lugar.If the property is not set to RightToLeft.Yes, English text is used instead.

Si desea dar al usuario la capacidad 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.

Constructores

OpenFileDialog() OpenFileDialog() OpenFileDialog() OpenFileDialog()

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

Propiedades

AddExtension AddExtension AddExtension 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 AutoUpgradeEnabled AutoUpgradeEnabled 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 CanRaiseEvents CanRaiseEvents 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 CheckFileExists CheckFileExists 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 CheckPathExists CheckPathExists 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)
Container Container Container Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Inherited from Component)
CustomPlaces CustomPlaces CustomPlaces 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 DefaultExt DefaultExt DefaultExt

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

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks 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 DesignMode DesignMode 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 Events Events 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 FileName FileName 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 FileNames FileNames 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 Filter Filter 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 FilterIndex FilterIndex 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 InitialDirectory InitialDirectory 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 Instance Instance Instance

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

(Inherited from FileDialog)
Multiselect Multiselect Multiselect 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 Options Options Options

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

(Inherited from FileDialog)
ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked 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 RestoreDirectory RestoreDirectory 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 SafeFileName SafeFileName 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 SafeFileNames SafeFileNames 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 ShowHelp ShowHelp 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 ShowReadOnly ShowReadOnly 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 Site Site Site

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

(Inherited from Component)
SupportMultiDottedExtensions SupportMultiDottedExtensions SupportMultiDottedExtensions 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 Tag Tag 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 Title Title 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 ValidateNames ValidateNames 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)

Métodos

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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) GetService(Type) GetService(Type) 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() GetType() GetType() GetType()

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

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) 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() InitializeLifetimeService() InitializeLifetimeService() 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

Genera el evento FileOk.Raises the FileOk event.

(Inherited from FileDialog)
OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs)

Genera el evento HelpRequest.Raises the HelpRequest event.

(Inherited from CommonDialog)
OpenFile() OpenFile() OpenFile() 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) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) 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() Reset() Reset() Reset()

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

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

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

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() 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) ShowDialog(IWin32Window) ShowDialog(IWin32Window) 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() ToString() ToString() ToString()

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

(Inherited from FileDialog)

Eventos

Disposed Disposed Disposed Disposed

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

(Inherited from Component)
FileOk FileOk FileOk 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 HelpRequest HelpRequest 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)

Se aplica a

Consulte también: