SaveFileDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vyzve uživatele k výběru 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 ukazuje 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

SaveFileDialog()

Inicializuje novou instanci této třídy.

Vlastnosti

AddExtension	Získá nebo nastaví hodnotu označ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 označ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)
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
CheckFileExists	Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí upozornění, pokud uživatel zadá název souboru, který neexistuje. (Zděděno od FileDialog)
CheckPathExists	Získá nebo nastaví hodnotu označ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 označ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í zpracovat 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. Stav, jako je například naposledy navštívená složka, a umístění a velikost dialogového okna jsou obvykle trvalé 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 v rámci stejné aplikace (například dialogové okno importu a otevřené dialogové okno). Tato funkce není dostupná, pokud aplikace nepoužívá vizuální styly nebo pokud AutoUpgradeEnabled je nastavená na falsehodnotu . (Zděděno od FileDialog)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
CreatePrompt	Získá nebo nastaví hodnotu označ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í místa kolekce 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, na který odkazuje zástupce, nebo zda vrátí umístění zástupce (.lnk). (Zděděno od FileDialog)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
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ého 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í název souboru řetězec filtru, který určuje volby, které se zobrazí v "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ého v dialogovém okně souboru. (Zděděno od FileDialog)
InitialDirectory	Získá nebo nastaví počáteční adresář zobrazený soubor dialogové okno. (Zděděno od FileDialog)
Instance	Získá popisovač instance Win32 pro aplikaci. (Zděděno od FileDialog)
OkRequiresInteraction	Získá nebo nastaví hodnotu označující, zda je tlačítko OK dialogového okna zakázáno, dokud uživatel nepřejde v 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 označující, zda Save As dialogové okno zobrazí upozornění, pokud uživatel zadá název souboru, který již existuje.
RestoreDirectory	Získá nebo nastaví hodnotu označující, zda dialogové okno obnoví adresář dříve vybraný adresář před uzavřením. (Zděděno od FileDialog)
ShowHelp	Získá nebo nastaví hodnotu označující, zda je tlačítko Nápověda zobrazena v dialogovém okně souboru. (Zděděno od FileDialog)
ShowHiddenFiles	Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí skryté a systémové soubory. (Zděděno od FileDialog)
ShowPinnedPlaces	Získá nebo nastaví hodnotu označující, zda jsou zobrazeny položky zobrazené ve výchozím nastavení v navigačním podokně zobrazení. (Zděděno od FileDialog)
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
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 označující, zda dialogové okno přijímá pouze platné názvy souborů Win32. (Zděděno od FileDialog)

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component nástrojem a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje společnou proceduru pro připojení dialogového okna, která se přepíše, aby se do dialogového okna souboru přidaly konkrétní funkce. (Zděděno od FileDialog)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
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 pro čtení a zápis vybrané 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 běžného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví výchozí hodnoty všech možností dialogového okna.
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

Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)
FileOk	Nastane, když uživatel klikne na tlačítko Otevřít nebo Uložit v dialogovém okně souboru. (Zděděno od FileDialog)
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda ve společném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• FileDialog
• CommonDialog