OpenFileDialog Třída

Definice

Obor názvů:

Microsoft.Win32

Sestavení:

PresentationFramework.dll

Představuje společné dialogové okno, které uživateli umožňuje zadat název souboru pro jeden nebo více souborů k otevření.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class OpenFileDialog : Microsoft.Win32.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Dědičnost

Object

CommonDialog

FileDialog

OpenFileDialog

Příklady

Následující příklad ukazuje, jak vytvořit OpenFileDialog , který obsahuje výchozí název souboru a typ přípony.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result.Value)
{
    // Open document
    string filename = dlg.FileName;
}

' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dlg.FileName
End If

Poznámky

Tuto spravovanou třídu nelze deklarovat v jazyce XAML.

Konstruktory

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

Vlastnosti

Name	Description
AddExtension	Získá nebo nastaví hodnotu určující, zda dialogové okno souboru automaticky přidá příponu k názvu souboru, pokud uživatel vynechá příponu. (Zděděno od FileDialog)
CheckFileExists	Získá nebo nastaví hodnotu určující, zda dialogové okno souboru zobrazí upozornění, pokud uživatel určuje název souboru, který neexistuje. (Zděděno od FileDialog)
CheckPathExists	Získá nebo nastaví hodnotu, která určuje, zda se zobrazí upozornění, pokud uživatel zadá neplatné cesty a názvy souborů. (Zděděno od FileDialog)
CustomPlaces	Získá nebo nastaví seznam vlastních míst pro dialogová okna souboru. (Zděděno od FileDialog)
DefaultExt	Získá nebo nastaví hodnotu, která určuje výchozí rozšiřující řetězec, který se má použít k filtrování seznamu zobrazených souborů. (Zděděno od FileDialog)
DereferenceLinks	Získá nebo nastaví hodnotu určující, zda dialogové okno souboru vrátí buď umístění souboru odkazovaného zástupcem nebo umístěním souboru zástupce (.lnk). (Zděděno od FileDialog)
FileName	Získá nebo nastaví řetězec obsahující úplnou cestu k souboru vybraného v dialogovém okně souboru. (Zděděno od FileDialog)
FileNames	Získá pole, které obsahuje jeden název souboru pro každý vybraný soubor. (Zděděno od FileDialog)
Filter	Získá nebo nastaví řetězec filtru, který určuje, jaké typy souborů jsou zobrazeny z OpenFileDialog nebo SaveFileDialog. (Zděděno od FileDialog)
FilterIndex	Získá nebo nastaví index filtru aktuálně vybraný v dialogovém okně souboru. (Zděděno od FileDialog)
InitialDirectory	Získá nebo nastaví počáteční adresář, který je zobrazen v dialogovém okně souboru. (Zděděno od FileDialog)
Multiselect	Získá nebo nastaví možnost určující, zda OpenFileDialog umožňuje uživatelům vybrat více souborů.
Options	Získá Win32 běžné příznaky souboru dialogové okno, které jsou používány soubor dialogy pro inicializaci. (Zděděno od FileDialog)
ReadOnlyChecked	Získá nebo nastaví hodnotu označující, zda je zaškrtnuté OpenFileDialog políčko jen pro čtení.
RestoreDirectory	Tato vlastnost není implementována. (Zděděno od FileDialog)
SafeFileName	Získá řetězec, který obsahuje pouze název souboru pro vybraný soubor. (Zděděno od FileDialog)
SafeFileNames	Získá pole, které obsahuje jeden bezpečný název souboru pro každý vybraný soubor. (Zděděno od FileDialog)
ShowReadOnly	Získá nebo nastaví hodnotu označující, zda OpenFileDialog obsahuje zaškrtávací políčko jen pro čtení.
Tag	Získá nebo nastaví objekt přidružený k dialogu. To umožňuje připojit k dialogovému okně libovolný objekt. (Zděděno od CommonDialog)
Title	Získá nebo nastaví text, který se zobrazí v záhlaví 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
CheckPermissionsToShowDialog()	Určuje, zda existují dostatečná oprávnění pro zobrazení dialogového okna. (Zděděno od CommonDialog)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru háku běžného dialogového okna souboru, která se přepíše, aby se do dialogového okna souboru přidaly společné funkce. (Zděděno od FileDialog)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnFileOk(CancelEventArgs)	FileOk Vyvolá událost. (Zděděno od FileDialog)
OpenFile()	Otevře datový proud jen pro čtení pro soubor, který je vybrán uživatelem pomocí OpenFileDialog.
OpenFiles()	Vytvoří pole, které obsahuje jeden datový proud jen pro čtení pro každý soubor vybraný uživatelem pomocí OpenFileDialog.
Reset()	Obnoví všechny OpenFileDialog vlastnosti na výchozí hodnoty.
RunDialog(IntPtr)	RunDialog(IntPtr) je volána k zobrazení dialogového okna souboru v odvozené třídě, například OpenFileDialog a SaveFileDialog. (Zděděno od FileDialog)
ShowDialog()	Zobrazí běžné dialogové okno. (Zděděno od CommonDialog)
ShowDialog(Window)	Zobrazí běžné dialogové okno. (Zděděno od CommonDialog)
ToString()	Vrátí řetězec, který představuje dialogové okno souboru. (Zděděno od FileDialog)

Událost

Name	Description
FileOk	Nastane, když uživatel vybere název souboru kliknutím na tlačítko Otevřít nebo OpenFileDialoguložit tlačítko .SaveFileDialog (Zděděno od FileDialog)

Viz také

• SaveFileDialog