OpenFileDialog Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

OpenFileDialog.cs

Kullanıcıdan dosyayı açmasını isteyen standart bir iletişim kutusu görüntüler. Bu sınıf devralınamaz.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Devralma

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Örnekler

Aşağıdaki kod örneği bir OpenFileDialogoluşturur, dosya uzantısı filtresini ve iletişim kutusu davranışını tanımlamak için çeşitli özellikler ayarlar ve yöntemini kullanarak CommonDialog.ShowDialog iletişim kutusunu görüntüler. Örnek, üzerine yerleştirilmiş bir Button form ve buna eklenen ad alanına başvuru System.IO gerektirir.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

Açıklamalar

Bu sınıf, bir dosyanın var olup olmadığını denetlemenize ve dosyayı açmanıza olanak tanır. özelliği, ShowReadOnly iletişim kutusunda salt okunur onay kutusunun görünüp görünmeyeceğini belirler. ReadOnlyChecked özelliği, salt okunur onay kutusunun işaretli olup olmadığını gösterir.

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

Sağdan sola işletim sisteminde, içeren formun RightToLeft özelliğini iletişim kutusunun Dosya Adı, Aç ve İptal düğmelerini yerelleştirecek RightToLeft.Yes şekilde ayarlayın. Özelliği olarak ayarlanmadıysa RightToLeft.Yes, bunun yerine İngilizce metin kullanılır.

Kullanıcıya dosya yerine klasör seçme olanağı vermek istiyorsanız, bunun yerine kullanın FolderBrowserDialog .

Oluşturucular

Name	Description
OpenFileDialog()	Sınıfının bir örneğini OpenFileDialog başlatır.

Özellikler

Name	Description
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	Bu FileDialog örneğin Windows Vista'da çalışırken 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)
CheckFileExists	Kullanıcı var olmayan bir dosya adı belirtirse iletişim kutusunun bir uyarı görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar.
CheckPathExists	Kullanıcı var olmayan bir yol belirtiyorsa iletişim kutusunun bir uyarı görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
ClientGuid	GUID'yi 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ı hale gelir. Bir uygulama GUID belirterek, 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 AutoUpgradeEnabledfalsebu işlev kullanılamaz. (Devralındığı yer: FileDialog)
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şvuruda bulunılan dosyanın konumunu mu döndürdüğüne veya kısayolun konumunu döndürdüğüne (.lnk) ilişkin bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
FileName	Dosya iletişim kutusunda seçilen dosya adını içeren bir dize 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 durumda olan 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 tutamacını alır. (Devralındığı yer: FileDialog)
Multiselect	İletişim kutusunun birden çok dosya seçilmesine izin verip vermediğini belirten bir değer alır veya ayarlar.
OkRequiresInteraction	Kullanıcı görünümde gezinene veya dosya adını (varsa) düzenleyene kadar 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)
ReadOnlyChecked	Salt okunur onay kutusunun seçili olup olmadığını 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üklemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: FileDialog)
SafeFileName	İletişim kutusunda seçilen dosyanın adını ve uzantısını alır. Dosya adı yolu içermiyor.
SafeFileNames	İletişim kutusundaki tüm seçili dosyalar için bir dosya adları ve uzantıları dizisi alır. Dosya adları yolu içermez.
SelectReadOnly	İletişim kutusunun salt okunur dosyaların seçilmesine izin verip vermeyeceğini belirten bir değer alır veya ayarlar.
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)
ShowPreview	İletişim kutusunun seçili dosyalar için bir önizleme gösterip göstermediğini belirten bir değer alır veya ayarlar.
ShowReadOnly	İletişim kutusunun salt okunur onay kutusu içerip içermediğini belirten bir değer alır veya ayarlar.
SupportMultiDottedExtensions	İletişim kutusunun birden çok dosya adı uzantısına sahip dosyaları görüntülemeyi ve kaydetmeyi 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

Name	Description
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)
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 dosyayı salt okunur izinle açar. Dosya özelliği tarafından FileName belirtilir.
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 özellikleri 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

Name	Description
FileOk	Kullanıcı bir dosyadaki Aç veya Kaydet düğmesine tıkladığında gerçekleşir. (Devralındığı yer: FileDialog)
HelpRequest	Kullanıcı ortak bir iletişim kutusunda Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog)

Ayrıca bkz.

• FileDialog
• CommonDialog
• SaveFileDialog
• Nasıl yapılır: Dosyadan Metin Okuma