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í.
Pide al usuario que seleccione 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
| Nombre | Description |
|---|---|
| SaveFileDialog() |
Inicializa una nueva instancia de esta clase. |
Propiedades
| Nombre | Description |
|---|---|
| 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 si el usuario omite la extensión. (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 si 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 si el usuario especifica una ruta de acceso que no existe. (Heredado de FileDialog) |
| Container |
Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component) |
| CreatePrompt |
Obtiene o establece un valor que indica si el cuadro de diálogo solicita al usuario permiso para crear un archivo si el usuario especifica un archivo que no existe. |
| CustomPlaces |
Obtiene la colección de lugares personalizados para esta FileDialog instancia. (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 si devuelve la ubicación del acceso directo (.lnk). (Heredado de FileDialog) |
| DesignMode |
Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño. (Heredado de Component) |
| Events |
Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component) |
| FileName |
Obtiene o establece una cadena que contiene el nombre de archivo seleccionado en el cuadro de diálogo archivo. (Heredado de FileDialog) |
| FileNames |
Obtiene los nombres de archivo de todos los archivos seleccionados en el cuadro de diálogo. (Heredado de FileDialog) |
| Filter |
Obtiene o establece la cadena de filtro de nombre de archivo actual, que determina las opciones que aparecen en el cuadro "Guardar como tipo de archivo" o "Archivos de tipo" en el cuadro de diálogo. (Heredado de FileDialog) |
| FilterIndex |
Obtiene o establece el índice del filtro seleccionado actualmente en el cuadro de diálogo archivo. (Heredado de FileDialog) |
| InitialDirectory |
Obtiene o establece el directorio inicial mostrado por el cuadro de diálogo archivo. (Heredado de FileDialog) |
| Instance |
Obtiene el identificador de instancia de Win32 para la aplicación. (Heredado de FileDialog) |
| Options |
Obtiene los valores para inicializar .FileDialog (Heredado de FileDialog) |
| OverwritePrompt |
Obtiene o establece un valor que indica si el |
| RestoreDirectory |
Obtiene o establece un valor que indica si el cuadro de diálogo restaura el directorio al directorio seleccionado anteriormente antes de cerrarse. (Heredado de FileDialog) |
| ShowHelp |
Obtiene o establece un valor que indica si el botón Ayuda se muestra en el cuadro de diálogo archivo. (Heredado de FileDialog) |
| Site |
Obtiene o establece ISite de Component. (Heredado de Component) |
| SupportMultiDottedExtensions |
Obtiene o establece si el cuadro de diálogo admite la visualización y guardado de 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 solo acepta nombres de archivo Win32 válidos. (Heredado de FileDialog) |
Métodos
| Nombre | Description |
|---|---|
| CreateObjRef(Type) |
Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
| Dispose() |
Libera todos los recursos usados por .Component (Heredado de Component) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por Component y, opcionalmente, libera los recursos administrados. (Heredado de Component) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetLifetimeService() |
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 un servicio proporcionado por Component o por su 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 de cuadro de diálogo común que se invalida para agregar funcionalidad específica al cuadro de diálogo de archivo. (Heredado de FileDialog) |
| InitializeLifetimeService() |
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 Objectactual. (Heredado de Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficial del objeto actual MarshalByRefObject . (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 con el permiso de lectura y escritura seleccionado por el usuario. |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Define el procedimiento de ventana de propietario que se invalida para agregar funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog) |
| Reset() |
Restablece todas las opciones del cuadro de diálogo a sus valores predeterminados. |
| 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() |
Proporciona una versión de cadena de este objeto. (Heredado de FileDialog) |
Eventos
| Nombre | Description |
|---|---|
| Disposed |
Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component) |
| FileOk |
Se produce cuando el usuario hace clic en el botón Abrir o Guardar en un cuadro de diálogo de archivo. (Heredado de FileDialog) |
| HelpRequest |
Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Heredado de CommonDialog) |