OpenFileDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

OpenFileDialog.cs

Zobrazí standardní dialogové okno s výzvou k otevření souboru uživatelem. Tuto třídu nelze zdědit.

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

Dědičnost

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Příklady

Následující příklad kódu vytvoří OpenFileDialog, nastaví několik vlastností definovat chování přípony souboru a dialogové okno a zobrazí dialogové okno pomocí CommonDialog.ShowDialog metody. Příklad vyžaduje formulář s umístěním Button a odkazem System.IO na obor názvů přidaný do něj.

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

Poznámky

Tato třída umožňuje zkontrolovat, zda soubor existuje, a otevřít jej. Vlastnost ShowReadOnly určuje, zda se v dialogovém okně zobrazí zaškrtávací políčko jen pro čtení. Vlastnost ReadOnlyChecked označuje, zda je zaškrtnuto políčko jen pro čtení.

Většina základních funkcí pro tuto třídu se nachází ve FileDialog třídě.

V operačním systému se zprava doleva nastaví vlastnost obsahující formulář RightToLeft tak, aby RightToLeft.Yes lokalizovala tlačítka Název souboru dialogového okna, Otevřít a Zrušit . Pokud vlastnost není nastavena na RightToLeft.Yes, použije se místo toho anglický text.

Pokud chcete uživateli dát možnost vybrat složku místo souboru, použijte FolderBrowserDialog ji.

Konstruktory

Name	Description
OpenFileDialog()	Inicializuje instanci OpenFileDialog třídy.

Vlastnosti

Name	Description
AddExtension	Získá nebo nastaví hodnotu určující, zda dialogové okno automaticky přidá příponu k názvu souboru, pokud uživatel vynechá příponu. (Zděděno od FileDialog)
AddToRecent	Získá nebo nastaví hodnotu určující, zda dialogové okno přidá soubor, který je otevřen nebo uložen do posledního seznamu. (Zděděno od FileDialog)
AutoUpgradeEnabled	Získá nebo nastaví hodnotu určující, zda tato FileDialog instance má automaticky upgradovat vzhled a chování při spuštění v systému Windows Vista. (Zděděno od FileDialog)
CheckFileExists	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí upozornění, pokud uživatel určuje název souboru, který neexistuje.
CheckPathExists	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí upozornění, pokud uživatel určuje cestu, která neexistuje. (Zděděno od FileDialog)
ClientGuid	Získá nebo nastaví identifikátor GUID pro přidružení k tomuto stavu dialogového okna. Obvykle se stav, jako je naposledy navštívená složka a umístění a velikost dialogového okna, zachovají na základě názvu spustitelného souboru. Zadáním identifikátoru GUID může mít aplikace různé trvalé stavy pro různé verze dialogového okna ve stejné aplikaci (například dialogové okno importu a otevřené dialogové okno). Tato funkce není k dispozici, pokud aplikace nepoužívá vizuální styly nebo je AutoUpgradeEnabled nastavena na false. (Zděděno od FileDialog)
CustomPlaces	Získá vlastní kolekce míst pro tuto FileDialog instanci. (Zděděno od FileDialog)
DefaultExt	Získá nebo nastaví výchozí příponu názvu souboru. (Zděděno od FileDialog)
DereferenceLinks	Získá nebo nastaví hodnotu určující, zda dialogové okno vrátí umístění souboru odkazovaného zástupcem nebo zda vrací umístění zástupce (.lnk). (Zděděno od FileDialog)
FileName	Získá nebo nastaví řetězec obsahující název souboru vybraný v dialogovém okně soubor. (Zděděno od FileDialog)
FileNames	Získá názvy souborů všech vybraných souborů v dialogovém okně. (Zděděno od FileDialog)
Filter	Získá nebo nastaví aktuální řetězec filtru názvu souboru, který určuje volby, které se zobrazí v poli "Uložit jako typ souboru" nebo "Soubory typu" v dialogovém okně. (Zděděno od FileDialog)
FilterIndex	Získá nebo nastaví index filtru aktuálně vybraný v dialogovém okně soubor. (Zděděno od FileDialog)
InitialDirectory	Získá nebo nastaví počáteční adresář zobrazený v dialogovém okně soubor. (Zděděno od FileDialog)
Instance	Získá popisovač instance Win32 pro aplikaci. (Zděděno od FileDialog)
Multiselect	Získá nebo nastaví hodnotu určující, zda dialogové okno umožňuje vybrat více souborů.
OkRequiresInteraction	Získá nebo nastaví hodnotu určující, zda je tlačítko OK dialogového okna zakázáno, dokud uživatel nepřejde do zobrazení nebo upraví název souboru (pokud je k dispozici). (Zděděno od FileDialog)
Options	Získá hodnoty pro inicializaci FileDialog. (Zděděno od FileDialog)
ReadOnlyChecked	Získá nebo nastaví hodnotu určující, zda je zaškrtnuto políčko jen pro čtení.
RestoreDirectory	Získá nebo nastaví hodnotu určující, zda dialogové okno obnoví adresář do dříve vybraného adresáře před zavřením. (Zděděno od FileDialog)
SafeFileName	Získá název a příponu souboru vybraného v dialogovém okně. Název souboru neobsahuje cestu.
SafeFileNames	Získá pole názvů souborů a přípon pro všechny vybrané soubory v dialogovém okně. Názvy souborů neobsahují cestu.
SelectReadOnly	Získá nebo nastaví hodnotu určující, zda dialogové okno umožňuje výběr souborů jen pro čtení.
ShowHelp	Získá nebo nastaví hodnotu určující, zda je tlačítko Nápověda zobrazena v dialogovém okně soubor. (Zděděno od FileDialog)
ShowHiddenFiles	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazuje skryté a systémové soubory. (Zděděno od FileDialog)
ShowPinnedPlaces	Získá nebo nastaví hodnotu určující, zda položky zobrazené ve výchozím nastavení v navigačním podokně zobrazení jsou zobrazeny. (Zděděno od FileDialog)
ShowPreview	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazuje náhled pro vybrané soubory.
ShowReadOnly	Získá nebo nastaví hodnotu označující, zda dialogové okno obsahuje zaškrtávací políčko jen pro čtení.
SupportMultiDottedExtensions	Získá nebo nastaví, zda dialogové okno podporuje zobrazení a ukládání souborů, které mají více přípon názvů souborů. (Zděděno od FileDialog)
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku. (Zděděno od CommonDialog)
Title	Získá nebo nastaví název dialogového okna souboru. (Zděděno od FileDialog)
ValidateNames	Získá nebo nastaví hodnotu určující, zda dialogové okno přijímá pouze platné názvy souborů Win32. (Zděděno od FileDialog)

Metody

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje běžnou proceduru háku dialogového okna, která se přepíše, aby do dialogového okna soubor přidala konkrétní funkce. (Zděděno od FileDialog)
OnFileOk(CancelEventArgs)	FileOk Vyvolá událost. (Zděděno od FileDialog)
OnHelpRequest(EventArgs)	HelpRequest Vyvolá událost. (Zděděno od CommonDialog)
OpenFile()	Otevře soubor vybraný uživatelem s oprávněním jen pro čtení. Soubor je určen vlastností FileName .
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru okna vlastníka, která je přepsána pro přidání konkrétní funkce do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví všechny vlastnosti na výchozí hodnoty.
RunDialog(IntPtr)	Určuje společné dialogové okno. (Zděděno od FileDialog)
ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem. (Zděděno od CommonDialog)
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem. (Zděděno od CommonDialog)
ToString()	Poskytuje řetězcovou verzi tohoto objektu. (Zděděno od FileDialog)

Událost

Name	Description
FileOk	Nastane, když uživatel klikne na tlačítko Otevřít nebo Uložit v dialogovém okně soubor. (Zděděno od FileDialog)
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda v běžném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• FileDialog
• CommonDialog
• SaveFileDialog
• Postupy: Čtení textu ze souboru