SaveFileDialog Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Monituje użytkownika o wybranie lokalizacji do zapisania pliku. Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Przykłady

Poniższy przykład kodu ilustruje tworzenie SaveFileDialogelementów członkowskich , ustawianie elementów członkowskich, wywoływanie okna dialogowego przy użyciu ShowDialog metody i zapisywanie bieżącego pliku. Przykład wymaga formularza z umieszczonym na nim przyciskiem.

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

Uwagi

Ta klasa może otworzyć i zastąpić istniejący plik lub utworzyć nowy plik.

Większość funkcji tej klasy znajduje się w FileDialog klasie.

Konstruktory

SaveFileDialog()

Inicjuje nowe wystąpienie tej klasy.

Właściwości

AddExtension	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe 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 dodaje otwierany lub zapisywany plik na najnowszej liście. (Odziedziczone po FileDialog)
AutoUpgradeEnabled	Pobiera lub ustawia wartość wskazującą, czy to FileDialog wystąpienie powinno automatycznie uaktualniać wygląd i zachowanie podczas uruchamiania w systemie Windows Vista. (Odziedziczone po FileDialog)
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
CheckFileExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która nie istnieje. (Odziedziczone po FileDialog)
CheckPathExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa ścieżkę, która nie istnieje. (Odziedziczone po FileDialog)
CheckWriteAccess	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe sprawdza, czy utworzenie określonego pliku zakończy się pomyślnie. Jeśli ta flaga nie jest ustawiona, aplikacja wywołująca musi obsługiwać błędy, takie jak odmowa dostępu, które zostaną odnalezione podczas tworzenia elementu.
ClientGuid	Pobiera lub ustawia identyfikator GUID do skojarzenia z tym stanem okna dialogowego. Zazwyczaj stan, taki jak ostatni odwiedzony folder i położenie i rozmiar okna dialogowego, są utrwalane na podstawie nazwy pliku wykonywalnego. Określając identyfikator GUID, aplikacja może mieć różne stany utrwalone dla różnych wersji okna dialogowego w tej samej aplikacji (na przykład okno dialogowe importowania i otwarte okno dialogowe). Ta funkcja nie jest dostępna, jeśli aplikacja nie używa stylów wizualnych lub jeśli AutoUpgradeEnabled jest ustawiona na `false`wartość . (Odziedziczone po FileDialog)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
CreatePrompt	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe monituje użytkownika o uprawnienie do utworzenia pliku, jeśli użytkownik określa plik, który nie istnieje.
CustomPlaces	Pobiera kolekcję miejsc niestandardowych dla tego FileDialog wystąpienia. (Odziedziczone po FileDialog)
DefaultExt	Pobiera lub ustawia domyślne rozszerzenie nazwy pliku. (Odziedziczone po FileDialog)
DereferenceLinks	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zwraca lokalizację pliku, do których odwołuje się skrót, czy też zwraca lokalizację skrótu (lnk). (Odziedziczone po FileDialog)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
ExpandedMode	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe jest zawsze otwierane w trybie rozszerzonym.
FileName	Pobiera lub ustawia ciąg zawierający nazwę pliku wybraną w oknie dialogowym pliku. (Odziedziczone po FileDialog)
FileNames	Pobiera nazwy plików wszystkich wybranych plików w oknie dialogowym. (Odziedziczone po FileDialog)
Filter	Pobiera lub ustawia bieżący ciąg filtru nazwy pliku, który określa opcje wyświetlane w oknie dialogowym "Zapisz jako typ pliku" lub "Pliki typu". (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)
Instance	Pobiera dojście wystąpienia Win32 dla aplikacji. (Odziedziczone po FileDialog)
OkRequiresInteraction	Pobiera lub ustawia wartość wskazującą, czy przycisk OK okna dialogowego jest wyłączony, dopóki użytkownik nie przejdzie do widoku lub edytuje nazwę pliku (jeśli ma to zastosowanie). (Odziedziczone po FileDialog)
Options	Pobiera wartości w celu zainicjowania elementu FileDialog. (Odziedziczone po FileDialog)
OverwritePrompt	Pobiera lub ustawia wartość wskazującą, czy `Save As` okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która już istnieje.
RestoreDirectory	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe przywraca katalog do wcześniej wybranego katalogu przed zamknięciem. (Odziedziczone po FileDialog)
ShowHelp	Pobiera lub ustawia wartość wskazującą, czy przycisk Pomoc jest wyświetlany w oknie dialogowym pliku. (Odziedziczone po FileDialog)
ShowHiddenFiles	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ukryte i systemowe pliki. (Odziedziczone po FileDialog)
ShowPinnedPlaces	Pobiera lub ustawia wartość wskazującą, czy elementy wyświetlane domyślnie w okienku nawigacji widoku są wyświetlane. (Odziedziczone po FileDialog)
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
SupportMultiDottedExtensions	Pobiera lub ustawia, czy okno dialogowe obsługuje wyświetlanie i zapisywanie plików z wieloma rozszerzeniami nazw plików. (Odziedziczone po FileDialog)
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Odziedziczone po CommonDialog)
Title	Pobiera lub ustawia tytuł 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

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
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)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje wspólną procedurę zaczepienia okna dialogowego, która jest zastępowana w celu dodania określonych funkcji do okna dialogowego pliku. (Odziedziczone po FileDialog)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnFileOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie. (Odziedziczone po CommonDialog)
OpenFile()	Otwiera plik z uprawnieniem do odczytu/zapisu wybranym przez użytkownika.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje procedurę okna właściciela, która jest zastępowana, aby dodać określone funkcje do wspólnego okna dialogowego. (Odziedziczone po CommonDialog)
Reset()	Resetuje wszystkie opcje okna dialogowego do ich wartości domyślnych.
RunDialog(IntPtr)	Określa typowe okno dialogowe. (Odziedziczone po FileDialog)
ShowDialog()	Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Odziedziczone po CommonDialog)
ShowDialog(IWin32Window)	Uruchamia wspólne okno dialogowe z określonym właścicielem. (Odziedziczone po CommonDialog)
ToString()	Udostępnia wersję ciągu tego obiektu. (Odziedziczone po FileDialog)

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
FileOk	Występuje, gdy użytkownik kliknie przycisk Otwórz lub Zapisz w oknie dialogowym plik. (Odziedziczone po FileDialog)
HelpRequest	Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Odziedziczone po CommonDialog)

Dotyczy