SaveFileDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

SaveFileDialog.cs

Vyzve uživatele, aby vybral umístění pro uložení souboru. Tato třída se nemůže dědit.

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

Dědičnost

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

SaveFileDialog

Příklady

Následující příklad kódu znázorňuje vytvoření SaveFileDialog, nastavení členů, volání dialogového okna pomocí ShowDialog metody a uložení aktuálního souboru. Příklad vyžaduje formulář s tlačítkem umístěným na něm.

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

Poznámky

Tato třída může buď otevřít a přepsat existující soubor, nebo vytvořit nový soubor.

Většina funkcí pro tuto třídu se nachází ve FileDialog třídě.

Konstruktory

Name	Description
SaveFileDialog()	Inicializuje novou instanci této třídy.

Vlastnosti

Name	Description
AddExtension	Získá nebo nastaví hodnotu určující, zda dialogové okno 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á soubor, který je otevřen nebo uložen do posledního seznamu. (Zděděno od FileDialog)
AutoUpgradeEnabled	Získá nebo nastaví hodnotu určující, zda tato FileDialog instance má automaticky upgradovat vzhled a chování při spuštění v systému Windows Vista. (Zděděno od FileDialog)
CheckFileExists	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí upozornění, pokud uživatel určuje název souboru, který neexistuje. (Zděděno od FileDialog)
CheckPathExists	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí upozornění, pokud uživatel určuje cestu, která neexistuje. (Zděděno od FileDialog)
CheckWriteAccess	Získá nebo nastaví hodnotu určující, zda dialogové okno ověří, zda vytvoření zadaného souboru bude úspěšné. Pokud tento příznak není nastavený, volající aplikace musí zpracovávat chyby, jako je odepření přístupu, které se zjistí při vytvoření položky.
ClientGuid	Získá nebo nastaví identifikátor GUID pro přidružení k tomuto stavu dialogového okna. Obvykle se stav, jako je naposledy navštívená složka a umístění a velikost dialogového okna, zachovají na základě názvu spustitelného souboru. Zadáním identifikátoru GUID může mít aplikace různé trvalé stavy pro různé verze dialogového okna ve stejné aplikaci (například dialogové okno importu a otevřené dialogové okno). Tato funkce není k dispozici, pokud aplikace nepoužívá vizuální styly nebo je AutoUpgradeEnabled nastavena na false. (Zděděno od FileDialog)
CreatePrompt	Získá nebo nastaví hodnotu určující, zda dialogové okno vyzve uživatele k oprávnění k vytvoření souboru, pokud uživatel určuje soubor, který neexistuje.
CustomPlaces	Získá vlastní kolekce míst pro tuto FileDialog instanci. (Zděděno od FileDialog)
DefaultExt	Získá nebo nastaví výchozí příponu názvu souboru. (Zděděno od FileDialog)
DereferenceLinks	Získá nebo nastaví hodnotu určující, zda dialogové okno vrátí umístění souboru odkazovaného zástupcem nebo zda vrací umístění zástupce (.lnk). (Zděděno od FileDialog)
ExpandedMode	Získá nebo nastaví hodnotu označující, zda je dialogové okno vždy otevřeno v rozšířeném režimu.
FileName	Získá nebo nastaví řetězec obsahující název souboru vybraný v dialogovém okně soubor. (Zděděno od FileDialog)
FileNames	Získá názvy souborů všech vybraných souborů v dialogovém okně. (Zděděno od FileDialog)
Filter	Získá nebo nastaví aktuální řetězec filtru názvu souboru, který určuje volby, které se zobrazí v poli "Uložit jako typ souboru" nebo "Soubory typu" v dialogovém okně. (Zděděno od FileDialog)
FilterIndex	Získá nebo nastaví index filtru aktuálně vybraný v dialogovém okně soubor. (Zděděno od FileDialog)
InitialDirectory	Získá nebo nastaví počáteční adresář zobrazený v dialogovém okně soubor. (Zděděno od FileDialog)
Instance	Získá popisovač instance Win32 pro aplikaci. (Zděděno od FileDialog)
OkRequiresInteraction	Získá nebo nastaví hodnotu určující, zda je tlačítko OK dialogového okna zakázáno, dokud uživatel nepřejde do zobrazení nebo upraví název souboru (pokud je k dispozici). (Zděděno od FileDialog)
Options	Získá hodnoty pro inicializaci FileDialog. (Zděděno od FileDialog)
OverwritePrompt	Získá nebo nastaví hodnotu určující, zda Save As dialogové okno zobrazí upozornění, pokud uživatel určuje název souboru, který již existuje.
RestoreDirectory	Získá nebo nastaví hodnotu určující, zda dialogové okno obnoví adresář do dříve vybraného adresáře před zavřením. (Zděděno od FileDialog)
ShowHelp	Získá nebo nastaví hodnotu určující, zda je tlačítko Nápověda zobrazena v dialogovém okně soubor. (Zděděno od FileDialog)
ShowHiddenFiles	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazuje skryté a systémové soubory. (Zděděno od FileDialog)
ShowPinnedPlaces	Získá nebo nastaví hodnotu určující, zda položky zobrazené ve výchozím nastavení v navigačním podokně zobrazení jsou zobrazeny. (Zděděno od FileDialog)
SupportMultiDottedExtensions	Získá nebo nastaví, zda dialogové okno podporuje zobrazení a ukládání souborů, které mají více přípon názvů souborů. (Zděděno od FileDialog)
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku. (Zděděno od CommonDialog)
Title	Získá nebo nastaví název 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
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje běžnou proceduru háku dialogového okna, která se přepíše, aby do dialogového okna soubor přidala konkrétní funkce. (Zděděno od FileDialog)
OnFileOk(CancelEventArgs)	FileOk Vyvolá událost. (Zděděno od FileDialog)
OnHelpRequest(EventArgs)	HelpRequest Vyvolá událost. (Zděděno od CommonDialog)
OpenFile()	Otevře soubor s oprávněním ke čtení a zápisu vybranému uživatelem.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru okna vlastníka, která je přepsána pro přidání konkrétní funkce do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví všechny možnosti dialogového okna na výchozí hodnoty.
RunDialog(IntPtr)	Určuje společné dialogové okno. (Zděděno od FileDialog)
ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem. (Zděděno od CommonDialog)
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem. (Zděděno od CommonDialog)
ToString()	Poskytuje řetězcovou verzi tohoto objektu. (Zděděno od FileDialog)

Událost

Name	Description
FileOk	Nastane, když uživatel klikne na tlačítko Otevřít nebo Uložit v dialogovém okně soubor. (Zděděno od FileDialog)
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda v běžném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• FileDialog
• CommonDialog