OpenFileDialog Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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::FileDialogpublic sealed class OpenFileDialog : System.Windows.Forms.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic 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 |
| 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) |
