SaveFileDialog Classe

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 di selezionare un percorso 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

Nell'esempio di codice seguente viene illustrata la creazione di un SaveFileDialogoggetto , l'impostazione dei membri, la chiamata alla finestra di dialogo usando il ShowDialog metodo e il salvataggio del 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

Nome	Descrizione
SaveFileDialog()	Inizializza una nuova istanza di questa classe.

Proprietà

Nome	Descrizione
AddExtension	Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge automaticamente un'estensione a un nome file se l'utente omette l'estensione. (Ereditato da FileDialog)
AutoUpgradeEnabled	Ottiene o imposta un valore che indica se questa FileDialog istanza deve aggiornare automaticamente l'aspetto e il 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 se l'utente specifica un nome di file che non esiste. (Ereditato da FileDialog)
CheckPathExists	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso se l'utente specifica un percorso che non esiste. (Ereditato da FileDialog)
Container	Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component)
CreatePrompt	Ottiene o imposta un valore che indica se la finestra di dialogo richiede all'utente l'autorizzazione per creare un file se l'utente specifica un file che non esiste.
CustomPlaces	Ottiene la raccolta di posizioni personalizzate per questa FileDialog istanza. (Ereditato da FileDialog)
DefaultExt	Ottiene o imposta l'estensione del nome file predefinita. (Ereditato da FileDialog)
DereferenceLinks	Ottiene o imposta un valore che indica se la finestra di dialogo restituisce il percorso del file a cui fa riferimento il collegamento o se restituisce il percorso del collegamento (.lnk). (Ereditato da FileDialog)
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
FileName	Ottiene o imposta una stringa contenente il nome file selezionato nella finestra di dialogo file. (Ereditato da FileDialog)
FileNames	Ottiene i nomi di file di tutti i file selezionati nella finestra di dialogo. (Ereditato da FileDialog)
Filter	Ottiene o imposta la stringa di filtro del nome file corrente, che determina le scelte visualizzate nella casella "Salva come file di tipo" o "File di tipo" nella finestra di dialogo. (Ereditato da FileDialog)
FilterIndex	Ottiene o imposta l'indice del filtro attualmente selezionato nella finestra di dialogo file. (Ereditato da FileDialog)
InitialDirectory	Ottiene o imposta la directory iniziale visualizzata dalla finestra di dialogo file. (Ereditato da FileDialog)
Instance	Ottiene l'handle dell'istanza Win32 per l'applicazione. (Ereditato da FileDialog)
Options	Ottiene i valori per inizializzare l'oggetto FileDialog. (Ereditato da FileDialog)
OverwritePrompt	Ottiene o imposta un valore che indica se nella `Save As` finestra di dialogo viene visualizzato un avviso se l'utente specifica un nome di file già esistente.
RestoreDirectory	Ottiene o imposta un valore che indica se la finestra di dialogo ripristina la directory nella directory selezionata in precedenza prima della chiusura. (Ereditato da FileDialog)
ShowHelp	Ottiene o imposta un valore che indica se il pulsante ? viene visualizzato nella finestra di dialogo file. (Ereditato da FileDialog)
Site	Ottiene o imposta il ISite del 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 di file. (Ereditato da FileDialog)
Tag	Ottiene o imposta un oggetto che contiene dati sul controllo. (Ereditato da CommonDialog)
Title	Ottiene o imposta il titolo della finestra di dialogo del 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
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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, rilascia 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()	Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine hook della finestra di dialogo comune sottoposta a override per aggiungere funzionalità specifiche alla finestra di dialogo file. (Ereditato da FileDialog)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (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 selezionata dall'utente.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra di proprietario sottoposta a override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutti i valori predefiniti di tutte le opzioni della finestra di dialogo.
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 stringa di questo oggetto. (Ereditato da FileDialog)

Eventi

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

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?