Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

OpenFileDialog-Klasse

.NET Framework 4.5

Andere Versionen

Stellt ein Standarddialogfeld dar, in dem Benutzer einen Dateinamen für einen oder mehrere zu öffnende Dateien angeben können.

Vererbungshierarchie

System.Object
  Microsoft.Win32.CommonDialog
    Microsoft.Win32.FileDialog
      Microsoft.Win32.OpenFileDialog

Namespace: Microsoft.Win32
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS für XAML: Keinem xmlns zugeordnet.

Syntax

C++

public sealed class OpenFileDialog : FileDialog

XAML

Sie können diese verwaltete Klasse nicht in XAML deklarieren.

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

Konstruktoren

	Name	Beschreibung
	OpenFileDialog	Initialisiert eine neue Instanz der OpenFileDialog-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	AddExtension	Ruft einen Wert ab, der angibt, ob in einem Dateidialogfeld einem Dateinamen automatisch eine Dateinamenerweiterung hinzugefügt wird, wenn diese vom Benutzer nicht angegeben wurde, oder legt ihn fest. (Von FileDialog geerbt.)
	CheckFileExists	Ruft einen Wert ab, der angibt, ob in einem Dateidialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen nicht vorhandenen Dateinamen angibt, oder legt ihn fest. (Von FileDialog geerbt.)
	CheckPathExists	Ruft einen Wert ab, der angibt, ob Warnungen angezeigt werden, wenn der Benutzer ungültige Pfade und Dateinamen eingibt, oder legt ihn fest. (Von FileDialog geerbt.)
	CustomPlaces	Ruft die Liste benutzerdefinierter Speicherorte für Dateidialogfelder ab oder legt sie fest. (Von FileDialog geerbt.)
	DefaultExt	Ruft einen Wert ab, der die standardmäßige Erweiterungszeichenfolge zum Filtern der angezeigten Liste von Dateien angibt, oder legt diesen fest. (Von FileDialog geerbt.)
	DereferenceLinks	Ruft einen Wert ab, der angibt, ob ein Dateidialogfeld den Speicherort der Datei, auf die eine Verknüpfung verweist, oder den Speicherort der Verknüpfungsdatei (LNK) zurückgibt, oder legt diesen fest. (Von FileDialog geerbt.)
	FileName	Ruft eine Zeichenfolge ab, die den vollständigen Pfad der in einem Dateidialogfeld ausgewählten Datei enthält, oder legt diesen fest. (Von FileDialog geerbt.)
	FileNames	Ruft ein Array ab, das einen Dateinamen für jede ausgewählte Datei enthält. (Von FileDialog geerbt.)
	Filter	Ruft die Filterzeichenfolge ab, die angibt, welche Dateitypen aus dem OpenFileDialog bzw. aus dem SaveFileDialog angezeigt werden, oder legt diese fest. (Von FileDialog geerbt.)
	FilterIndex	Ruft den Index des derzeit in einem Dateidialogfeld ausgewählten Filters ab oder legt diesen fest. (Von FileDialog geerbt.)
	InitialDirectory	Ruft das Ausgangsverzeichnis ab, das von einem Dateidialogfeld angezeigt wird, oder legt dieses fest. (Von FileDialog geerbt.)
	Multiselect	Ruft eine Option ab, die angibt, ob OpenFileDialog Benutzern das Auswählen mehrerer Dateien ermöglicht, oder legt diese fest.
	ReadOnlyChecked	Ruft einen Wert ab, der angibt, ob das von OpenFileDialog angezeigte Kontrollkästchen für den Schreibschutz aktiviert ist, oder legt diesen fest.
	RestoreDirectory	Diese Eigenschaft ist nicht implementiert. (Von FileDialog geerbt.)
	SafeFileName	Ruft eine Zeichenfolge ab, die nur den Dateinamen für die ausgewählte Datei enthält. (Von FileDialog geerbt.)
	SafeFileNames	Ruft ein Array ab, das einen sicheren Dateinamen für jede ausgewählte Datei enthält. (Von FileDialog geerbt.)
	ShowReadOnly	Ruft einen Wert ab, der angibt, ob OpenFileDialog ein Kontrollkästchen für den Schreibschutz enthält, oder legt diesen fest.
	Tag	Ruft ein Objekt ab, das dem Dialogfeld zugeordnet ist, oder legt dieses fest. Damit verfügen Sie über die Möglichkeit, an das Dialogfeld ein beliebiges Objekt anzufügen. (Von CommonDialog geerbt.)
	Title	Ruft den Text ab, der in der Titelleiste eines Dateidialogfelds angezeigt wird, 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 ihn fest. (Von FileDialog geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	OpenFile	Öffnet einen schreibgeschützten Stream für die Datei, die vom Benutzer mit OpenFileDialog ausgewählt wurde.
	OpenFiles	Erstellt ein Array, das für jede Datei, die vom Benutzer mit OpenFileDialog ausgewählt wird, einen schreibgeschützten Stream enthält.
	Reset	Setzt alle OpenFileDialog-Eigenschaften auf ihre Standardwerte zurück. (Überschreibt FileDialog.Reset().)
	ShowDialog()	Zeigt ein Standarddialogfeld an. (Von CommonDialog geerbt.)
	ShowDialog(Window)	Zeigt ein Standarddialogfeld an. (Von CommonDialog geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die ein Dateidialogfeld darstellt. (Von FileDialog geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	FileOk	Tritt auf, wenn ein Benutzer einen Dateinamen durch Klicken auf die Schaltfläche Öffnen im OpenFileDialog bzw. die Schaltfläche Speichern im SaveFileDialog auswählt. (Von FileDialog geerbt.)

Zum Seitenanfang

Hinweise

Die folgende Abbildung zeigt ein OpenFileDialog für Windows Vista.

Ab Windows Vista besitzen die Dateidialogfelder zum Öffnen und Speichern einen Linkfavoriten-Bereich auf der linken Seite des Dialogfelds, das dem Benutzer erlaubt, schnell zu einem anderen Speicherort zu navigieren. Diese Links werden als benutzerdefinierte Orte bezeichnet. Legen Sie diese Liste der Links mithilfe der CustomPlaces-Eigenschaft fest.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein OpenFileDialog, das einen Standarddateinamen und -erweiterungstyp enthält, erstellt wird.


// 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 == true)
{
    // Open document
    string filename = dlg.FileName;
}

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Win32-Namespace

SaveFileDialog

Weitere Ressourcen

Übersicht über Dialogfelder

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN