SaveFileDialog Klass

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Källa:: SaveFileDialog.cs

Källa:: SaveFileDialog.cs

Källa:: SaveFileDialog.cs

Källa:: SaveFileDialog.cs

Källa:: SaveFileDialog.cs

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Uppmanar användaren att välja en plats för att spara en fil. Det går inte att ärva den här klassen.

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

Arv: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Exempel

I följande kodexempel visas hur du skapar en SaveFileDialog, anger medlemmar, anropar dialogrutan med hjälp av ShowDialog metoden och sparar den aktuella filen. Exemplet kräver ett formulär med en knapp placerad på det.

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

Kommentarer

Den här klassen kan antingen öppna och skriva över en befintlig fil eller skapa en ny fil.

De flesta av funktionerna för den här klassen finns i FileDialog klassen.

Konstruktorer

Name	Description
SaveFileDialog()	Initierar en ny instans av den här klassen.

Egenskaper

Name	Description
AddExtension	Hämtar eller anger ett värde som anger om dialogrutan automatiskt lägger till ett tillägg till ett filnamn om användaren utelämnar tillägget. (Ärvd från FileDialog)
AddToRecent	Hämtar eller anger ett värde som anger om dialogrutan lägger till filen som öppnas eller sparas i den senaste listan. (Ärvd från FileDialog)
AutoUpgradeEnabled	Hämtar eller anger ett värde som anger om den här FileDialog-instansen automatiskt ska uppgradera utseende och beteende när den körs på Windows Vista. (Ärvd från FileDialog)
CanRaiseEvents	Hämtar ett värde som anger om komponenten kan generera en händelse. (Ärvd från Component)
CheckFileExists	Hämtar eller anger ett värde som anger om dialogrutan visar en varning om användaren anger ett filnamn som inte finns. (Ärvd från FileDialog)
CheckPathExists	Hämtar eller anger ett värde som anger om dialogrutan visar en varning om användaren anger en sökväg som inte finns. (Ärvd från FileDialog)
CheckWriteAccess	Hämtar eller anger ett värde som anger om dialogrutan verifierar om det går att skapa den angivna filen. Om den här flaggan inte har angetts måste det anropande programmet hantera fel, till exempel nekad åtkomst, som identifieras när objektet skapas.
ClientGuid	Hämtar eller anger GUID som ska associeras med det här dialogtillståndet. Vanligtvis sparas tillstånd som den senast besökta mappen och dialogrutans position och storlek baserat på namnet på den körbara filen. Genom att ange ett GUID kan ett program ha olika bevarade tillstånd för olika versioner av dialogrutan i samma program (till exempel en importdialogruta och en öppen dialogruta). Den här funktionen är inte tillgänglig om ett program inte använder visuella format eller om AutoUpgradeEnabled är inställt på `false`. (Ärvd från FileDialog)
Container	Hämtar som IContainer innehåller Component. (Ärvd från Component)
CreatePrompt	Hämtar eller anger ett värde som anger om dialogrutan ber användaren om behörighet att skapa en fil om användaren anger en fil som inte finns.
CustomPlaces	Hämtar samlingen anpassade platser för den här FileDialog instansen. (Ärvd från FileDialog)
DefaultExt	Hämtar eller anger standardfilnamnstillägget. (Ärvd från FileDialog)
DereferenceLinks	Hämtar eller anger ett värde som anger om dialogrutan returnerar platsen för filen som refereras av genvägen eller om den returnerar platsen för genvägen (.lnk). (Ärvd från FileDialog)
DesignMode	Hämtar ett värde som anger om det Component för närvarande är i designläge. (Ärvd från Component)
Events	Hämtar listan över händelsehanterare som är kopplade till den här Component. (Ärvd från Component)
ExpandedMode	Hämtar eller anger ett värde som anger om dialogrutan alltid öppnas i expanderat läge.
FileName	Hämtar eller anger en sträng som innehåller filnamnet som valts i fildialogrutan. (Ärvd från FileDialog)
FileNames	Hämtar filnamnen för alla markerade filer i dialogrutan. (Ärvd från FileDialog)
Filter	Hämtar eller anger den aktuella filtersträngen för filnamn, som avgör vilka alternativ som visas i rutan "Spara som filtyp" eller "Filer av typen" i dialogrutan. (Ärvd från FileDialog)
FilterIndex	Hämtar eller anger indexet för det filter som för närvarande är markerat i fildialogrutan. (Ärvd från FileDialog)
InitialDirectory	Hämtar eller anger den första katalogen som visas i dialogrutan fil. (Ärvd från FileDialog)
Instance	Hämtar Win32-instanshandtaget för programmet. (Ärvd från FileDialog)
OkRequiresInteraction	Hämtar eller anger ett värde som anger om ok-knappen i dialogrutan är inaktiverad tills användaren navigerar i vyn eller redigerar filnamnet (om tillämpligt). (Ärvd från FileDialog)
Options	Hämtar värden för att initiera FileDialog. (Ärvd från FileDialog)
OverwritePrompt	Hämtar eller anger ett värde som anger om `Save As` dialogrutan visar en varning om användaren anger ett filnamn som redan finns.
RestoreDirectory	Hämtar eller anger ett värde som anger om dialogrutan återställer katalogen till den tidigare valda katalogen innan den stängs. (Ärvd från FileDialog)
ShowHelp	Hämtar eller anger ett värde som anger om hjälpknappen visas i fildialogrutan. (Ärvd från FileDialog)
ShowHiddenFiles	Hämtar eller anger ett värde som anger om dialogrutan visar dolda filer och systemfiler. (Ärvd från FileDialog)
ShowPinnedPlaces	Hämtar eller anger ett värde som anger om de objekt som visas som standard i vyns navigeringsfönster visas. (Ärvd från FileDialog)
Site	Hämtar eller ställer in ISite i Component. (Ärvd från Component)
SupportMultiDottedExtensions	Hämtar eller anger om dialogrutan stöder visning och sparande av filer som har flera filnamnstillägg. (Ärvd från FileDialog)
Tag	Hämtar eller anger ett objekt som innehåller data om kontrollen. (Ärvd från CommonDialog)
Title	Hämtar eller anger fildialogrutans rubrik. (Ärvd från FileDialog)
ValidateNames	Hämtar eller anger ett värde som anger om dialogrutan endast accepterar giltiga Win32-filnamn. (Ärvd från FileDialog)

