Sdílet prostřednictvím


SaveFileDialog Třída

Definice

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

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()
Zastaralé.

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()
Zastaralé.

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)

Platí pro

Viz také