OpenFileDialog Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

OpenFileDialog.cs

Egy szabványos párbeszédpanelt jelenít meg, amely arra kéri a felhasználót, hogy nyisson meg egy fájlt. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Példák

Az alábbi példakód létrehoz egy OpenFileDialog, több tulajdonságot állít be a fájlkiterjesztés szűrőjének és a párbeszédpanel viselkedésének meghatározásához, és megjeleníti a párbeszédpanelt a CommonDialog.ShowDialog metódus használatával. A példához egy olyan űrlapra van szükség, amelyen elhelyezve Button van egy hivatkozás a System.IO hozzá hozzáadott névtérre.

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

Megjegyzések

Ez az osztály lehetővé teszi egy fájl meglétének ellenőrzését és megnyitását. A ShowReadOnly tulajdonság határozza meg, hogy megjelenik-e írásvédett jelölőnégyzet a párbeszédpanelen. A ReadOnlyChecked tulajdonság azt jelzi, hogy be van-e jelölve az írásvédett jelölőnégyzet.

Az osztály alapvető funkcióinak többsége az FileDialog osztályban található.

Egy jobbról balra író operációs rendszeren állítsa be az űrlap tulajdonságát RightToLeftRightToLeft.Yes a párbeszédpanel Fájlnév, Megnyitás és Mégse gombjainak honosítására. Ha a tulajdonság nincs beállítva RightToLeft.Yes, a rendszer ehelyett angol szöveget használ.

Ha lehetővé szeretné tenni a felhasználó számára, hogy fájl helyett egy mappát válasszon, használja FolderBrowserDialog helyette.

Konstruktorok

Name	Description
OpenFileDialog()	Inicializálja az osztály egy példányát OpenFileDialog .

Tulajdonságok

Name	Description
AddExtension	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel automatikusan hozzáad-e bővítményt egy fájlnévhez, ha a felhasználó kihagyja a bővítményt. (Öröklődés forrása FileDialog)
AddToRecent	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel hozzáadja-e a megnyitott vagy mentett fájlt a legutóbbi listához. (Öröklődés forrása FileDialog)
AutoUpgradeEnabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy ennek a FileDialog példánynak automatikusan frissítenie kell-e a megjelenést és a viselkedést Windows Vista futtatásakor. (Öröklődés forrása FileDialog)
CheckFileExists	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel figyelmeztetést jelenít-e meg, ha a felhasználó nem létező fájlnevet ad meg.
CheckPathExists	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel figyelmeztetést jelenít-e meg, ha a felhasználó olyan elérési utat ad meg, amely nem létezik. (Öröklődés forrása FileDialog)
ClientGuid	Lekéri vagy beállítja a GUID azonosítót a párbeszédpanel állapotához való társításhoz. A rendszer általában a végrehajtható fájl neve alapján megőrzi az állapotot, például az utoljára meglátogatott mappát, valamint a párbeszédpanel helyét és méretét. A GUID megadásával az alkalmazások különböző tartós állapotokkal rendelkezhetnek a párbeszédpanel különböző verzióihoz ugyanazon az alkalmazásban (például egy importálási párbeszédpanelen és egy megnyitott párbeszédpanelen). Ez a funkció nem érhető el, ha egy alkalmazás nem használ vizuális stílusokat, vagy ha AutoUpgradeEnabled be van állítva false. (Öröklődés forrása FileDialog)
CustomPlaces	Lekéri a példányhoz tartozó egyéni helyek gyűjteményét FileDialog . (Öröklődés forrása FileDialog)
DefaultExt	Lekéri vagy beállítja az alapértelmezett fájlnévkiterjesztést. (Öröklődés forrása FileDialog)
DereferenceLinks	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel visszaadja-e a parancsikon által hivatkozott fájl helyét, vagy a parancsikon helyét adja vissza (.lnk). (Öröklődés forrása FileDialog)
FileName	Lekéri vagy beállítja a fájl párbeszédpanelen kijelölt fájlnevet tartalmazó sztringet. (Öröklődés forrása FileDialog)
FileNames	Lekéri az összes kijelölt fájl nevét a párbeszédpanelen. (Öröklődés forrása FileDialog)
Filter	Lekéri vagy beállítja az aktuális fájlnévszűrő sztringet, amely meghatározza a párbeszédpanelEn a "Mentés fájltípusként" vagy a "Fájltípus" mezőben megjelenő lehetőségeket. (Öröklődés forrása FileDialog)
FilterIndex	Lekéri vagy beállítja a fájl párbeszédpanelen jelenleg kijelölt szűrő indexét. (Öröklődés forrása FileDialog)
InitialDirectory	Lekéri vagy beállítja a fájl párbeszédpanelen megjelenő kezdeti könyvtárat. (Öröklődés forrása FileDialog)
Instance	Lekéri az alkalmazás Win32-példányának leírót. (Öröklődés forrása FileDialog)
Multiselect	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel lehetővé teszi-e több fájl kijelölését.
OkRequiresInteraction	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel OK gombja le van-e tiltva, amíg a felhasználó meg nem navigál a nézeten, vagy nem módosítja a fájlnevet (ha van). (Öröklődés forrása FileDialog)
Options	Lekéri az értékeket a FileDialog. (Öröklődés forrása FileDialog)
ReadOnlyChecked	Lekéri vagy beállít egy értéket, amely jelzi, hogy be van-e jelölve az írásvédett jelölőnégyzet.
RestoreDirectory	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel a bezárás előtt visszaállítja-e a könyvtárat a korábban kijelölt könyvtárba. (Öröklődés forrása FileDialog)
SafeFileName	Lekéri a párbeszédpanelen kijelölt fájl nevét és bővítményét. A fájlnév nem tartalmazza az elérési utat.
SafeFileNames	Lekéri a párbeszédpanel összes kijelölt fájljának fájlneveit és bővítményeit tartalmazó tömböt. A fájlnevek nem tartalmazzák az elérési utat.
SelectReadOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel engedélyezi-e a csak olvasható fájlok kiválasztását.
ShowHelp	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Súgó gomb megjelenik-e a fájl párbeszédpanelen. (Öröklődés forrása FileDialog)
ShowHiddenFiles	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel megjeleníti-e a rejtett és a rendszerfájlokat. (Öröklődés forrása FileDialog)
ShowPinnedPlaces	Beolvas vagy beállít egy értéket, amely jelzi, hogy a nézet navigációs ablaktábláján alapértelmezés szerint megjelenített elemek megjelennek-e. (Öröklődés forrása FileDialog)
ShowPreview	Beolvas vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel megjeleníti-e a kijelölt fájlok előnézetét.
ShowReadOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel tartalmaz-e írásvédett jelölőnégyzetet.
SupportMultiDottedExtensions	Lekérdezi vagy beállítja, hogy a párbeszédpanel támogatja-e a több fájlnévkiterjesztéssel rendelkező fájlok megjelenítését és mentését. (Öröklődés forrása FileDialog)
Tag	Lekéri vagy beállít egy objektumot, amely adatokat tartalmaz a vezérlőről. (Öröklődés forrása CommonDialog)
Title	Lekéri vagy beállítja a fájl párbeszédpaneljének címét. (Öröklődés forrása FileDialog)
ValidateNames	Lekéri vagy beállít egy értéket, amely jelzi, hogy a párbeszédpanel csak érvényes Win32-fájlneveket fogad-e el. (Öröklődés forrása FileDialog)

