SaveFileDialog 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í.
Pregunta al usuario si desea seleccionar una ubicación para guardar un archivo. Esta clase no puede heredarse.
public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class SaveFileDialog : System.Windows.Forms.FileDialogtype SaveFileDialog = class
inherit FileDialogPublic NotInheritable Class SaveFileDialog
Inherits FileDialog- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo crear un SaveFileDialog, establecer miembros, llamar al cuadro de diálogo mediante el ShowDialog método y guardar el archivo actual. El ejemplo requiere un formulario con un botón colocado en él.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
Stream^ myStream;
SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
saveFileDialog1->FilterIndex = 2;
saveFileDialog1->RestoreDirectory = true;
if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
{
if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
{
// Code to write the stream goes here.
myStream->Close();
}
}
}
private void button1_Click(object sender, System.EventArgs e)
{
Stream myStream ;
SaveFileDialog saveFileDialog1 = new SaveFileDialog();
saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
saveFileDialog1.FilterIndex = 2 ;
saveFileDialog1.RestoreDirectory = true ;
if(saveFileDialog1.ShowDialog() == DialogResult.OK)
{
if((myStream = saveFileDialog1.OpenFile()) != null)
{
// Code to write the stream goes here.
myStream.Close();
}
}
}
Private Sub button1_Click(sender As Object, e As System.EventArgs)
Dim myStream As Stream
Dim saveFileDialog1 As New SaveFileDialog()
saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
saveFileDialog1.FilterIndex = 2
saveFileDialog1.RestoreDirectory = True
If saveFileDialog1.ShowDialog() = DialogResult.OK Then
myStream = saveFileDialog1.OpenFile()
If (myStream IsNot Nothing) Then
' Code to write the stream goes here.
myStream.Close()
End If
End If
End Sub
Comentarios
Esta clase puede abrir y sobrescribir un archivo existente o crear un archivo nuevo.
La mayor parte de la funcionalidad de esta clase se encuentra en la FileDialog clase .
Constructores
| SaveFileDialog() |
Inicializa una nueva instancia de esta clase. |
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. (Heredado de FileDialog) |
| 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) |
| CheckWriteAccess |
Obtiene o establece un valor que indica si el cuadro de diálogo comprueba si la creación del archivo especificado se realizará correctamente. Si no se establece esta marca, la aplicación que realiza la llamada debe controlar los errores, como la denegación de acceso, que se detectan cuando se crea el elemento. |
| 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) |
| CreatePrompt |
Obtiene o establece un valor que indica si el cuadro de diálogo pide permiso al usuario para crear un archivo cuando el usuario especifica un archivo que no existe. |
| 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) |
| ExpandedMode |
Obtiene o establece un valor que indica si el cuadro de diálogo siempre se abre en el modo expandido. |
| 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) |
| 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) |
| OverwritePrompt |
Obtiene o establece un valor que indica si el cuadro de diálogo |
| 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) |
| 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) |
| 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 lectura y escritura. |
| 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 opciones del cuadro de diálogo. |
| 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) |
