SaveFileDialog Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una finestra di dialogo comune che consente all'utente di specificare un nome file da salvare come file. SaveFileDialog non può essere usato da un'applicazione in esecuzione con attendibilità parziale.
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
- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato come creare un SaveFileDialog oggetto ed elaborare il risultato.
// 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
Commenti
Non è possibile dichiarare questa classe gestita in XAML.
Costruttori
| Nome | Descrizione |
|---|---|
| SaveFileDialog() |
Inizializza una nuova istanza della classe SaveFileDialog. |
Proprietà
| Nome | Descrizione |
|---|---|
| AddExtension |
Ottiene o imposta un valore che indica se una finestra di dialogo di file aggiunge automaticamente un'estensione a un nome file se l'utente omette un'estensione. (Ereditato da FileDialog) |
| CheckFileExists |
Ottiene o imposta un valore che indica se una finestra di dialogo di file visualizza un avviso se l'utente specifica un nome di file che non esiste. (Ereditato da FileDialog) |
| CheckPathExists |
Ottiene o imposta un valore che specifica se gli avvisi vengono visualizzati se l'utente digita percorsi e nomi di file non validi. (Ereditato da FileDialog) |
| CreatePrompt |
Ottiene o imposta un valore che indica se SaveFileDialog richiede all'utente l'autorizzazione per creare un file se l'utente specifica un file che non esiste. |
| CustomPlaces |
Ottiene o imposta l'elenco di posizioni personalizzate per le finestre di dialogo dei file. (Ereditato da FileDialog) |
| DefaultExt |
Ottiene o imposta un valore che specifica la stringa di estensione predefinita da utilizzare per filtrare l'elenco di file visualizzati. (Ereditato da FileDialog) |
| DereferenceLinks |
Ottiene o imposta un valore che indica se una finestra di dialogo di file restituisce il percorso del file a cui fa riferimento un collegamento o il percorso del file di collegamento (.lnk). (Ereditato da FileDialog) |
| FileName |
Ottiene o imposta una stringa contenente il percorso completo del file selezionato in una finestra di dialogo di file. (Ereditato da FileDialog) |
| FileNames |
Ottiene una matrice che contiene un nome di file per ogni file selezionato. (Ereditato da FileDialog) |
| Filter |
Ottiene o imposta la stringa di filtro che determina i tipi di file visualizzati da OpenFileDialog o SaveFileDialog. (Ereditato da FileDialog) |
| FilterIndex |
Ottiene o imposta l'indice del filtro attualmente selezionato in una finestra di dialogo di file. (Ereditato da FileDialog) |
| InitialDirectory |
Ottiene o imposta la directory iniziale visualizzata da una finestra di dialogo di file. (Ereditato da FileDialog) |
| Options |
Ottiene i flag della finestra di dialogo di file comuni Win32 utilizzati dalle finestre di dialogo di file per l'inizializzazione. (Ereditato da FileDialog) |
| OverwritePrompt |
Ottiene o imposta un valore che indica se SaveFileDialog visualizza un avviso se l'utente specifica il nome di un file già esistente. |
| RestoreDirectory |
Questa proprietà non è implementata. (Ereditato da FileDialog) |
| SafeFileName |
Ottiene una stringa che contiene solo il nome file per il file selezionato. (Ereditato da FileDialog) |
| SafeFileNames |
Ottiene una matrice contenente un nome di file sicuro per ogni file selezionato. (Ereditato da FileDialog) |
| Tag |
Ottiene o imposta un oggetto associato alla finestra di dialogo. In questo modo è possibile associare un oggetto arbitrario al dialogo. (Ereditato da CommonDialog) |
| Title |
Ottiene o imposta il testo visualizzato nella barra del titolo di una finestra di dialogo di file. (Ereditato da FileDialog) |
| ValidateNames |
Ottiene o imposta un valore che indica se la finestra di dialogo accetta solo nomi di file Win32 validi. (Ereditato da FileDialog) |
Metodi
| Nome | Descrizione |
|---|---|
| CheckPermissionsToShowDialog() |
Determina se esistono autorizzazioni sufficienti per la visualizzazione di una finestra di dialogo. (Ereditato da CommonDialog) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definisce la procedura di hook della finestra di dialogo di file comune sottoposta a override per aggiungere funzionalità comuni a una finestra di dialogo di file. (Ereditato da FileDialog) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnFileOk(CancelEventArgs) |
Genera l'evento FileOk. (Ereditato da FileDialog) |
| OpenFile() |
Crea un flusso di file di lettura/scrittura per il nome file selezionato dall'utente usando SaveFileDialog. |
| Reset() |
Reimposta tutti i valori predefiniti di tutte le SaveFileDialog proprietà. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) viene chiamato per visualizzare una finestra di dialogo di file in una classe derivata, ad esempio OpenFileDialog e SaveFileDialog. (Ereditato da FileDialog) |
| ShowDialog() |
Visualizza una finestra di dialogo comune. (Ereditato da CommonDialog) |
| ShowDialog(Window) |
Visualizza una finestra di dialogo comune. (Ereditato da CommonDialog) |
| ToString() |
Restituisce una stringa che rappresenta una finestra di dialogo di file. (Ereditato da FileDialog) |
Eventi
| Nome | Descrizione |
|---|---|
| FileOk |
Si verifica quando l'utente seleziona un nome di file facendo clic sul pulsante Apri del OpenFileDialog o sul pulsante Salva di SaveFileDialog. (Ereditato da FileDialog) |