Metódusok

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza a párbeszédpanelek gyakori horog eljárását, amelyet felül kell bírálni, hogy adott funkciókat adjon hozzá a fájl párbeszédpaneljéhez. (Öröklődés forrása FileDialog)
OnFileOk(CancelEventArgs)	Az eseményt emeli FileOk ki. (Öröklődés forrása FileDialog)
OnHelpRequest(EventArgs)	Az eseményt emeli HelpRequest ki. (Öröklődés forrása CommonDialog)
OpenFile()	Megnyitja a felhasználó által kijelölt fájlt írásvédett engedéllyel. A fájlt a FileName tulajdonság adja meg.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza azt a tulajdonosi ablak eljárást, amelyet felül kell bírálni, hogy adott funkciókat adjon hozzá egy közös párbeszédpanelhez. (Öröklődés forrása CommonDialog)
Reset()	Alaphelyzetbe állítja az összes tulajdonságot az alapértelmezett értékre.
RunDialog(IntPtr)	Egy közös párbeszédpanelt ad meg. (Öröklődés forrása FileDialog)
ShowDialog()	Egy általános párbeszédpanelt futtat egy alapértelmezett tulajdonossal. (Öröklődés forrása CommonDialog)
ShowDialog(IWin32Window)	Futtat egy közös párbeszédpanelt a megadott tulajdonossal. (Öröklődés forrása CommonDialog)
ToString()	Az objektum sztringverzióját biztosítja. (Öröklődés forrása FileDialog)

esemény

Name	Description
FileOk	Akkor fordul elő, ha a felhasználó a Fájl párbeszédpanel Megnyitás vagy Mentés gombjára kattint. (Öröklődés forrása FileDialog)
HelpRequest	Ez akkor fordul elő, ha a felhasználó a Súgó gombra kattint egy közös párbeszédpanelen. (Öröklődés forrása CommonDialog)

Lásd még

• FileDialog
• CommonDialog
• SaveFileDialog
• Útmutató: Szöveg beolvasása fájlból