SaveFileDialog Clase

Definición

Espacio de nombres:

Microsoft.Win32

Ensamblado:

PresentationFramework.dll

Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para guardar un archivo con ese nombre. Una aplicación que se ejecute con confianza parcial no podrá utilizar SaveFileDialog.

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class SaveFileDialog : Microsoft.Win32.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

Herencia

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

Ejemplos

En el ejemplo siguiente se muestra cómo crear y SaveFileDialog procesar el resultado.

// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show save file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process save file dialog box results
if (result == true)
{
    // Save document
    string filename = dlg.FileName;
}

' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dlg.FileName
End If

Comentarios

No puedes declarar esta clase administrada en XAML.

Constructores

SaveFileDialog()

Inicializa una nueva instancia de la clase SaveFileDialog.

Propiedades

AddExtension	Obtiene o establece un valor que indica si el cuadro de diálogo de archivo agrega automáticamente una extensión a un nombre de archivo en caso de que el usuario la omita. (Heredado de FileDialog)
AddToRecent	Obtiene o establece un valor que indica si el cuadro de diálogo agregará el elemento que se va a abrir o guardar en la lista de documentos recientes. (Heredado de CommonItemDialog)
CheckFileExists	Obtiene o establece un valor que indica si el cuadro de diálogo de archivo muestra una advertencia cuando el usuario especifica un nombre de archivo que no existe. (Heredado de FileDialog)
CheckPathExists	Obtiene o establece un valor que especifica si se muestran advertencias en caso de que el usuario escriba rutas de acceso y nombres de archivo no válidos. (Heredado de FileDialog)
ClientGuid	Obtiene o establece un GUID que se va a asociar al estado persistente del cuadro de diálogo. (Heredado de CommonItemDialog)
CreatePrompt	Obtiene o establece un valor que indica si SaveFileDialog pide permiso al usuario para crear un archivo cuando el usuario especifica un archivo que no existe.
CreateTestFile	Obtiene o establece un valor que indica si el cuadro de diálogo intentará crear un archivo de prueba en la ruta de acceso seleccionada.
CustomPlaces	Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos. (Heredado de FileDialog)
DefaultDirectory	Obtiene o establece el directorio que muestra el cuadro de diálogo de archivo si no hay ningún valor de directorio usado recientemente disponible. (Heredado de CommonItemDialog)
DefaultExt	Obtiene o establece un valor que especifica la cadena de la extensión predeterminada que se va a usar para filtrar la lista de archivos que se muestran. (Heredado de FileDialog)
DereferenceLinks	Obtiene o establece un valor que indica si un cuadro de diálogo de archivo devuelve la ubicación del archivo al que hace referencia un acceso directo o la ubicación del archivo de acceso directo (.lnk). (Heredado de FileDialog)
FileName	Obtiene o establece una cadena que contiene la ruta de acceso completa del archivo seleccionado en un cuadro de diálogo de archivo. (Heredado de FileDialog)
FileNames	Obtiene una matriz que contiene un nombre de archivo de cada archivo seleccionado. (Heredado de FileDialog)
Filter	Obtiene o establece la cadena de filtro que determina qué tipos de archivo se muestran desde OpenFileDialog o SaveFileDialog. (Heredado de FileDialog)
FilterIndex	Obtiene o establece el índice del filtro que está seleccionado en un cuadro de diálogo de archivo. (Heredado de FileDialog)
InitialDirectory	Obtiene o establece el directorio inicial que muestra un cuadro de diálogo de archivo. (Heredado de FileDialog)
Options	Obtiene las marcas de diálogo de archivos comunes de Win32 que usan los diálogos de archivo para la inicialización. (Heredado de FileDialog)
OverwritePrompt	Obtiene o establece un valor que indica si SaveFileDialog muestra una advertencia cuando el usuario especifica el nombre de un archivo que ya existe.
RestoreDirectory	Esta propiedad no está implementada. (Heredado de FileDialog)
RootDirectory	Obtiene o establece el directorio que se muestra como la raíz de navegación del cuadro de diálogo. (Heredado de CommonItemDialog)
SafeFileName	Obtiene una cadena que solo contiene el nombre del archivo seleccionado. (Heredado de FileDialog)
SafeFileNames	Obtiene una matriz que contiene un nombre de archivo seguro de cada archivo seleccionado. (Heredado de FileDialog)
ShowHiddenItems	Obtiene o establece un valor que indica si el cuadro de diálogo mostrará elementos ocultos y del sistema independientemente de las preferencias del usuario. (Heredado de CommonItemDialog)
Tag	Obtiene o establece un objeto asociado al cuadro de diálogo. De esta forma, se ofrece posibilidad de asociar un objeto arbitrario al cuadro de diálogo. (Heredado de CommonDialog)
Title	Obtiene o establece el texto que aparece en la barra de título de un 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

CheckPermissionsToShowDialog()	Determina si hay suficientes permisos para mostrar un cuadro de diálogo. (Heredado de CommonDialog)
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)
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 de archivos comunes que se invalida para agregar una funcionalidad común a un cuadro de diálogo de archivo. (Heredado de FileDialog)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnFileOk(CancelEventArgs)	Genera el evento FileOk. (Heredado de FileDialog)
OnItemOk(CancelEventArgs)	Genera el evento FileOk. (Heredado de FileDialog)
OpenFile()	Crea una secuencia de archivo de lectura y escritura para el nombre de archivo seleccionado por el usuario utilizando SaveFileDialog.
Reset()	Restablece todas las propiedades de SaveFileDialog a sus valores predeterminados.
RunDialog(IntPtr)	Se llama a RunDialog(IntPtr) para mostrar un cuadro de diálogo de archivo en una clase derivada, como OpenFileDialog y SaveFileDialog. (Heredado de FileDialog)
ShowDialog()	Muestra un cuadro de diálogo común. (Heredado de CommonDialog)
ShowDialog(Window)	Muestra un cuadro de diálogo común. (Heredado de CommonDialog)
ToString()	Devuelve una cadena que representa un cuadro de diálogo de archivo. (Heredado de FileDialog)

Eventos

FileOk

Se produce cuando el usuario selecciona un nombre de archivo haciendo clic en el botón Abrir de OpenFileDialog o en el botón Guardar de SaveFileDialog. (Heredado de FileDialog)

Consulte también

• OpenFileDialog