Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

SaveFileDialog (Clase)

.NET Framework 4

Pregunta al usuario si desea seleccionar una ubicación para guardar un archivo. Esta clase no puede heredarse.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
        System.Windows.Forms.FileDialog
          System.Windows.Forms.SaveFileDialog

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
public sealed class SaveFileDialog : FileDialog

El tipo SaveFileDialog expone los siguientes miembros.

  Nombre Descripción
Método público SaveFileDialog Inicializa una nueva instancia de esta clase.
Arriba
  Nombre Descripción
Propiedad pública 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. (Se hereda de FileDialog).
Propiedad pública 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 Vista. (Se hereda de FileDialog).
Propiedad protegida CanRaiseEvents Obtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad pública 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. (Se hereda de FileDialog).
Propiedad pública 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. (Se hereda de FileDialog).
Propiedad pública Container Obtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad pública 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.
Propiedad pública CustomPlaces Obtiene la colección de ubicaciones personalizadas de esta instancia de FileDialog. (Se hereda de FileDialog).
Propiedad pública DefaultExt Obtiene o establece la extensión de nombre de archivo predeterminada. (Se hereda de FileDialog).
Propiedad pública 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). (Se hereda de FileDialog).
Propiedad protegida DesignMode Obtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegida Events Obtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad pública FileName Obtiene o establece una cadena que contiene el nombre de archivo seleccionado en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública FileNames Obtiene los nombres de todos los archivos seleccionados en el cuadro de diálogo. (Se hereda de FileDialog).
Propiedad pública 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. (Se hereda de FileDialog).
Propiedad pública FilterIndex Obtiene o establece el índice del filtro actualmente seleccionado en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública InitialDirectory Obtiene o establece el directorio inicial que muestra el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad protegida Instance Infraestructura. Obtiene el identificador de instancia Win32 de la aplicación. (Se hereda de FileDialog).
Propiedad protegida Options Infraestructura. Obtiene los valores para inicializar el objeto FileDialog. (Se hereda de FileDialog).
Propiedad pública 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.
Propiedad pública RestoreDirectory Obtiene o establece un valor que indica si el cuadro de diálogo restaura el directorio actual antes de cerrarse. (Se hereda de FileDialog).
Propiedad pública ShowHelp Obtiene o establece un valor que indica si se muestra el botón Ayuda en el cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública Site Obtiene o establece ISite de Component. (Se hereda de Component).
Propiedad pública SupportMultiDottedExtensions Obtiene o establece si el cuadro de diálogo admite mostrar y guardar archivos que tienen varias extensiones de nombre de archivo. (Se hereda de FileDialog).
Propiedad pública Tag Obtiene o establece un objeto que contiene datos sobre el control . (Se hereda de CommonDialog).
Propiedad pública Title Obtiene o establece el título del cuadro de diálogo de archivo. (Se hereda de FileDialog).
Propiedad pública ValidateNames Obtiene o establece un valor que indica si el cuadro de diálogo acepta sólo nombres de archivo Win32 válidos. (Se hereda de FileDialog).
Arriba
  Nombre Descripción
Método público CreateObjRef Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método público Dispose() Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegido Dispose(Boolean) Libera los recursos no administrados usados por Component y, opcionalmente, los recursos administrados. (Se hereda de Component).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido GetService Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido HookProc 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. (Se hereda de FileDialog).
Método público InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido MemberwiseClone() Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MemberwiseClone(Boolean) Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegido OnFileOk Desencadena el evento FileOk. (Se hereda de FileDialog).
Método protegido OnHelpRequest Provoca el evento HelpRequest. (Se hereda de CommonDialog).
Método público OpenFile Abre el archivo seleccionado por el usuario con permiso de lectura y escritura.
Método protegido OwnerWndProc Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Se hereda de CommonDialog).
Método público Reset Restablece los valores predeterminados de todas las opciones del cuadro de diálogo. (Invalida a FileDialog.Reset()).
Método protegido RunDialog Infraestructura. Especifica un cuadro de diálogo común. (Se hereda de FileDialog).
Método público ShowDialog() Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Se hereda de CommonDialog).
Método público ShowDialog(IWin32Window) Ejecuta un cuadro de diálogo común con el propietario especificado. (Se hereda de CommonDialog).
Método público ToString Infraestructura. Devuelve una versión de cadena de este objeto . (Se hereda de FileDialog).
Arriba
  Nombre Descripción
Evento público Disposed Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento público FileOk Se desencadena cuando el usuario hace clic en el botón Abrir o Guardar de un cuadro de diálogo de archivo. (Se hereda de FileDialog).
Evento público HelpRequest Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Se hereda de CommonDialog).
Arriba

Esta clase permite abrir y sobrescribir un archivo existente o crear un archivo nuevo.

La mayor parte de la funcionalidad de esta clase se encuentra en la clase FileDialog.

En el ejemplo de código siguiente se muestra la forma de crear un objeto SaveFileDialog, establecer los miembros, llamar al cuadro de diálogo utilizando el método ShowDialog y guardar el archivo actual. El ejemplo requiere la existencia de un formulario con un botón.

C#
C++
VB
Copiar 

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();
         }
     }
 }

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes
Error en el código de ejemplo
$0$0 $0 $0Hay un error en el código de ejemplo, donde dice:$0 $0 $0$0 $0 $0 $0if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )$0 $0 $0$0 $0 $0Debería decir:$0 $0$0 $0 $0if ( saveFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )$0 $0 $0$0 $0 $0$0 $0
Historial