SaveFileDialog SaveFileDialog SaveFileDialog SaveFileDialog Class

Definición

Representa un cuadro de diálogo común que permite al usuario especificar un nombre de archivo para guardar un archivo con ese nombre.Represents a common dialog that allows the user to specify a filename to save a file as. Una aplicación que se ejecute con confianza parcial no podrá utilizar SaveFileDialog.SaveFileDialog cannot be used by an application that is executing under partial trust.

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 un SaveFileDialog y procesar el resultado.The following example demonstrates how to create a SaveFileDialog and process the result.

// 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

La siguiente ilustración muestra un SaveFileDialog para Windows VistaWindows Vista.The following figure shows a SaveFileDialog for Windows VistaWindows Vista.

Cuadro de diálogo Guardar comoSave As dialog box

A partir de Windows VistaWindows Vista, abrir y guardar los cuadros de diálogo de archivo tiene un vínculos favoritos panel en el lado izquierdo del cuadro de diálogo que permite al usuario navegar rápidamente a una ubicación diferente.Starting in Windows VistaWindows Vista, open and save file dialog boxes have a Favorite Links panel on the left side of the dialog box that allows the user to quickly navigate to a different location. Estos vínculos se denominan ubicaciones personalizadas.These links are called custom places. Use el CustomPlaces propiedad para establecer esta lista de vínculos.Use the CustomPlaces property to set this list of links.

Uso de texto XAMLXAML Text Usage

No se puede declarar esta clase administrada en XAMLXAML.You cannot declare this managed class in XAMLXAML.

Constructores

SaveFileDialog() SaveFileDialog() SaveFileDialog() SaveFileDialog()

Inicializa una nueva instancia de la clase SaveFileDialog.Initializes a new instance of the SaveFileDialog class.

Propiedades

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

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

(Inherited from FileDialog)
CheckPathExists CheckPathExists CheckPathExists 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.Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names.

(Inherited from FileDialog)
CreatePrompt CreatePrompt CreatePrompt 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.Gets or sets a value indicating whether SaveFileDialog prompts the user for permission to create a file if the user specifies a file that does not exist.

CustomPlaces CustomPlaces CustomPlaces CustomPlaces

Obtiene o establece la lista de ubicaciones personalizadas para los cuadros de diálogo de archivos.Gets or sets the list of custom places for file dialog boxes.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt 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.Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed.

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks 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).Gets or sets a value indicating whether a file dialog returns either the location of the file referenced by a shortcut or the location of the shortcut file (.lnk).

(Inherited from FileDialog)
FileName FileName FileName FileName

Obtiene o establece una cadena que contiene la ruta de acceso completa del archivo seleccionado en un cuadro de diálogo de archivo.Gets or sets a string containing the full path of the file selected in a file dialog.

(Inherited from FileDialog)
FileNames FileNames FileNames FileNames

Obtiene una matriz que contiene un nombre de archivo de cada archivo seleccionado.Gets an array that contains one file name for each selected file.

(Inherited from FileDialog)
Filter Filter Filter Filter

Obtiene o establece la cadena de filtro que determina qué tipos de archivo se muestran desde OpenFileDialog o SaveFileDialog.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog.

(Inherited from FileDialog)
FilterIndex FilterIndex FilterIndex FilterIndex

Obtiene o establece el índice del filtro que está seleccionado en un cuadro de diálogo de archivo.Gets or sets the index of the filter currently selected in a file dialog.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory InitialDirectory

Obtiene o establece el directorio inicial que muestra un cuadro de diálogo de archivo.Gets or sets the initial directory that is displayed by a file dialog.

(Inherited from FileDialog)
Options Options Options Options

Obtiene los marcadores del cuadro de diálogo común de Win32Win32 que usan los cuadros de diálogo de archivo para la inicialización.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

(Inherited from FileDialog)
OverwritePrompt OverwritePrompt OverwritePrompt 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.Gets or sets a value indicating whether SaveFileDialog displays a warning if the user specifies the name of a file that already exists.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

Esta propiedad no está implementada.This property is not implemented.

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName SafeFileName

Obtiene una cadena que solo contiene el nombre de archivo del archivo seleccionado.Gets a string that only contains the file name for the selected file.

(Inherited from FileDialog)
SafeFileNames SafeFileNames SafeFileNames SafeFileNames

Obtiene una matriz que contiene un nombre de archivo seguro de cada archivo seleccionado.Gets an array that contains one safe file name for each selected file.

(Inherited from FileDialog)
Tag Tag Tag Tag

Obtiene o establece un objeto asociado al cuadro de diálogo.Gets or sets an object associated with the dialog. De esta forma, se ofrece posibilidad de asociar un objeto arbitrario al cuadro de diálogo.This provides the ability to attach an arbitrary object to the dialog.

(Inherited from CommonDialog)
Title Title Title Title

Obtiene o establece el texto que aparece en la barra de título de un cuadro de diálogo de archivo.Gets or sets the text that appears in the title bar of a file dialog.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames ValidateNames

Obtiene o establece un valor que indica si el cuadro de diálogo acepta exclusivamente nombres de archivo de Win32Win32 válidos.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

(Inherited from FileDialog)

Métodos

CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog()

Determina si hay suficientes permisos para mostrar un cuadro de diálogo.Determines whether sufficient permissions for displaying a dialog exist.

(Inherited from CommonDialog)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) 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.Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog.

(Inherited from FileDialog)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

Genera el evento FileOk.Raises the FileOk event.

(Inherited from FileDialog)
OpenFile() OpenFile() OpenFile() OpenFile()

Crea una secuencia de archivo de lectura y escritura para el nombre de archivo seleccionado por el usuario utilizando SaveFileDialog.Creates a read-write file stream for the filename selected by the user using SaveFileDialog.

Reset() Reset() Reset() Reset()

Restablece todas las propiedades de SaveFileDialog a sus valores predeterminados.Resets all SaveFileDialog properties to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

Se llama a RunDialog(IntPtr) para mostrar un cuadro de diálogo de archivo en una clase derivada, como OpenFileDialog y SaveFileDialog.RunDialog(IntPtr) is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog.

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Muestra un cuadro de diálogo común.Displays a common dialog.

(Inherited from CommonDialog)
ShowDialog(Window) ShowDialog(Window) ShowDialog(Window) ShowDialog(Window)

Muestra un cuadro de diálogo común.Displays a common dialog.

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa un cuadro de diálogo de archivo.Returns a string that represents a file dialog.

(Inherited from FileDialog)

Eventos

FileOk FileOk FileOk 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.Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog.

(Inherited from FileDialog)

Se aplica a

Consulte también: