SaveFileDialog Klass
Definition
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.
Representerar en gemensam dialogruta där användaren kan ange ett filnamn för att spara en fil som. SaveFileDialog kan inte användas av ett program som körs under partiellt förtroende.
public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class SaveFileDialog : Microsoft.Win32.FileDialog
type SaveFileDialog = class
inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
- Arv
- Arv
Exempel
I följande exempel visas hur du skapar och SaveFileDialog bearbetar resultatet.
// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension
// Show save file dialog box
Nullable<bool> result = dlg.ShowDialog();
// Process save file dialog box results
if (result.Value)
{
// Save document
string filename = dlg.FileName;
}
' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension
' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()
' Process save file dialog box results
If result = True Then
' Save document
Dim filename As String = dlg.FileName
End If
Kommentarer
Du kan inte deklarera den här hanterade klassen i XAML.
Konstruktorer
| Name | Description |
|---|---|
| SaveFileDialog() |
Initierar en ny instans av SaveFileDialog klassen. |
Egenskaper
| Name | Description |
|---|---|
| AddExtension |
Hämtar eller anger ett värde som anger om en fildialogruta automatiskt lägger till ett tillägg till ett filnamn om användaren utelämnar ett tillägg. (Ärvd från FileDialog) |
| AddToRecent |
Hämtar eller anger ett värde som anger om dialogrutan ska lägga till objektet som öppnas eller sparas i den senaste dokumentlistan. (Ärvd från CommonItemDialog) |
| CheckFileExists |
Hämtar eller anger ett värde som anger om en fildialogruta 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 varningar ska visas om användaren skriver ogiltiga sökvägar och filnamn. (Ärvd från FileDialog) |
| ClientGuid |
Hämtar eller anger ett GUID som ska associeras med dialogrutans beständiga tillstånd. (Ärvd från CommonItemDialog) |
| CreatePrompt |
Hämtar eller anger ett värde som anger om SaveFileDialog användaren uppmanas att skapa en fil om användaren anger en fil som inte finns. |
| CreateTestFile |
Hämtar eller anger ett värde som anger om dialogrutan ska försöka skapa en testfil på den valda sökvägen. |
| CustomPlaces |
Hämtar eller anger listan över anpassade platser för fildialogrutor. (Ärvd från FileDialog) |
| DefaultDirectory |
Hämtar eller anger den katalog som visas i fildialogrutan om det inte finns något nyligen använt katalogvärde tillgängligt. (Ärvd från CommonItemDialog) |
| DefaultExt |
Hämtar eller anger ett värde som anger standardtilläggssträngen som ska användas för att filtrera listan över filer som visas. (Ärvd från FileDialog) |
| DereferenceLinks |
Hämtar eller anger ett värde som anger om en fildialogruta returnerar antingen platsen för filen som refereras till av en genväg eller platsen för genvägsfilen (.lnk). (Ärvd från FileDialog) |
| FileName |
Hämtar eller anger en sträng som innehåller den fullständiga sökvägen till filen som valts i en fildialogruta. (Ärvd från FileDialog) |
| FileNames |
Hämtar en matris som innehåller ett filnamn för varje vald fil. (Ärvd från FileDialog) |
| Filter |
Hämtar eller anger filtersträngen som avgör vilka typer av filer som visas från antingen OpenFileDialog eller SaveFileDialog. (Ärvd från FileDialog) |
| FilterIndex |
Hämtar eller anger indexet för det filter som för närvarande är markerat i en fildialogruta. (Ärvd från FileDialog) |
| InitialDirectory |
Hämtar eller anger den första katalogen som visas i en fildialogruta. (Ärvd från FileDialog) |
| Options |
Hämtar de gemensamma win32-fildialogflaggor som används av fildialogrutor för initiering. (Ärvd från FileDialog) |
| OverwritePrompt |
Hämtar eller anger ett värde som anger om SaveFileDialog en varning visas om användaren anger namnet på en fil som redan finns. |
| RestoreDirectory |
Den här egenskapen har inte implementerats. (Ärvd från FileDialog) |
| RootDirectory |
Hämtar eller anger katalogen som visas som navigeringsrot för dialogrutan. (Ärvd från CommonItemDialog) |
| SafeFileName |
Hämtar en sträng som bara innehåller filnamnet för den valda filen. (Ärvd från FileDialog) |
| SafeFileNames |
Hämtar en matris som innehåller ett säkert filnamn för varje vald fil. (Ärvd från FileDialog) |
| ShowHiddenItems |
Hämtar eller anger ett värde som anger om dialogrutan ska visa dolda objekt och systemobjekt oavsett användarinställningar. (Ärvd från CommonItemDialog) |
| Tag |
Hämtar eller anger ett objekt som är associerat med dialogrutan. Detta ger möjlighet att koppla ett godtyckligt objekt till dialogrutan. (Ärvd från CommonDialog) |
| Title |
Hämtar eller anger texten som visas i namnlisten i en fildialogruta. (Ä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 |
|---|---|
| CheckPermissionsToShowDialog() |
Avgör om det finns tillräckliga behörigheter för att visa en dialogruta. (Ärvd från CommonDialog) |
| 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) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definierar den vanliga dialogruteproceduren för filer som åsidosätts för att lägga till vanliga funktioner i en fildialogruta. (Ärvd från FileDialog) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnFileOk(CancelEventArgs) |
Genererar händelsen FileOk . (Ärvd från FileDialog) |
| OnItemOk(CancelEventArgs) |
Genererar händelsen FileOk . (Ärvd från FileDialog) |
| OpenFile() |
Skapar en skrivskyddad filström för filnamnet som valts av användaren med hjälp av SaveFileDialog. |
| Reset() |
Återställer alla SaveFileDialog egenskaper till deras standardvärden. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) anropas för att visa en fildialogruta i en härledd klass, till exempel OpenFileDialog och SaveFileDialog. (Ärvd från FileDialog) |
| ShowDialog() |
Visar en gemensam dialogruta. (Ärvd från CommonDialog) |
| ShowDialog(Window) |
Visar en gemensam dialogruta. (Ärvd från CommonDialog) |
| ToString() |
Returnerar en sträng som representerar en fildialogruta. (Ärvd från FileDialog) |
Händelser
| Name | Description |
|---|---|
| FileOk |
Inträffar när användaren väljer ett filnamn genom att antingen klicka på knappen OpenFileDialog eller knappen Spara i SaveFileDialog. (Ärvd från FileDialog) |