Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

OpenFileDialog-Klasse

Fordert den Benutzer auf, eine Datei zu öffnen. Diese Klasse kann nicht vererbt werden.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
        System.Windows.Forms.FileDialog
          System.Windows.Forms.OpenFileDialog

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public sealed class OpenFileDialog : FileDialog

Der OpenFileDialog-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode OpenFileDialog Initialisiert eine Instanz der OpenFileDialog-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft 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.)
Geschützte Eigenschaft CanRaiseEvents Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft Container Ruft den IContainer ab, der die Component enthält. (Von Component geerbt.)
Öffentliche Eigenschaft CustomPlaces Ruft die Auflistung der benutzerdefinierten Speicherorte für diese FileDialog-Instanz ab. (Von FileDialog geerbt.)
Öffentliche Eigenschaft DefaultExt Ruft die Standarddateinamenerweiterung ab oder legt diese fest. (Von FileDialog geerbt.)
Öffentliche Eigenschaft 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.)
Geschützte Eigenschaft DesignMode Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.)
Geschützte Eigenschaft Events Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.)
Öffentliche Eigenschaft FileName Ruft eine Zeichenfolge ab, die den im Dateidialogfeld ausgewählten Dateinamen enthält, oder legt diese fest. (Von FileDialog geerbt.)
Öffentliche Eigenschaft FileNames Ruft die Dateinamen aller im Dialogfeld ausgewählten Dateien ab. (Von FileDialog geerbt.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft FilterIndex Ruft den Index des derzeit im Dateidialogfeld ausgewählten Filters ab oder legt diesen fest. (Von FileDialog geerbt.)
Öffentliche Eigenschaft InitialDirectory Ruft das Ausgangsverzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest. (Von FileDialog geerbt.)
Geschützte Eigenschaft Instance Infrastruktur. Ruft das Win32-Instanzhandle für die Anwendung ab. (Von FileDialog geerbt.)
Öffentliche Eigenschaft Multiselect Ruft einen Wert ab, der angibt, ob im Dialogfeld mehrere Dateien ausgewählt werden können, oder legt diesen fest.
Geschützte Eigenschaft Options Infrastruktur. Ruft Werte für die Initialisierung von FileDialog ab. (Von FileDialog geerbt.)
Öffentliche Eigenschaft ReadOnlyChecked Ruft einen Wert ab, der angibt, ob das Kontrollkästchen für den Schreibschutz aktiviert ist, oder legt diesen fest.
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft SafeFileName Ruft den Dateinamen und die Erweiterung für die im Dialogfeld ausgewählte Datei ab. Der Dateiname enthält keine Pfadangabe.
Öffentliche Eigenschaft SafeFileNames Ruft ein Array von Dateinamen und Erweiterungen für alle ausgewählten Dateien im Dialogfeld ab. Die Dateinamen enthalten keine Pfadangaben.
Öffentliche Eigenschaft ShowHelp Ruft einen Wert ab, der angibt, ob im Dateidialogfeld die Schaltfläche Hilfe angezeigt wird, oder legt diesen Wert fest. (Von FileDialog geerbt.)
Öffentliche Eigenschaft ShowReadOnly Ruft einen Wert ab, der angibt, ob das Dialogfeld ein schreibgeschütztes Kontrollkästchen enthält, oder legt diesen fest.
Öffentliche Eigenschaft Site Ruft die ISite der Component ab oder legt diese fest. (Von Component geerbt.)
Öffentliche Eigenschaft SupportMultiDottedExtensions Ruft ab oder legt fest, ob das Dialogfeld Anzeige und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt. (Von FileDialog geerbt.)
Öffentliche Eigenschaft Tag Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Von CommonDialog geerbt.)
Öffentliche Eigenschaft Title Ruft den Titel des Dateidialogfelds ab oder legt diesen fest. (Von FileDialog geerbt.)
Öffentliche Eigenschaft ValidateNames Ruft einen Wert ab, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert, oder legt diesen fest. (Von FileDialog geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode 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.)
Öffentliche Methode Dispose() Gibt sämtliche von der Component verwendeten Ressourcen frei. (Von Component geerbt.)
Geschützte Methode Dispose(Boolean) Gibt die vom Component verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von Component geerbt.)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode 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.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetLifetimeService Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Geschützte Methode GetService Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode HookProc Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um dem Dateidialogfeld spezifische Funktionen hinzuzufügen. (Von FileDialog geerbt.)
Öffentliche Methode InitializeLifetimeService Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte Methode MemberwiseClone() Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode MemberwiseClone(Boolean) Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Geschützte Methode OnFileOk Löst das FileOk-Ereignis aus. (Von FileDialog geerbt.)
Geschützte Methode OnHelpRequest Löst das HelpRequest-Ereignis aus. (Von CommonDialog geerbt.)
Öffentliche Methode OpenFile Öffnet die vom Benutzer ausgewählte Datei schreibgeschützt. Die Datei wird durch die FileName-Eigenschaft angegeben.
Geschützte Methode OwnerWndProc Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Von CommonDialog geerbt.)
Öffentliche Methode Reset Setzt alle Eigenschaften auf die Standardwerte zurück. (Überschreibt FileDialog.Reset().)
Geschützte Methode RunDialog Infrastruktur. Gibt ein Standarddialogfeld an. (Von FileDialog geerbt.)
Öffentliche Methode ShowDialog() Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Von CommonDialog geerbt.)
Öffentliche Methode ShowDialog(IWin32Window) Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Von CommonDialog geerbt.)
Öffentliche Methode ToString Infrastruktur. Stellt eine Zeichenfolgenversion dieses Objekts bereit. (Von FileDialog geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Disposed Tritt ein, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.)
Öffentliches Ereignis FileOk Tritt ein, wenn der Benutzer in einem Dateidialogfeld auf die Schaltfläche Öffnen oder Speichern klickt. (Von FileDialog geerbt.)
Öffentliches Ereignis HelpRequest Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Von CommonDialog geerbt.)
Zum Seitenanfang

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);
        }
    }
}
    


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

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.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