SaveFileDialog Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Richiede all'utente la selezione di una cartella per il salvataggio di un file. La classe non può essere ereditata.

public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class SaveFileDialog : System.Windows.Forms.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

Ereditarietà: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Esempio

L'esempio di codice seguente illustra la creazione di membri SaveFileDialog, impostando membri, chiamando la finestra di dialogo usando il ShowDialog metodo e salvando il file corrente. L'esempio richiede un modulo con un pulsante posizionato su di esso.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
      saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      saveFileDialog1->FilterIndex = 2;
      saveFileDialog1->RestoreDirectory = true;
      if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
      {
         if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
         {
            
            // Code to write the stream goes here.
            myStream->Close();
         }
      }
   }

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

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    Dim saveFileDialog1 As New SaveFileDialog()
    
    saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    saveFileDialog1.FilterIndex = 2
    saveFileDialog1.RestoreDirectory = True
    
    If saveFileDialog1.ShowDialog() = DialogResult.OK Then
        myStream = saveFileDialog1.OpenFile()
        If (myStream IsNot Nothing) Then
            ' Code to write the stream goes here.
            myStream.Close()
        End If
    End If
End Sub

Commenti

Questa classe può aprire e sovrascrivere un file esistente o creare un nuovo file.

La maggior parte delle funzionalità per questa classe è disponibile nella FileDialog classe.

Costruttori

SaveFileDialog()

Inizializza una nuova istanza della classe.

Proprietà

AddExtension	Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge automaticamente un'estensione a un nome di file quando l'utente non la specifica. (Ereditato da FileDialog)
AddToRecent	Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge il file aperto o salvato nell'elenco recente. (Ereditato da FileDialog)
AutoUpgradeEnabled	Ottiene o imposta un valore che indica se questa istanza deve aggiornare automaticamente l'aspetto e il FileDialog comportamento durante l'esecuzione in Windows Vista. (Ereditato da FileDialog)
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CheckFileExists	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso quando l'utente specifica un nome di file inesistente. (Ereditato da FileDialog)
CheckPathExists	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso quando l'utente specifica un percorso inesistente. (Ereditato da FileDialog)
CheckWriteAccess	Ottiene o imposta un valore che indica se la finestra di dialogo verifica se la creazione del file specificato avrà esito positivo. Se questo flag non è impostato, l'applicazione chiamante deve gestire errori, ad esempio negazione dell'accesso, individuati al momento della creazione dell'elemento.
ClientGuid	Ottiene o imposta il GUID da associare allo stato della finestra di dialogo. In genere, gli stati come l'ultima cartella visitata e la posizione e le dimensioni della finestra di dialogo vengono mantenuti in base al nome del file eseguibile. Specificando un GUID, un'applicazione può avere stati permanenti diversi per versioni diverse della finestra di dialogo all'interno della stessa applicazione, ad esempio una finestra di dialogo di importazione e una finestra di dialogo aperta. Questa funzionalità non è disponibile se un'applicazione non usa stili visivi o se AutoUpgradeEnabled è impostato su `false`. (Ereditato da FileDialog)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
CreatePrompt	Ottiene o imposta un valore che indica se la finestra di dialogo richiede all'utente l'autorizzazione di creare un file, qualora fosse stato specificato un file inesistente.
CustomPlaces	Ottiene l’insieme delle posizioni personalizzate per questa istanza di FileDialog. (Ereditato da FileDialog)
DefaultExt	Ottiene o imposta l'estensione di file predefinita. (Ereditato da FileDialog)
DereferenceLinks	Ottiene o imposta un valore che indica se la finestra di dialogo restituisce il percorso del file cui fa riferimento il collegamento o se restituisce la posizione del collegamento (LNK). (Ereditato da FileDialog)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ExpandedMode	Ottiene o imposta un valore che indica se la finestra di dialogo viene sempre aperta nella modalità espansa.
FileName	Ottiene o imposta una stringa che contiene il nome del file selezionato nella finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
FileNames	Ottiene i nomi di tutti i file selezionati nella finestra di dialogo. (Ereditato da FileDialog)
Filter	Ottiene o imposta la stringa filtro del nome file corrente, che determina le scelte visualizzate nelle casella relative al tipo di file nella finestra di dialogo. (Ereditato da FileDialog)
FilterIndex	Ottiene o imposta l'indice del filtro attualmente selezionato nella finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
InitialDirectory	Ottiene o imposta la directory iniziale visualizzata dalla finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
Instance	Ottiene il punto di controllo dell'istanza Win32 per l'applicazione. (Ereditato da FileDialog)
OkRequiresInteraction	Ottiene o imposta un valore che indica se il pulsante OK della finestra di dialogo è disabilitato fino a quando l'utente sposta la visualizzazione o modifica il nome file (se applicabile). (Ereditato da FileDialog)
Options	Ottiene i valori per l'inizializzazione dell'oggetto FileDialog. (Ereditato da FileDialog)
OverwritePrompt	Ottiene o imposta un valore che indica se nella finestra di dialogo `Save As` viene visualizzato un avviso quando l'utente specifica un nome di file esistente.
RestoreDirectory	Ottiene o imposta un valore che indica se la finestra di dialogo ripristina la directory precedentemente selezionata prima della chiusura. (Ereditato da FileDialog)
ShowHelp	Ottiene o imposta un valore che indica se nella finestra di dialogo per la gestione dei file viene visualizzato il pulsante ?. (Ereditato da FileDialog)
ShowHiddenFiles	Ottiene o imposta un valore che indica se la finestra di dialogo visualizza file nascosti e di sistema. (Ereditato da FileDialog)
ShowPinnedPlaces	Ottiene o imposta un valore che indica se gli elementi visualizzati per impostazione predefinita nel riquadro di spostamento della vista vengono visualizzati. (Ereditato da FileDialog)
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
SupportMultiDottedExtensions	Ottiene o imposta un valore che indica se la finestra di dialogo supporta la visualizzazione e il salvataggio di file con più estensioni. (Ereditato da FileDialog)
Tag	Ottiene o imposta un oggetto che contiene i dati relativi al controllo. (Ereditato da CommonDialog)
Title	Ottiene o imposta il titolo della finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
ValidateNames	Ottiene o imposta un valore che indica se la finestra di dialogo accetta soltanto nomi file Win32 validi. (Ereditato da FileDialog)

Metodi

CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine di hook della finestra di dialogo comune di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnFileOk(CancelEventArgs)	Genera l'evento FileOk. (Ereditato da FileDialog)
OnHelpRequest(EventArgs)	Genera l'evento HelpRequest. (Ereditato da CommonDialog)
OpenFile()	Apre il file con autorizzazione di lettura/scrittura selezionato dall'utente.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra proprietaria di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutte le opzioni della finestra di dialogo sui relativi valori predefiniti.
RunDialog(IntPtr)	Specifica una finestra di dialogo comune. (Ereditato da FileDialog)
ShowDialog()	Esegue una finestra di dialogo comune con un proprietario predefinito. (Ereditato da CommonDialog)
ShowDialog(IWin32Window)	Esegue una finestra di dialogo comune con il proprietario specificato. (Ereditato da CommonDialog)
ToString()	Fornisce una versione in formato stringa dell'oggetto. (Ereditato da FileDialog)

Eventi

Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
FileOk	Si verifica quando l'utente fa clic sul pulsante Apri o Salva in una finestra di dialogo per la gestione dei file. (Ereditato da FileDialog)
HelpRequest	Si verifica quando l'utente fa clic sul pulsante della Guida in una finestra di dialogo comune. (Ereditato da CommonDialog)

Si applica a

Condividi tramite