SaveFileDialog Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

SaveFileDialog.cs

Kéri a felhasználót, hogy válasszon ki egy helyet a fájl mentéséhez. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

SaveFileDialog

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre tagokat SaveFileDialog, meghívhatja a párbeszédpanelt a ShowDialog metódussal, és menti az aktuális fájlt. A példához egy olyan űrlapra van szükség, amelyen egy gomb van elhelyezve.

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

Megjegyzések

Ez az osztály megnyithat és felülírhat egy meglévő fájlt, vagy létrehozhat egy új fájlt.

Az osztály legtöbb funkciója az FileDialog osztályban található.

Konstruktorok

Name	Description
SaveFileDialog()	Inicializálja az osztály új példányát.

Tulajdonságok

Name	Description
AddExtension	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel automatikusan hozzáad-e bővítményt egy fájlnévhez, ha a felhasználó kihagyja a bővítményt. (Öröklődés forrása FileDialog)
AddToRecent	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel hozzáadja-e a megnyitott vagy mentett fájlt a legutóbbi listához. (Öröklődés forrása FileDialog)
AutoUpgradeEnabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy ennek a FileDialog példánynak automatikusan frissítenie kell-e a megjelenést és a viselkedést Windows Vista futtatásakor. (Öröklődés forrása FileDialog)
CheckFileExists	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel figyelmeztetést jelenít-e meg, ha a felhasználó nem létező fájlnevet ad meg. (Öröklődés forrása FileDialog)
CheckPathExists	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel figyelmeztetést jelenít-e meg, ha a felhasználó olyan elérési utat ad meg, amely nem létezik. (Öröklődés forrása FileDialog)
CheckWriteAccess	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel ellenőrzi, hogy a megadott fájl létrehozása sikeres lesz-e. Ha ez a jelző nincs beállítva, a hívó alkalmazásnak kezelnie kell az elem létrehozásakor felfedezett hibákat, például a hozzáférés megtagadását.
ClientGuid	Lekéri vagy beállítja a GUID azonosítót a párbeszédpanel állapotához való társításhoz. A rendszer általában a végrehajtható fájl neve alapján megőrzi az állapotot, például az utoljára meglátogatott mappát, valamint a párbeszédpanel helyét és méretét. A GUID megadásával az alkalmazások különböző tartós állapotokkal rendelkezhetnek a párbeszédpanel különböző verzióihoz ugyanazon az alkalmazásban (például egy importálási párbeszédpanelen és egy megnyitott párbeszédpanelen). Ez a funkció nem érhető el, ha egy alkalmazás nem használ vizuális stílusokat, vagy ha AutoUpgradeEnabled be van állítva false. (Öröklődés forrása FileDialog)
CreatePrompt	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel engedélyt kér-e a felhasználótól egy fájl létrehozására, ha a felhasználó olyan fájlt ad meg, amely nem létezik.
CustomPlaces	Lekéri a példányhoz tartozó egyéni helyek gyűjteményét FileDialog . (Öröklődés forrása FileDialog)
DefaultExt	Lekéri vagy beállítja az alapértelmezett fájlnévkiterjesztést. (Öröklődés forrása FileDialog)
DereferenceLinks	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel visszaadja-e a parancsikon által hivatkozott fájl helyét, vagy a parancsikon helyét adja vissza (.lnk). (Öröklődés forrása FileDialog)
ExpandedMode	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel mindig kibontott módban van-e megnyitva.
FileName	Lekéri vagy beállítja a fájl párbeszédpanelen kijelölt fájlnevet tartalmazó sztringet. (Öröklődés forrása FileDialog)
FileNames	Lekéri az összes kijelölt fájl nevét a párbeszédpanelen. (Öröklődés forrása FileDialog)
Filter	Lekéri vagy beállítja az aktuális fájlnévszűrő sztringet, amely meghatározza a párbeszédpanelEn a "Mentés fájltípusként" vagy a "Fájltípus" mezőben megjelenő lehetőségeket. (Öröklődés forrása FileDialog)
FilterIndex	Lekéri vagy beállítja a fájl párbeszédpanelen jelenleg kijelölt szűrő indexét. (Öröklődés forrása FileDialog)
InitialDirectory	Lekéri vagy beállítja a fájl párbeszédpanelen megjelenő kezdeti könyvtárat. (Öröklődés forrása FileDialog)
Instance	Lekéri az alkalmazás Win32-példányának leírót. (Öröklődés forrása FileDialog)
OkRequiresInteraction	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel OK gombja le van-e tiltva, amíg a felhasználó meg nem navigál a nézeten, vagy nem módosítja a fájlnevet (ha van). (Öröklődés forrása FileDialog)
Options	Lekéri az értékeket a FileDialog. (Öröklődés forrása FileDialog)
OverwritePrompt	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Save As párbeszédpanel figyelmeztetést jelenít-e meg, ha a felhasználó megad egy már létező fájlnevet.
RestoreDirectory	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel a bezárás előtt visszaállítja-e a könyvtárat a korábban kijelölt könyvtárba. (Öröklődés forrása FileDialog)
ShowHelp	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Súgó gomb megjelenik-e a fájl párbeszédpanelen. (Öröklődés forrása FileDialog)
ShowHiddenFiles	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel megjeleníti-e a rejtett és a rendszerfájlokat. (Öröklődés forrása FileDialog)
ShowPinnedPlaces	Beolvas vagy beállít egy értéket, amely jelzi, hogy a nézet navigációs ablaktábláján alapértelmezés szerint megjelenített elemek megjelennek-e. (Öröklődés forrása FileDialog)
SupportMultiDottedExtensions	Lekérdezi vagy beállítja, hogy a párbeszédpanel támogatja-e a több fájlnévkiterjesztéssel rendelkező fájlok megjelenítését és mentését. (Öröklődés forrása FileDialog)
Tag	Lekéri vagy beállít egy objektumot, amely adatokat tartalmaz a vezérlőről. (Öröklődés forrása CommonDialog)
Title	Lekéri vagy beállítja a fájl párbeszédpaneljének címét. (Öröklődés forrása FileDialog)
ValidateNames	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel csak érvényes Win32-fájlneveket fogad-e el. (Öröklődés forrása FileDialog)

