Udostępnij za pośrednictwem


SaveFileDialog Klasa

Definicja

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
SaveFileDialog
Dziedziczenie

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)

Dotyczy

Zobacz też