SaveFileDialog Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kullanıcıdan dosyayı kaydetmek için bir konum seçmesini ister. Bu sınıf devralınamaz.

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

Devralma: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Örnekler

Aşağıdaki kod örneğinde, oluşturma SaveFileDialog, üyeleri ayarlama, yöntemini kullanarak ShowDialog iletişim kutusunu çağırma ve geçerli dosyayı kaydetme işlemleri gösterilmektedir. Örnek, üzerine düğme yerleştirilmiş bir form gerektirir.

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

Açıklamalar

Bu sınıf var olan bir dosyayı açıp üzerine yazabilir veya yeni bir dosya oluşturabilir.

Bu sınıfın işlevlerinin çoğu sınıfında FileDialog bulunur.

Oluşturucular

SaveFileDialog()

Bu sınıfın yeni bir örneğini başlatır.

Özellikler

AddExtension	Kullanıcı uzantıyı atlarsa, iletişim kutusunun dosya adına otomatik olarak uzantı ekleyip eklemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
AddToRecent	İletişim kutusunun açılan veya kaydedilen dosyayı son listeye ekleyip eklemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
AutoUpgradeEnabled	Windows Vista'da çalışırken bu FileDialog örneğin görünümü ve davranışı otomatik olarak yükseltmesi gerekip gerekmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
CheckFileExists	Kullanıcı var olmayan bir dosya adı belirtirse iletişim kutusunun uyarı görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
CheckPathExists	Kullanıcı var olmayan bir yol belirtirse iletişim kutusunun uyarı görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
CheckWriteAccess	İletişim kutusunun belirtilen dosyanın oluşturulmasının başarılı olup olmayacağını doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar. Bu bayrak ayarlanmadıysa, çağıran uygulamanın öğe oluşturulduğunda bulunan erişim reddi gibi hataları işlemesi gerekir.
ClientGuid	Guid değerini bu iletişim kutusu durumuyla ilişkilendirilecek şekilde alır veya ayarlar. Genellikle, son ziyaret edilen klasör ve iletişim kutusunun konumu ve boyutu gibi durum yürütülebilir dosyanın adına göre kalıcıdır. Guid belirterek, bir uygulama aynı uygulama içindeki iletişim kutusunun farklı sürümleri için farklı kalıcı durumlara sahip olabilir (örneğin, içeri aktarma iletişim kutusu ve açık iletişim kutusu). Bir uygulama görsel stiller kullanmıyorsa veya olarak ayarlandıysa AutoUpgradeEnabled`false`bu işlev kullanılamaz. (Devralındığı yer: FileDialog)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
CreatePrompt	Kullanıcı var olmayan bir dosya belirtirse, iletişim kutusunun kullanıcıdan dosya oluşturma izni isteyip istemediğinizi belirten bir değer alır veya ayarlar.
CustomPlaces	Bu FileDialog örnek için özel yerler koleksiyonunu alır. (Devralındığı yer: FileDialog)
DefaultExt	Varsayılan dosya adı uzantısını alır veya ayarlar. (Devralındığı yer: FileDialog)
DereferenceLinks	İletişim kutusunun kısayol tarafından başvurulan dosyanın konumunu döndürdüğü veya kısayolun konumunu (.lnk) döndürdüğü bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
ExpandedMode	İletişim kutusunun her zaman genişletilmiş modda açılıp açılmadığını belirten bir değer alır veya ayarlar.
FileName	Dosya iletişim kutusunda seçilen dosya adını içeren bir dizeyi alır veya ayarlar. (Devralındığı yer: FileDialog)
FileNames	İletişim kutusundaki tüm seçili dosyaların dosya adlarını alır. (Devralındığı yer: FileDialog)
Filter	İletişim kutusundaki "Dosya türü olarak kaydet" veya "Dosya türü" kutusunda görünen seçenekleri belirleyen geçerli dosya adı filtre dizesini alır veya ayarlar. (Devralındığı yer: FileDialog)
FilterIndex	Dosya iletişim kutusunda seçili durumdaki filtrenin dizinini alır veya ayarlar. (Devralındığı yer: FileDialog)
InitialDirectory	Dosya iletişim kutusu tarafından görüntülenen ilk dizini alır veya ayarlar. (Devralındığı yer: FileDialog)
Instance	Uygulama için Win32 örnek tanıtıcısını alır. (Devralındığı yer: FileDialog)
OkRequiresInteraction	Kullanıcı görünümde gezinene veya dosya adını düzenleyene kadar (varsa) iletişim kutusunun Tamam düğmesinin devre dışı bırakıldığını belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
Options	başlatma FileDialogdeğerlerini alır. (Devralındığı yer: FileDialog)
OverwritePrompt	Kullanıcı zaten var olan bir dosya adını belirtirse iletişim kutusunun uyarı görüntüleyip `Save As` görüntülemediğini belirten bir değer alır veya ayarlar.
RestoreDirectory	İletişim kutusunun kapatmadan önce dizini daha önce seçilen dizine geri yükleyip geri yüklemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
ShowHelp	Dosya iletişim kutusunda Yardım düğmesinin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
ShowHiddenFiles	İletişim kutusunun gizli ve sistem dosyalarını görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
ShowPinnedPlaces	Görünümün gezinti bölmesinde varsayılan olarak gösterilen öğelerin gösterilip gösterilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
SupportMultiDottedExtensions	İletişim kutusunun birden çok dosya adı uzantısına sahip dosyaların görüntülenmesini ve kaydedilmesini destekleyip desteklemediğini alır veya ayarlar. (Devralındığı yer: FileDialog)
Tag	Denetim hakkındaki verileri içeren bir nesneyi alır veya ayarlar. (Devralındığı yer: CommonDialog)
Title	Dosya iletişim kutusu başlığını alır veya ayarlar. (Devralındığı yer: FileDialog)
ValidateNames	İletişim kutusunun yalnızca geçerli Win32 dosya adlarını kabul edip etmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)

Yöntemler

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Dosya iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan ortak iletişim kutusu kanca yordamını tanımlar. (Devralındığı yer: FileDialog)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnFileOk(CancelEventArgs)	Olayı tetikler FileOk . (Devralındığı yer: FileDialog)
OnHelpRequest(EventArgs)	Olayı tetikler HelpRequest . (Devralındığı yer: CommonDialog)
OpenFile()	Kullanıcı tarafından seçilen okuma/yazma iznine sahip dosyayı açar.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan sahip penceresi yordamını tanımlar. (Devralındığı yer: CommonDialog)
Reset()	Tüm iletişim kutusu seçeneklerini varsayılan değerlerine sıfırlar.
RunDialog(IntPtr)	Ortak bir iletişim kutusu belirtir. (Devralındığı yer: FileDialog)
ShowDialog()	Varsayılan sahibi olan ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)
ShowDialog(IWin32Window)	Belirtilen sahiple ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)
ToString()	Bu nesnenin dize sürümünü sağlar. (Devralındığı yer: FileDialog)

Ekinlikler

Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
FileOk	Kullanıcı dosyadaki Aç veya Kaydet düğmesine tıkladığında gerçekleşir. (Devralındığı yer: FileDialog)
HelpRequest	Kullanıcı ortak bir iletişim kutusundaki Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog)

Şunlara uygulanır