Metódusok

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza a párbeszédpanelek gyakori horog eljárását, amelyet felül kell bírálni, hogy adott funkciókat adjon hozzá a fájl párbeszédpaneljéhez. (Öröklődés forrása FileDialog)
OnFileOk(CancelEventArgs)	Az eseményt emeli FileOk ki. (Öröklődés forrása FileDialog)
OnHelpRequest(EventArgs)	Az eseményt emeli HelpRequest ki. (Öröklődés forrása CommonDialog)
OpenFile()	Megnyitja a fájlt a felhasználó által kijelölt olvasási/írási engedéllyel.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza azt a tulajdonosi ablak eljárást, amelyet felül kell bírálni, hogy adott funkciókat adjon hozzá egy közös párbeszédpanelhez. (Öröklődés forrása CommonDialog)
Reset()	Alaphelyzetbe állítja az összes párbeszédpanel-beállítást az alapértelmezett értékükre.
RunDialog(IntPtr)	Egy közös párbeszédpanelt ad meg. (Öröklődés forrása FileDialog)
ShowDialog()	Egy általános párbeszédpanelt futtat egy alapértelmezett tulajdonossal. (Öröklődés forrása CommonDialog)
ShowDialog(IWin32Window)	Futtat egy közös párbeszédpanelt a megadott tulajdonossal. (Öröklődés forrása CommonDialog)
ToString()	Az objektum sztringverzióját biztosítja. (Öröklődés forrása FileDialog)

esemény

Name	Description
FileOk	Akkor fordul elő, ha a felhasználó a Fájl párbeszédpanel Megnyitás vagy Mentés gombjára kattint. (Öröklődés forrása FileDialog)
HelpRequest	Ez akkor fordul elő, ha a felhasználó a Súgó gombra kattint egy közös párbeszédpanelen. (Öröklődés forrása CommonDialog)

Lásd még

• FileDialog
• CommonDialog