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í.
Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para guardar un archivo como. SaveFileDialog no se puede usar en una aplicación que se ejecuta bajo confianza parcial.
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
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.Value)
{
// 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
| Nombre | Description |
|---|---|
| SaveFileDialog() |
Inicializa una nueva instancia de la clase SaveFileDialog. |
Propiedades
| Nombre | Description |
|---|---|
| AddExtension |
Obtiene o establece un valor que indica si un cuadro de diálogo de archivo agrega automáticamente una extensión a un nombre de archivo si el usuario omite una extensión. (Heredado de FileDialog) |
| CheckFileExists |
Obtiene o establece un valor que indica si un cuadro de diálogo de archivo muestra una advertencia si 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 si el usuario escribe rutas de acceso y nombres de archivo no válidos. (Heredado de FileDialog) |
| CreatePrompt |
Obtiene o establece un valor que indica si SaveFileDialog solicita al usuario permiso para crear un archivo si el usuario especifica un archivo que no existe. |
| CustomPlaces |
Obtiene o establece la lista de lugares personalizados para los cuadros de diálogo de archivo. (Heredado de FileDialog) |
| DefaultExt |
Obtiene o establece un valor que especifica la cadena de 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 para cada archivo seleccionado. (Heredado de FileDialog) |
| Filter |
Obtiene o establece la cadena de filtro que determina qué tipos de archivos se muestran desde o OpenFileDialogSaveFileDialog. (Heredado de FileDialog) |
| FilterIndex |
Obtiene o establece el índice del filtro seleccionado actualmente 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 si el usuario especifica el nombre de un archivo que ya existe. |
| RestoreDirectory |
Esta propiedad no está implementada. (Heredado de FileDialog) |
| SafeFileName |
Obtiene una cadena que solo contiene el nombre de archivo del archivo seleccionado. (Heredado de FileDialog) |
| SafeFileNames |
Obtiene una matriz que contiene un nombre de archivo seguro para cada archivo seleccionado. (Heredado de FileDialog) |
| Tag |
Obtiene o establece un objeto asociado al cuadro de diálogo. Esto proporciona la capacidad de adjuntar 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
| Nombre | Description |
|---|---|
| CheckPermissionsToShowDialog() |
Determina si existen permisos suficientes para mostrar un cuadro de diálogo. (Heredado de CommonDialog) |
| 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) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Define el procedimiento de enlace de diálogo de archivo común que se invalida para agregar funcionalidad común a un cuadro de diálogo de archivo. (Heredado de FileDialog) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnFileOk(CancelEventArgs) |
Genera el evento FileOk. (Heredado de FileDialog) |
| OpenFile() |
Crea una secuencia de archivos de lectura y escritura para el nombre de archivo seleccionado por el usuario mediante SaveFileDialog. |
| Reset() |
Restablece todas las SaveFileDialog propiedades a sus valores predeterminados. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) se llama a 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
| Nombre | Description |
|---|---|
| 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) |