SaveFileDialog Clase

Definición

Pregunta al usuario si desea seleccionar una ubicación para guardar un archivo.Prompts the user to select a location for saving a file. Esta clase no puede heredarse.This class cannot be inherited.

public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialog
public sealed class SaveFileDialog : System.Windows.Forms.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra SaveFileDialogcómo crear, establecer miembros, llamar al cuadro de ShowDialog diálogo mediante el método y guardar el archivo actual.The following code example illustrates creating a SaveFileDialog, setting members, calling the dialog box using the ShowDialog method, and saving the current file. El ejemplo requiere un formulario con un botón colocado en él.The example requires a form with a button placed on it.

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.This class can either open and overwrite an existing file or create a new file.

La mayor parte de la funcionalidad de esta clase se encuentra FileDialog en la clase.Most of the functionality for this class is found in the FileDialog class.

Constructores

SaveFileDialog()

Inicializa una nueva instancia de esta clase.Initializes a new instance of this class.

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.Gets or sets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.

(Heredado de FileDialog)
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.

(Heredado de FileDialog)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(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.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.

(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.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.

(Heredado de FileDialog)
Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the 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.Gets or sets a value indicating whether the dialog box prompts the user for permission to create a file if the user specifies a file that does not exist.

CustomPlaces

Obtiene la colección de ubicaciones personalizadas de esta instancia de FileDialog.Gets the custom places collection for this FileDialog instance.

(Heredado de FileDialog)
DefaultExt

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

(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).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).

(Heredado de FileDialog)
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.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this 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.Gets or sets a string containing the file name selected in the file dialog box.

(Heredado de FileDialog)
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.

(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.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.

(Heredado de FileDialog)
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.

(Heredado de FileDialog)
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.

(Heredado de FileDialog)
Instance

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

(Heredado de FileDialog)
Options

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

(Heredado de FileDialog)
OverwritePrompt

Obtiene o establece un valor que indica si el cuadro de diálogo Save As muestra una advertencia cuando el usuario especifica un nombre de archivo que ya existe.Gets or sets a value indicating whether the Save As dialog box displays a warning if the user specifies a file name that already exists.

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.

(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.Gets or sets a value indicating whether the Help button is displayed in the file dialog box.

(Heredado de FileDialog)
Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the 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.Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.

(Heredado de FileDialog)
Tag

Obtiene o establece un objeto que contiene datos sobre el control.Gets or sets an object that contains data about the control.

(Heredado de CommonDialog)
Title

Obtiene o establece el título del cuadro de diálogo de archivo.Gets or sets the file dialog box title.

(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.Gets or sets a value indicating whether the dialog box accepts only valid Win32 file names.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

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

(Heredado de Component)
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.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
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.

(Heredado de Component)
GetType()

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

(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.Defines the common dialog box hook procedure that is overridden to add specific functionality to the file dialog box.

(Heredado de FileDialog)
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.

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
OnFileOk(CancelEventArgs)

Genera el evento FileOk.Raises the FileOk event.

(Heredado de FileDialog)
OnHelpRequest(EventArgs)

Genera el evento HelpRequest.Raises the HelpRequest event.

(Heredado de CommonDialog)
OpenFile()

Abre el archivo seleccionado por el usuario con permiso de lectura y escritura.Opens the file with read/write permission selected by the user.

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.

(Heredado de CommonDialog)
Reset()

Restablece los valores predeterminados de todas las opciones del cuadro de diálogo.Resets all dialog box options to their default values.

RunDialog(IntPtr)

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

(Heredado de FileDialog)
ShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.Runs a common dialog box with a default owner.

(Heredado de CommonDialog)
ShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.Runs a common dialog box with the specified owner.

(Heredado de CommonDialog)
ToString()

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

(Heredado de FileDialog)

Eventos

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.

(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.Occurs when the user clicks on the Open or Save button on a file dialog box.

(Heredado de FileDialog)
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.

(Heredado de CommonDialog)

Se aplica a

Consulte también: