FileDialog (Clase)

FileDialog es una clase abstracta que contiene el comportamiento común para las clases de OpenFileDialog y de SaveFileDialog . No está diseñado para usarse directamente pero contiene el comportamiento común para las dos clases. No puede crear una instancia de FileDialog. Aunque la clase se declara público, no puede heredar de, como contiene métodos abstractos internos. Para crear un cuadro de diálogo para seleccionar o guardar un archivo, un uso OpenFileDialog o SaveFileDialog.

FileDialog es un cuadro de diálogo modal; por consiguiente, cuando se muestra, bloquea el resto de la aplicación hasta que el usuario ha elegido un archivo. Cuando se presenta un cuadro de diálogo modal, ninguna entrada (teclado o clic del mouse) puede aparecer excepto a objetos en el cuadro de diálogo. El programa debe ocultar o cerrar el cuadro de diálogo (normalmente en respuesta a alguna acción del usuario) antes de que la entrada del programa de llamada puede aparecer.

Precaución
Cuando se utilizan las clases derivadas de FileDialog, como OpenFileDialog y SaveFileDialog, evite utilizar literales de cadena que contienen las rutas de acceso absolutas. En su lugar, obtenga dinámicamente la ruta mediante una o más de las técnicas descritas en la tabla siguiente.

Si desea permitir a los usuarios seleccionar una carpeta en lugar de un archivo, utilice FolderBrowserDialog.

Dependiendo del tipo de aplicación, cómo los datos asociados a la aplicación se almacena, y la razón para tener acceso al sistema de archivos, hay muchas maneras posibles de las que puede crear una ruta de acceso del directorio. La tabla siguiente se muestran las técnicas para crear rutas dinámicamente.

Observe que una ruta de acceso completa se pueden acumular con uno o más de las técnicas descritas. Por ejemplo, el método de GetFolderPath se podría utilizar para obtener la ruta a la carpeta de MyDocuments, después una configuración de la aplicación se puede utilizar para agregar una parte relativa del subdirectorio.

La clase de System.IO.Path contiene miembros estáticos para ayudar a cadenas de manipulación absoluta y la ruta de acceso relativa, mientras que las clases de System.IO.File y de System.IO.Directory tienen miembros estáticos que manipulan realmente los archivos y directorios, respectivamente.

Importante
Si el usuario de la aplicación cambia la carpeta en FileDialog, el directorio de trabajo actual para la aplicación se establece en la ubicación especificada en FileDialog. para evitar esto, establezca la propiedad de RestoreDirectory a true.

El ejemplo de código siguiente utiliza la implementación de OpenFileDialog de FileDialog y muestra creando, de establecer propiedades, y se muestra el cuadro de diálogo. El ejemplo utiliza el método de ShowDialog para mostrar el cuadro de diálogo y devolver DialogResult. El ejemplo requiere un formulario con Button colocado en él y el espacio de nombres System.IO agregado al.

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

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

Referencia