Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
OpenFileDialog-Klasse
Fordert den Benutzer auf, eine Datei zu öffnen. Diese Klasse kann nicht vererbt werden.
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.CommonDialog
System.Windows.Forms.FileDialog
System.Windows.Forms.OpenFileDialog
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Der OpenFileDialog-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
OpenFileDialog | Initialisiert eine Instanz der OpenFileDialog-Klasse. |
| Name | Beschreibung | |
|---|---|---|
|
AddExtension | Ruft einen Wert ab, der angibt, ob einem Dateinamen im Dialogfeld automatisch eine Erweiterung hinzugefügt wird, wenn der Benutzer keine Erweiterung angibt, oder legt diesen fest. (Von FileDialog geerbt.) |
|
AutoUpgradeEnabled | Ruft einen Wert ab, der angibt, ob diese FileDialog-Instanz automatisch Darstellung und Verhalten aktualisieren soll, wenn Sie unter Windows Vista ausgeführt wird, oder legt diesen Wert fest. (Von FileDialog geerbt.) |
|
CanRaiseEvents | Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.) |
|
CheckFileExists | Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer den Namen einer nicht vorhandenen Datei angibt, oder legt diesen fest. (Überschreibt FileDialog.CheckFileExists.) |
|
CheckPathExists | Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen nicht vorhandenen Pfad angibt, oder legt diesen fest. (Von FileDialog geerbt.) |
|
Container | Ruft den IContainer ab, der die Component enthält. (Von Component geerbt.) |
|
CustomPlaces | Ruft die Auflistung der benutzerdefinierten Speicherorte für diese FileDialog-Instanz ab. (Von FileDialog geerbt.) |
|
DefaultExt | Ruft die Standarddateinamenerweiterung ab oder legt diese fest. (Von FileDialog geerbt.) |
|
DereferenceLinks | Ruft einen Wert ab, der angibt, ob das Dialogfeld den Speicherort der Datei, auf die die Verknüpfung verweist, oder den Speicherort der Verknüpfung (.lnk) zurückgibt, oder legt diesen fest. (Von FileDialog geerbt.) |
|
DesignMode | Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.) |
|
Events | Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.) |
|
FileName | Ruft eine Zeichenfolge ab, die den im Dateidialogfeld ausgewählten Dateinamen enthält, oder legt diese fest. (Von FileDialog geerbt.) |
|
FileNames | Ruft die Dateinamen aller im Dialogfeld ausgewählten Dateien ab. (Von FileDialog geerbt.) |
|
Filter | Ruft die aktuelle Filterzeichenfolge für Dateinamen ab, die die im Dialogfeld im Feld "Speichern unter" oder "Dateityp" angezeigte Auswahl bestimmt, oder legt diese fest. (Von FileDialog geerbt.) |
|
FilterIndex | Ruft den Index des derzeit im Dateidialogfeld ausgewählten Filters ab oder legt diesen fest. (Von FileDialog geerbt.) |
|
InitialDirectory | Ruft das Ausgangsverzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest. (Von FileDialog geerbt.) |
|
Instance | Infrastruktur. Ruft das Win32-Instanzhandle für die Anwendung ab. (Von FileDialog geerbt.) |
|
Multiselect | Ruft einen Wert ab, der angibt, ob im Dialogfeld mehrere Dateien ausgewählt werden können, oder legt diesen fest. |
|
Options | Infrastruktur. Ruft Werte für die Initialisierung von FileDialog ab. (Von FileDialog geerbt.) |
|
ReadOnlyChecked | Ruft einen Wert ab, der angibt, ob das Kontrollkästchen für den Schreibschutz aktiviert ist, oder legt diesen fest. |
|
RestoreDirectory | Ruft einen Wert ab, der angibt, ob das Dialogfeld das vor dem Schließen aktuelle Verzeichnis wiederherstellt, oder legt diesen fest. (Von FileDialog geerbt.) |
|
SafeFileName | Ruft den Dateinamen und die Erweiterung für die im Dialogfeld ausgewählte Datei ab. Der Dateiname enthält keine Pfadangabe. |
|
SafeFileNames | Ruft ein Array von Dateinamen und Erweiterungen für alle ausgewählten Dateien im Dialogfeld ab. Die Dateinamen enthalten keine Pfadangaben. |
|
ShowHelp | Ruft einen Wert ab, der angibt, ob im Dateidialogfeld die Schaltfläche Hilfe angezeigt wird, oder legt diesen Wert fest. (Von FileDialog geerbt.) |
|
ShowReadOnly | Ruft einen Wert ab, der angibt, ob das Dialogfeld ein schreibgeschütztes Kontrollkästchen enthält, oder legt diesen fest. |
|
Site | Ruft die ISite der Component ab oder legt diese fest. (Von Component geerbt.) |
|
SupportMultiDottedExtensions | Ruft ab oder legt fest, ob das Dialogfeld Anzeige und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt. (Von FileDialog geerbt.) |
|
Tag | Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Von CommonDialog geerbt.) |
|
Title | Ruft den Titel des Dateidialogfelds ab oder legt diesen fest. (Von FileDialog geerbt.) |
|
ValidateNames | Ruft einen Wert ab, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert, oder legt diesen fest. (Von FileDialog geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
CreateObjRef | Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.) |
|
Dispose() | Gibt sämtliche von der Component verwendeten Ressourcen frei. (Von Component geerbt.) |
|
Dispose(Boolean) | Gibt die vom Component verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von Component geerbt.) |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch die Garbage Collection wieder zugänglich gemacht wird. (Von Component geerbt.) |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetLifetimeService | Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.) |
|
GetService | Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
HookProc | Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um dem Dateidialogfeld spezifische Funktionen hinzuzufügen. (Von FileDialog geerbt.) |
|
InitializeLifetimeService | Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.) |
|
MemberwiseClone() | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
MemberwiseClone(Boolean) | Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.) |
|
OnFileOk | Löst das FileOk-Ereignis aus. (Von FileDialog geerbt.) |
|
OnHelpRequest | Löst das HelpRequest-Ereignis aus. (Von CommonDialog geerbt.) |
|
OpenFile | Öffnet die vom Benutzer ausgewählte Datei schreibgeschützt. Die Datei wird durch die FileName-Eigenschaft angegeben. |
|
OwnerWndProc | Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Von CommonDialog geerbt.) |
|
Reset | Setzt alle Eigenschaften auf die Standardwerte zurück. (Überschreibt FileDialog.Reset().) |
|
RunDialog | Infrastruktur. Gibt ein Standarddialogfeld an. (Von FileDialog geerbt.) |
|
ShowDialog() | Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Von CommonDialog geerbt.) |
|
ShowDialog(IWin32Window) | Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Von CommonDialog geerbt.) |
|
ToString | Infrastruktur. Stellt eine Zeichenfolgenversion dieses Objekts bereit. (Von FileDialog geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Disposed | Tritt ein, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.) |
|
FileOk | Tritt ein, wenn der Benutzer in einem Dateidialogfeld auf die Schaltfläche Öffnen oder Speichern klickt. (Von FileDialog geerbt.) |
|
HelpRequest | Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Von CommonDialog geerbt.) |
Mithilfe dieser Klasse können Sie überprüfen, ob eine Datei vorhanden ist, und diese Datei öffnen. Durch die ShowReadOnly-Eigenschaft wird bestimmt, ob im Dialogfeld ein schreibgeschütztes Kontrollkästchen angezeigt wird. Die ReadOnlyChecked-Eigenschaft gibt an, ob das schreibgeschützte Kontrollkästchen aktiviert ist.
Die meisten Funktionen für diese Klasse können über die FileDialog-Klasse aufgerufen werden.
Wenn Sie eine Möglichkeit zum Auswählen eines Ordners anstelle einer Datei zur Verfügung stellen möchten, verwenden Sie stattdessen FolderBrowserDialog.
Im folgenden Codebeispiel wird ein OpenFileDialog erstellt, mehrere Eigenschaften werden festgelegt, und das Dialogfeld wird mithilfe der CommonDialog.ShowDialog-Methode angezeigt. Voraussetzung für dieses Beispiel ist ein Formular, auf dem Button platziert und dem der System.IO-Namespace hinzugefügt wurde.
private void button1_Click(object sender, System.EventArgs e) { Stream myStream = null; OpenFileDialog openFileDialog1 = new OpenFileDialog(); openFileDialog1.InitialDirectory = "c:\\" ; openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ; openFileDialog1.FilterIndex = 2 ; openFileDialog1.RestoreDirectory = true ; if(openFileDialog1.ShowDialog() == DialogResult.OK) { try { if ((myStream = openFileDialog1.OpenFile()) != null) { using (myStream) { // Insert code to read the stream here. } } } catch (Exception ex) { MessageBox.Show("Error: Could not read file from disk. Original error: " + ex.Message); } } }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.