OpenFileDialog Třída

Definice

Zobrazí standardní dialogové okno, které uživatele vyzve k otevření souboru. Tato třída se nemůže dě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

Příklady

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

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, jestli se v dialogovém okně zobrazí zaškrtávací políčko jen pro čtení. Vlastnost ReadOnlyChecked označuje, zda je políčko jen pro čtení zaškrtnuté.

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 lokalizují tlačítka Název souboru dialogového okna, Otevřít a Zrušit nastavením vlastnosti RightToLeft.Yes obsahujícího RightToLeft formulář. Pokud vlastnost není nastavena na RightToLeft.Yeshodnotu , použije se místo toho text v angličtině.

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

Konstruktory

OpenFileDialog()

Inicializuje instanci třídy OpenFileDialog.

Vlastnosti

AddExtension

Získá nebo nastaví hodnotu označ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 označující, zda dialogové okno přidá soubor, který je otevřen nebo uložen do seznamu posledních.

(Zděděno od FileDialog)
AutoUpgradeEnabled

Získá nebo nastaví hodnotu označující, zda má tato FileDialog instance automaticky upgradovat vzhled a chování při spuštění v systému Windows Vista.

(Zděděno od FileDialog)
CanRaiseEvents

Získá hodnotu označující, zda komponenta může vyvolat událost.

(Zděděno od Component)
CheckFileExists

Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí upozornění, pokud uživatel zadá název souboru, který neexistuje.

CheckPathExists

Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí upozornění, pokud uživatel zadá 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 například 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 v rámci stejné aplikace (například dialogové okno importu a otevřené dialogové okno).

Tato funkce není k dispozici, pokud aplikace nepoužívá vizuální styly nebo pokud AutoUpgradeEnabled je nastavená na false.

(Zděděno od FileDialog)
Container

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
CustomPlaces

Získá vlastní místa kolekce 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 označující, zda dialogové okno vrátí umístění souboru odkazovaného zástupcem nebo zda vrátí umístění zástupce (.lnk).

(Zděděno od FileDialog)
DesignMode

Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component .

(Zděděno od Component)
Events

Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component.

(Zděděno od Component)
FileName

Získá nebo nastaví řetězec obsahující název souboru vybraného v dialogovém okně souboru.

(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í název souboru filtr řetězec, který určuje volby, které se zobrazí v "Uložit jako typ souboru" nebo "Soubory typu" pole v dialogovém okně.

(Zděděno od FileDialog)
FilterIndex

Získá nebo nastaví index filtru aktuálně vybraného v dialogovém okně souboru.

(Zděděno od FileDialog)
InitialDirectory

Získá nebo nastaví počáteční adresář zobrazený soubor dialogové okno.

(Zděděno od FileDialog)
Instance

Získá popisovač instance Win32 pro aplikaci.

(Zděděno od FileDialog)
Multiselect

Získá nebo nastaví hodnotu označující, zda dialogové okno umožňuje vybrat více souborů.

OkRequiresInteraction

Získá nebo nastaví hodnotu označující, zda je tlačítko OK dialogového okna zakázáno, dokud uživatel nepřejde 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 označující, zda je zaškrtnuto políčko jen pro čtení.

RestoreDirectory

Získá nebo nastaví hodnotu označující, zda dialogové okno obnoví adresář dříve vybraný adresář před zavřením.

(Zděděno od FileDialog)
SafeFileName

Získá název souboru 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 označující, zda dialogové okno umožňuje výběr souborů jen pro čtení.

ShowHelp

Získá nebo nastaví hodnotu označující, zda je tlačítko Nápověda zobrazena v dialogovém okně souboru.

(Zděděno od FileDialog)
ShowHiddenFiles

Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí skryté a systémové soubory.

(Zděděno od FileDialog)
ShowPinnedPlaces

Získá nebo nastaví hodnotu označující, zda jsou zobrazeny položky zobrazené ve výchozím nastavení v navigačním podokně zobrazení.

(Zděděno od FileDialog)
ShowPreview

Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí 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í.

Site

Získá nebo nastaví ISite z Component.

(Zděděno od Component)
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 označující, zda dialogové okno přijímá pouze platné názvy souborů Win32.

(Zděděno od FileDialog)

Metody

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose(Boolean)

Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky.

(Zděděno od Component)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container

(Zděděno od Component)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Definuje společnou proceduru hooku dialogového okna, která je přepsána pro přidání konkrétních funkcí do dialogového okna souboru.

(Zděděno od FileDialog)
InitializeLifetimeService()
Zastaralé.

Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
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ích funkcí do společného dialogového okna.

(Zděděno od CommonDialog)
Reset()

Obnoví výchozí hodnoty všech vlastností.

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

Disposed

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody .

(Zděděno od Component)
FileOk

Vyvolá se, když uživatel klikne na tlačítko Otevřít nebo Uložit v dialogovém okně souboru.

(Zděděno od FileDialog)
HelpRequest

Vyvolá se, když uživatel klikne na tlačítko Nápověda ve společném dialogovém okně.

(Zděděno od CommonDialog)

Platí pro

Viz také