SaveFileDialog Klasa

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

PresentationFramework.dll

Reprezentuje typowe okno dialogowe, które umożliwia użytkownikowi określenie nazwy pliku w celu zapisania pliku jako. SaveFileDialog Program nie może być używany przez aplikację, która jest uruchamiana w ramach częściowego zaufania.

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

Dziedziczenie

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

Przykłady

W poniższym przykładzie pokazano, jak utworzyć element SaveFileDialog i przetworzyć wynik.

// 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 == true)
{
    // 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

Uwagi

Nie można zadeklarować tej klasy zarządzanej w języku XAML.

Konstruktory

SaveFileDialog()

Inicjuje nowe wystąpienie klasy SaveFileDialog.

Właściwości

AddExtension	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku automatycznie dodaje rozszerzenie do nazwy pliku, jeśli użytkownik pomija rozszerzenie. (Odziedziczone po FileDialog)
AddToRecent	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe spowoduje dodanie otwieranego lub zapisywanego elementu na liście ostatnio używanych dokumentów. (Odziedziczone po CommonItemDialog)
CheckFileExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która nie istnieje. (Odziedziczone po FileDialog)
CheckPathExists	Pobiera lub ustawia wartość określającą, czy ostrzeżenia są wyświetlane, jeśli użytkownik wpisze nieprawidłowe ścieżki i nazwy plików. (Odziedziczone po FileDialog)
ClientGuid	Pobiera lub ustawia identyfikator GUID do skojarzenia ze stanem utrwalonego okna dialogowego. (Odziedziczone po CommonItemDialog)
CreatePrompt	Pobiera lub ustawia wartość wskazującą, czy SaveFileDialog monituje użytkownika o uprawnienie do utworzenia pliku, jeśli użytkownik określa plik, który nie istnieje.
CreateTestFile	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe podejmie próbę utworzenia pliku testowego w wybranej ścieżce.
CustomPlaces	Pobiera lub ustawia listę niestandardowych miejsc dla okien dialogowych plików. (Odziedziczone po FileDialog)
DefaultDirectory	Pobiera lub ustawia katalog wyświetlany przez okno dialogowe pliku, jeśli nie jest dostępna żadna ostatnio używana wartość katalogu. (Odziedziczone po CommonItemDialog)
DefaultExt	Pobiera lub ustawia wartość określającą domyślny ciąg rozszerzenia, który ma być używany do filtrowania listy wyświetlanych plików. (Odziedziczone po FileDialog)
DereferenceLinks	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku zwraca lokalizację pliku, do których odwołuje się skrót, czy lokalizację pliku skrótu (.lnk). (Odziedziczone po FileDialog)
FileName	Pobiera lub ustawia ciąg zawierający pełną ścieżkę pliku wybranego w oknie dialogowym pliku. (Odziedziczone po FileDialog)
FileNames	Pobiera tablicę zawierającą jedną nazwę pliku dla każdego wybranego pliku. (Odziedziczone po FileDialog)
Filter	Pobiera lub ustawia ciąg filtru, który określa, jakie typy plików są wyświetlane z elementu OpenFileDialog lub SaveFileDialog. (Odziedziczone po FileDialog)
FilterIndex	Pobiera lub ustawia indeks filtru aktualnie wybranego w oknie dialogowym pliku. (Odziedziczone po FileDialog)
InitialDirectory	Pobiera lub ustawia początkowy katalog wyświetlany przez okno dialogowe pliku. (Odziedziczone po FileDialog)
Options	Pobiera flagi okien dialogowych typowych plików Win32, które są używane przez okna dialogowe plików do inicjowania. (Odziedziczone po FileDialog)
OverwritePrompt	Pobiera lub ustawia wartość wskazującą, czy SaveFileDialog wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, który już istnieje.
RestoreDirectory	Ta właściwość nie jest zaimplementowana. (Odziedziczone po FileDialog)
RootDirectory	Pobiera lub ustawia katalog wyświetlany jako katalog główny nawigacji dla okna dialogowego. (Odziedziczone po CommonItemDialog)
SafeFileName	Pobiera ciąg zawierający tylko nazwę pliku dla wybranego pliku. (Odziedziczone po FileDialog)
SafeFileNames	Pobiera tablicę zawierającą jedną bezpieczną nazwę pliku dla każdego wybranego pliku. (Odziedziczone po FileDialog)
ShowHiddenItems	Pobiera lub ustawia wartość wskazującą, czy w oknie dialogowym będą wyświetlane ukryte i systemowe elementy niezależnie od preferencji użytkownika. (Odziedziczone po CommonItemDialog)
Tag	Pobiera lub ustawia obiekt skojarzony z oknie dialogowym. Zapewnia to możliwość dołączania dowolnego obiektu do okna dialogowego. (Odziedziczone po CommonDialog)
Title	Pobiera lub ustawia tekst wyświetlany na pasku tytułu okna dialogowego pliku. (Odziedziczone po FileDialog)
ValidateNames	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe akceptuje tylko prawidłowe nazwy plików Win32. (Odziedziczone po FileDialog)

Metody

CheckPermissionsToShowDialog()	Określa, czy istnieją wystarczające uprawnienia do wyświetlania okna dialogowego. (Odziedziczone po CommonDialog)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje typową procedurę zaczepienia okna dialogowego pliku, która jest zastępowana w celu dodania typowych funkcji do okna dialogowego pliku. (Odziedziczone po FileDialog)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnFileOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog)
OnItemOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog)
OpenFile()	Tworzy strumień pliku do odczytu i zapisu dla nazwy pliku wybranej przez użytkownika przy użyciu polecenia SaveFileDialog.
Reset()	Resetuje wszystkie SaveFileDialog właściwości do ich wartości domyślnych.
RunDialog(IntPtr)	RunDialog(IntPtr) element jest wywoływany w celu wyświetlenia okna dialogowego pliku w klasie pochodnej, takiej jak OpenFileDialog i SaveFileDialog. (Odziedziczone po FileDialog)
ShowDialog()	Wyświetla typowe okno dialogowe. (Odziedziczone po CommonDialog)
ShowDialog(Window)	Wyświetla typowe okno dialogowe. (Odziedziczone po CommonDialog)
ToString()	Zwraca ciąg reprezentujący okno dialogowe pliku. (Odziedziczone po FileDialog)

Zdarzenia

FileOk

Występuje, gdy użytkownik wybierze nazwę pliku, klikając przycisk OpenFileDialogOtwórz lub przycisk Zapisz .SaveFileDialog (Odziedziczone po FileDialog)

Zobacz też

• OpenFileDialog