SaveFileDialog Klasse
Definition
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 auf, einen Speicherort zum Speichern einer Datei auszuwählen. Diese Klasse kann nicht vererbt werden.
public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class SaveFileDialog : System.Windows.Forms.FileDialogtype SaveFileDialog = class
inherit FileDialogPublic NotInheritable Class SaveFileDialog
Inherits FileDialog- Vererbung
Beispiele
Das folgende Codebeispiel veranschaulicht das Erstellen eines , festlegen von SaveFileDialogMembern, Aufrufen des Dialogfelds mithilfe der ShowDialog Methode und Speichern der aktuellen Datei. Für das Beispiel ist ein Formular mit einer darauf platzierten 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
| Name | Beschreibung |
|---|---|
| SaveFileDialog() |
Initialisiert eine neue Instanz dieser Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AddExtension |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld automatisch eine Erweiterung zu einem Dateinamen hinzufügt, wenn der Benutzer die Erweiterung ausgelassen. (Geerbt von FileDialog) |
| AddToRecent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld die Datei hinzufügt, die geöffnet oder in der liste zuletzt gespeichert wird. (Geerbt von FileDialog) |
| AutoUpgradeEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob diese FileDialog Instanz die Darstellung und das Verhalten bei der Ausführung unter Windows Vista automatisch aktualisieren soll. (Geerbt von FileDialog) |
| CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
| CheckFileExists |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen Dateinamen angibt, der nicht vorhanden ist. (Geerbt von FileDialog) |
| CheckPathExists |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen Pfad angibt, der nicht vorhanden ist. (Geerbt von FileDialog) |
| CheckWriteAccess |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld überprüft, ob die Erstellung der angegebenen Datei erfolgreich ist. Wenn dieses Flag nicht festgelegt ist, muss die aufrufende Anwendung Fehler behandeln, z. B. Denial of Access, die beim Erstellen des Elements ermittelt werden. |
| ClientGuid |
Dient zum Abrufen oder Festlegen der GUID, die diesem Dialogfeldstatus zugeordnet werden soll. In der Regel wird der Status wie 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 persistierte Zustände für verschiedene Versionen des Dialogfelds innerhalb derselben Anwendung aufweisen (z. B. ein Importdialogfeld und ein geöffnetes Dialogfeld). Diese Funktionalität ist nicht verfügbar, wenn eine Anwendung keine visuellen Formatvorlagen verwendet oder auf AutoUpgradeEnabled . festgelegt |
| Container |
Ruft die IContainer ab, die den Componententhält. (Geerbt von Component) |
| CreatePrompt |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld den Benutzer zur Berechtigung zum Erstellen einer Datei auffordert, wenn der Benutzer eine Datei angibt, die nicht vorhanden ist. |
| CustomPlaces |
Ruft die Sammlung benutzerdefinierter Orte für diese FileDialog Instanz ab. (Geerbt von FileDialog) |
| DefaultExt |
Dient zum Abrufen oder Festlegen der Standarddateierweiterung. (Geerbt von FileDialog) |
| DereferenceLinks |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld den Speicherort der Datei zurückgibt, auf die durch die Verknüpfung verwiesen wird, oder ob sie den Speicherort der Verknüpfung (.lnk) zurückgibt. (Geerbt von FileDialog) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet. (Geerbt von Component) |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component) |
| ExpandedMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld immer im erweiterten Modus geöffnet wird. |
| FileName |
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den im Dialogfeld "Datei" ausgewählten Dateinamen enthält. (Geerbt von FileDialog) |
| FileNames |
Ruft die Dateinamen aller ausgewählten Dateien im Dialogfeld ab. (Geerbt von FileDialog) |
| Filter |
Dient zum Abrufen oder Festlegen der aktuellen Dateinamenfilterzeichenfolge, die die Optionen bestimmt, die im Feld "Dateityp speichern" oder "Dateityp" im Dialogfeld angezeigt werden. (Geerbt von FileDialog) |
| FilterIndex |
Ruft den Index des filters ab, der derzeit im Dateidialogfeld ausgewählt ist, oder legt den Index fest. (Geerbt von FileDialog) |
| InitialDirectory |
Ruft das anfängliche Verzeichnis 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 |
Dient zum Abrufen oder Festlegen eines Werts, 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 zum Initialisieren der FileDialog. (Geerbt von FileDialog) |
| OverwritePrompt |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im |
| RestoreDirectory |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld das Verzeichnis vor dem Schließen in das zuvor ausgewählte Verzeichnis wiederhergestellt. (Geerbt von FileDialog) |
| ShowHelp |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche "Hilfe " im Dateidialogfeld angezeigt wird. (Geerbt von FileDialog) |
| ShowHiddenFiles |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld ausgeblendete und Systemdateien angezeigt werden. (Geerbt von FileDialog) |
| ShowPinnedPlaces |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die standardmäßig im Navigationsbereich der Ansicht angezeigten Elemente angezeigt werden. (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 das Anzeigen und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt. (Geerbt von FileDialog) |
| Tag |
Dient zum Abrufen oder Festlegen eines Objekts, das Daten zum Steuerelement enthält. (Geerbt von CommonDialog) |
| Title |
Ruft den Titel des Dateidialogfelds ab oder legt den Titel fest. (Geerbt von FileDialog) |
| ValidateNames |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert. (Geerbt von FileDialog) |
Methoden
| Name | Beschreibung |
|---|---|
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Gibt alle vom Componentverwendeten Ressourcen frei. (Geerbt von Component) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetService(Type) |
Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird. (Geerbt von Component) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definiert die allgemeine Dialogfeld-Hook-Prozedur, die überschrieben wird, um dem Dateidialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von FileDialog) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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 Datei mit lese-/schreibberechtigung, die vom Benutzer ausgewählt wurde. |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Definiert die Besitzerfensterprozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von CommonDialog) |
| Reset() |
Setzt alle Dialogfeldoptionen auf ihre Standardwerte zurück. |
| RunDialog(IntPtr) |
Gibt ein allgemeines Dialogfeld an. (Geerbt von FileDialog) |
| ShowDialog() |
Führt ein allgemeines Dialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog) |
| ShowDialog(IWin32Window) |
Führt ein allgemeines Dialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog) |
| ToString() |
Stellt eine Zeichenfolgenversion dieses Objekts bereit. (Geerbt von FileDialog) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() -Methode verworfen wird. (Geerbt von Component) |
| FileOk |
Tritt auf, wenn der Benutzer auf die Schaltfläche " Öffnen " oder " Speichern " in einem Dateidialogfeld klickt. (Geerbt von FileDialog) |
| HelpRequest |
Tritt auf, wenn der Benutzer auf die Schaltfläche "Hilfe" in einem allgemeinen Dialogfeld klickt. (Geerbt von CommonDialog) |