Metoder

Name	Description
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Dispose()	Släpper alla resurser som används av Component. (Ärvd från Component)
Dispose(Boolean)	Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna. (Ärvd från Component)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Föråldrad. Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetService(Type)	Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container. (Ärvd från Component)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definierar den vanliga dialogrutekrokproceduren som åsidosätts för att lägga till specifika funktioner i fildialogrutan. (Ärvd från FileDialog)
InitializeLifetimeService()	Föråldrad. Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
OnFileOk(CancelEventArgs)	Genererar händelsen FileOk . (Ärvd från FileDialog)
OnHelpRequest(EventArgs)	Genererar händelsen HelpRequest . (Ärvd från CommonDialog)
OpenFile()	Öppnar filen med läs-/skrivbehörighet som valts av användaren.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definierar den procedur för ägarfönster som åsidosätts för att lägga till specifika funktioner i en gemensam dialogruta. (Ärvd från CommonDialog)
Reset()	Återställer alla dialogrutealternativ till deras standardvärden.
RunDialog(IntPtr)	Anger en gemensam dialogruta. (Ärvd från FileDialog)
ShowDialog()	Kör en gemensam dialogruta med en standardägare. (Ärvd från CommonDialog)
ShowDialog(IWin32Window)	Kör en gemensam dialogruta med den angivna ägaren. (Ärvd från CommonDialog)
ToString()	Innehåller en strängversion av det här objektet. (Ärvd från FileDialog)

Händelser

Name	Description
Disposed	Inträffar när komponenten tas bort av ett anrop till Dispose() metoden. (Ärvd från Component)
FileOk	Inträffar när användaren klickar på knappen Öppna eller Spara i en fildialogruta. (Ärvd från FileDialog)
HelpRequest	Inträffar när användaren klickar på hjälpknappen i en gemensam dialogruta. (Ärvd från CommonDialog)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?