SaveFileDialog Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje běžné dialogové okno, které uživateli umožňuje zadat název souboru pro uložení souboru jako. SaveFileDialog aplikaci, která se spouští v rámci částečné důvěryhodnosti, nemůže být používána.
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
- Dědičnost
- Dědičnost
Příklady
Následující příklad ukazuje, jak vytvořit SaveFileDialog a zpracovat výsledek.
// 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
Poznámky
Tuto spravovanou třídu nelze deklarovat v jazyce XAML.
Konstruktory
| Name | Description |
|---|---|
| SaveFileDialog() |
Inicializuje novou instanci SaveFileDialog třídy. |
Vlastnosti
| Name | Description |
|---|---|
| AddExtension |
Získá nebo nastaví hodnotu určující, zda dialogové okno souboru automaticky přidá příponu k názvu souboru, pokud uživatel vynechá příponu. (Zděděno od FileDialog) |
| AddToRecent |
Získá nebo nastaví hodnotu určující, zda dialogové okno přidá položku, která je otevřena nebo uložena do seznamu posledních dokumentů. (Zděděno od CommonItemDialog) |
| CheckFileExists |
Získá nebo nastaví hodnotu určující, zda dialogové okno souboru zobrazí upozornění, pokud uživatel určuje název souboru, který neexistuje. (Zděděno od FileDialog) |
| CheckPathExists |
Získá nebo nastaví hodnotu, která určuje, zda se zobrazí upozornění, pokud uživatel zadá neplatné cesty a názvy souborů. (Zděděno od FileDialog) |
| ClientGuid |
Získá nebo nastaví identifikátor GUID pro přidružení k trvalému stavu dialogového okna. (Zděděno od CommonItemDialog) |
| CreatePrompt |
Získá nebo nastaví hodnotu určující, zda SaveFileDialog vyzve uživatele k zadání oprávnění k vytvoření souboru, pokud uživatel určuje soubor, který neexistuje. |
| CreateTestFile |
Získá nebo nastaví hodnotu určující, zda dialogové okno se pokusí vytvořit testovací soubor na vybrané cestě. |
| CustomPlaces |
Získá nebo nastaví seznam vlastních míst pro dialogová okna souboru. (Zděděno od FileDialog) |
| DefaultDirectory |
Získá nebo nastaví adresář zobrazený v dialogovém okně soubor, pokud není k dispozici žádná nedávno použitá hodnota adresáře. (Zděděno od CommonItemDialog) |
| DefaultExt |
Získá nebo nastaví hodnotu, která určuje výchozí rozšiřující řetězec, který se má použít k filtrování seznamu zobrazených souborů. (Zděděno od FileDialog) |
| DereferenceLinks |
Získá nebo nastaví hodnotu určující, zda dialogové okno souboru vrátí buď umístění souboru odkazovaného zástupcem nebo umístěním souboru zástupce (.lnk). (Zděděno od FileDialog) |
| FileName |
Získá nebo nastaví řetězec obsahující úplnou cestu k souboru vybraného v dialogovém okně souboru. (Zděděno od FileDialog) |
| FileNames |
Získá pole, které obsahuje jeden název souboru pro každý vybraný soubor. (Zděděno od FileDialog) |
| Filter |
Získá nebo nastaví řetězec filtru, který určuje, jaké typy souborů jsou zobrazeny z OpenFileDialog nebo SaveFileDialog. (Zděděno od FileDialog) |
| FilterIndex |
Získá nebo nastaví index filtru aktuálně vybraný v dialogovém okně souboru. (Zděděno od FileDialog) |
| InitialDirectory |
Získá nebo nastaví počáteční adresář, který je zobrazen v dialogovém okně souboru. (Zděděno od FileDialog) |
| Options |
Získá Win32 běžné příznaky souboru dialogové okno, které jsou používány soubor dialogy pro inicializaci. (Zděděno od FileDialog) |
| OverwritePrompt |
Získá nebo nastaví hodnotu označující, zda SaveFileDialog se zobrazí upozornění, pokud uživatel určuje název souboru, který již existuje. |
| RestoreDirectory |
Tato vlastnost není implementována. (Zděděno od FileDialog) |
| RootDirectory |
Získá nebo nastaví adresář zobrazený jako kořen navigace pro dialogové okno. (Zděděno od CommonItemDialog) |
| SafeFileName |
Získá řetězec, který obsahuje pouze název souboru pro vybraný soubor. (Zděděno od FileDialog) |
| SafeFileNames |
Získá pole, které obsahuje jeden bezpečný název souboru pro každý vybraný soubor. (Zděděno od FileDialog) |
| ShowHiddenItems |
Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí skryté a systémové položky bez ohledu na uživatelské předvolby. (Zděděno od CommonItemDialog) |
| Tag |
Získá nebo nastaví objekt přidružený k dialogu. To umožňuje připojit k dialogovému okně libovolný objekt. (Zděděno od CommonDialog) |
| Title |
Získá nebo nastaví text, který se zobrazí v záhlaví dialogového okna souboru. (Zděděno od FileDialog) |
| ValidateNames |
Získá nebo nastaví hodnotu určující, zda dialogové okno přijímá pouze platné názvy souborů Win32. (Zděděno od FileDialog) |
Metody
| Name | Description |
|---|---|
| CheckPermissionsToShowDialog() |
Určuje, zda existují dostatečná oprávnění pro zobrazení dialogového okna. (Zděděno od CommonDialog) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definuje proceduru háku běžného dialogového okna souboru, která se přepíše, aby se do dialogového okna souboru přidaly společné funkce. (Zděděno od FileDialog) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnFileOk(CancelEventArgs) |
FileOk Vyvolá událost. (Zděděno od FileDialog) |
| OnItemOk(CancelEventArgs) |
FileOk Vyvolá událost. (Zděděno od FileDialog) |
| OpenFile() |
Vytvoří datový proud souboru pro čtení i zápis pro název souboru vybraný uživatelem pomocí SaveFileDialog. |
| Reset() |
Obnoví všechny SaveFileDialog vlastnosti na výchozí hodnoty. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) je volána k zobrazení dialogového okna souboru v odvozené třídě, například OpenFileDialog a SaveFileDialog. (Zděděno od FileDialog) |
| ShowDialog() |
Zobrazí běžné dialogové okno. (Zděděno od CommonDialog) |
| ShowDialog(Window) |
Zobrazí běžné dialogové okno. (Zděděno od CommonDialog) |
| ToString() |
Vrátí řetězec, který představuje dialogové okno souboru. (Zděděno od FileDialog) |
Událost
| Name | Description |
|---|---|
| FileOk |
Nastane, když uživatel vybere název souboru kliknutím na tlačítko Otevřít nebo OpenFileDialoguložit tlačítko .SaveFileDialog (Zděděno od FileDialog) |