SaveFileDialog Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fordert den Benutzer zur Auswahl eines Speicherorts für eine Datei auf. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen eines SaveFileDialog, festlegen von Membern, das Aufrufen des Dialogfelds mithilfe der ShowDialog -Methode und das Speichern der aktuellen Datei. Für das Beispiel ist ein Formular mit einer Schaltfläche erforderlich.

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

Hinweise

Diese Klasse kann entweder eine vorhandene Datei öffnen und überschreiben oder eine neue Datei erstellen.

Die meisten Funktionen für diese Klasse befinden sich in der FileDialog -Klasse.

Konstruktoren

SaveFileDialog()

Initialisiert eine neue Instanz dieser Klasse.

Eigenschaften

AddExtension	Ruft einen Wert ab, der angibt, ob einem Dateinamen im Dialogfeld automatisch eine Erweiterung hinzugefügt wird, wenn der Benutzer keine Erweiterung angibt, oder legt diesen Wert fest. (Geerbt von FileDialog)
AddToRecent	Ruft einen Wert ab, der angibt, ob das Dialogfeld die datei hinzufügt, die geöffnet oder gespeichert wird, der Zuletzt verwendeten Liste. (Geerbt von FileDialog)
AutoUpgradeEnabled	Ruft einen Wert ab, der angibt, ob dieses FileDialog instance bei der Ausführung unter Windows Vista automatisch das Aussehen und Verhalten aktualisieren soll, oder legt diesen fest. (Geerbt von FileDialog)
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
CheckFileExists	Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer den Namen einer nicht vorhandenen Datei angibt, oder legt diesen fest. (Geerbt von FileDialog)
CheckPathExists	Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen nicht vorhandenen Pfad angibt, oder legt diesen fest. (Geerbt von FileDialog)
CheckWriteAccess	Ruft einen Wert ab, der angibt, ob das Dialogfeld überprüft, ob die Erstellung der angegebenen Datei erfolgreich ist, oder legt den Wert fest. Wenn dieses Flag nicht festgelegt ist, muss die aufrufende Anwendung Fehler behandeln, z. B. Verweigerung des Zugriffs, die beim Erstellen des Elements erkannt werden.
ClientGuid	Ruft die GUID ab, die diesem Dialogfeldzustand zugeordnet werden soll, oder legt sie fest. In der Regel wird der Zustand, z. B. der zuletzt besuchte Ordner und die Position und Größe des Dialogfelds, basierend auf dem Namen der ausführbaren Datei beibehalten. Durch Angeben einer GUID kann eine Anwendung unterschiedliche beibehaltene Zustände für verschiedene Versionen des Dialogfelds innerhalb derselben Anwendung aufweisen (z. B. ein Dialogfeld zum Importieren und ein Dialogfeld zum Öffnen). Diese Funktion ist nicht verfügbar, wenn eine Anwendung keine visuellen Stile verwendet oder wenn AutoUpgradeEnabled auf `false` festgelegt ist. (Geerbt von FileDialog)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
CreatePrompt	Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Berechtigung zum Erstellen einer Datei angefordert wird, wenn der Benutzer eine nicht vorhandene Datei angibt, oder legt diesen fest.
CustomPlaces	Ruft die Auflistung der benutzerdefinierten Speicherorte für diese FileDialog-Instanz ab. (Geerbt von FileDialog)
DefaultExt	Ruft die Standarddateinamenerweiterung ab oder legt diese fest. (Geerbt von FileDialog)
DereferenceLinks	Ruft einen Wert ab, der angibt, ob das Dialogfeld den Speicherort der Datei, auf die die Verknüpfung verweist, oder den Speicherort der Verknüpfung (.lnk) zurückgibt, oder legt diesen Wert fest. (Geerbt von FileDialog)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
ExpandedMode	Ruft einen Wert ab, der angibt, ob das Dialogfeld immer im erweiterten Modus geöffnet ist, oder legt einen Wert fest.
FileName	Ruft eine Zeichenfolge ab, die den im Dateidialogfeld ausgewählten Dateinamen enthält, oder legt diese fest. (Geerbt von FileDialog)
FileNames	Ruft die Dateinamen aller im Dialogfeld ausgewählten Dateien ab. (Geerbt von FileDialog)
Filter	Ruft die aktuelle Filterzeichenfolge für Dateinamen ab, die die im Dialogfeld im Feld „Speichern unter“ oder „Dateityp“ angezeigte Auswahl bestimmt, oder legt diese fest. (Geerbt von FileDialog)
FilterIndex	Ruft den Index des derzeit im Dateidialogfeld ausgewählten Filters ab oder legt diesen Index fest. (Geerbt von FileDialog)
InitialDirectory	Ruft das Ausgangsverzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest. (Geerbt von FileDialog)
Instance	Ruft das Win32-Instanzhandle für die Anwendung ab. (Geerbt von FileDialog)
OkRequiresInteraction	Ruft einen Wert ab, der angibt, ob die Schaltfläche OK des Dialogfelds deaktiviert ist, bis der Benutzer in der Ansicht navigiert oder den Dateinamen bearbeitet (falls zutreffend). (Geerbt von FileDialog)
Options	Ruft Werte für die Initialisierung von FileDialog ab. (Geerbt von FileDialog)
OverwritePrompt	Ruft einen Wert ab, der angibt, ob im Dialogfeld `Save As` eine Warnung angezeigt wird, wenn der Benutzer einen bereits vorhandenen Dateinamen angibt, oder legt diesen fest.
RestoreDirectory	Ruft einen Wert ab oder legt diesen fest, der angibt, ob das Dialogfeld das Verzeichnis im zuvor ausgewählten Verzeichnis vor dem Schließen wiederherstellt. (Geerbt von FileDialog)
ShowHelp	Ruft einen Wert ab, der angibt, ob im Dateidialogfeld die Schaltfläche Hilfe angezeigt wird, oder legt diesen Wert fest. (Geerbt von FileDialog)
ShowHiddenFiles	Ruft einen Wert ab, der angibt, ob im Dialogfeld ausgeblendete Und Systemdateien angezeigt werden, oder legt den Wert fest. (Geerbt von FileDialog)
ShowPinnedPlaces	Ruft einen Wert ab, der angibt, ob die standardmäßig im Navigationsbereich der Ansicht angezeigten Elemente angezeigt werden, oder legt einen Wert fest. (Geerbt von FileDialog)
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
SupportMultiDottedExtensions	Ruft ab oder legt fest, ob das Dialogfeld Anzeige und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt. (Geerbt von FileDialog)
Tag	Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Geerbt von CommonDialog)
Title	Ruft den Titel des Dateidialogfelds ab oder legt diesen fest. (Geerbt von FileDialog)
ValidateNames	Ruft einen Wert ab, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert, oder legt diesen fest. (Geerbt von FileDialog)

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um dem Dateidialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von FileDialog)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnFileOk(CancelEventArgs)	Löst das FileOk-Ereignis aus. (Geerbt von FileDialog)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OpenFile()	Öffnet die vom Benutzer ausgewählte Datei mit Lese-/Schreibberechtigung.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Optionen im Dialogfeld auf die Standardwerte zurück.
RunDialog(IntPtr)	Gibt ein Standarddialogfeld an. (Geerbt von FileDialog)
ShowDialog()	Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)
ToString()	Stellt eine Zeichenfolgenversion dieses Objekts bereit. (Geerbt von FileDialog)

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
FileOk	Tritt ein, wenn der Benutzer in einem Dateidialogfeld auf die Schaltfläche Öffnen oder Speichern klickt. (Geerbt von FileDialog)
HelpRequest	Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Geerbt von CommonDialog)

Gilt für:

Freigeben über