OpenFileDialog Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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::FileDialogpublic sealed class OpenFileDialog : System.Windows.Forms.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic NotInheritable Class OpenFileDialog
Inherits FileDialog- Herencia
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 |
| 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() |
Obsoletos.
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() |
Obsoletos.
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) |
