SaveFileDialog Clase

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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::FileDialog
public sealed class SaveFileDialog : System.Windows.Forms.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
Herencia
Object
MarshalByRefObject
Component
CommonDialog
FileDialog
SaveFileDialog

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

(Heredado de FileDialog)
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 Save As muestra una advertencia cuando el usuario especifica un nombre de archivo que ya existe.
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)

Se aplica a

Consulte también