OpenFileDialog Klasa

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

PresentationFramework.dll

Reprezentuje typowe okno dialogowe, które umożliwia użytkownikowi określenie nazwy pliku dla co najmniej jednego pliku do otwarcia.

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

Dziedziczenie

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

Przykłady

W poniższym przykładzie pokazano, jak utworzyć obiekt OpenFileDialog zawierający domyślną nazwę pliku i typ rozszerzenia.

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

' 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

Uwagi

Nie można zadeklarować tej klasy zarządzanej w języku XAML.

Konstruktory

OpenFileDialog()

Inicjuje nowe wystąpienie klasy OpenFileDialog.

Właściwości

AddExtension	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku automatycznie dodaje rozszerzenie do nazwy pliku, jeśli użytkownik pomija rozszerzenie. (Odziedziczone po FileDialog)
AddToRecent	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe spowoduje dodanie otwieranego lub zapisywanego elementu na liście ostatnio używanych dokumentów. (Odziedziczone po CommonItemDialog)
CheckFileExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która nie istnieje. (Odziedziczone po FileDialog)
CheckPathExists	Pobiera lub ustawia wartość określającą, czy ostrzeżenia są wyświetlane, jeśli użytkownik wpisze nieprawidłowe ścieżki i nazwy plików. (Odziedziczone po FileDialog)
ClientGuid	Pobiera lub ustawia identyfikator GUID do skojarzenia ze stanem utrwalonego okna dialogowego. (Odziedziczone po CommonItemDialog)
CustomPlaces	Pobiera lub ustawia listę niestandardowych miejsc dla okien dialogowych plików. (Odziedziczone po FileDialog)
DefaultDirectory	Pobiera lub ustawia katalog wyświetlany przez okno dialogowe pliku, jeśli nie jest dostępna żadna ostatnio używana wartość katalogu. (Odziedziczone po CommonItemDialog)
DefaultExt	Pobiera lub ustawia wartość określającą domyślny ciąg rozszerzenia, który ma być używany do filtrowania listy wyświetlanych plików. (Odziedziczone po FileDialog)
DereferenceLinks	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe pliku zwraca lokalizację pliku, do których odwołuje się skrót, czy lokalizację pliku skrótu (.lnk). (Odziedziczone po FileDialog)
FileName	Pobiera lub ustawia ciąg zawierający pełną ścieżkę pliku wybranego w oknie dialogowym pliku. (Odziedziczone po FileDialog)
FileNames	Pobiera tablicę zawierającą jedną nazwę pliku dla każdego wybranego pliku. (Odziedziczone po FileDialog)
Filter	Pobiera lub ustawia ciąg filtru, który określa, jakie typy plików są wyświetlane z elementu OpenFileDialog lub SaveFileDialog. (Odziedziczone po FileDialog)
FilterIndex	Pobiera lub ustawia indeks filtru aktualnie wybranego w oknie dialogowym pliku. (Odziedziczone po FileDialog)
ForcePreviewPane	Pobiera lub ustawia flagę opcji wskazującą, czy okno dialogowe wymusza włączenie okienka podglądu.
InitialDirectory	Pobiera lub ustawia początkowy katalog wyświetlany przez okno dialogowe pliku. (Odziedziczone po FileDialog)
Multiselect	Pobiera lub ustawia opcję wskazującą, czy OpenFileDialog użytkownicy mogą wybierać wiele plików.
Options	Pobiera flagi okien dialogowych typowych plików Win32, które są używane przez okna dialogowe plików do inicjowania. (Odziedziczone po FileDialog)
ReadOnlyChecked	Pobiera lub ustawia wartość wskazującą, czy pole wyboru tylko do odczytu wyświetlane przez OpenFileDialog jest zaznaczone.
RestoreDirectory	Ta właściwość nie jest zaimplementowana. (Odziedziczone po FileDialog)
RootDirectory	Pobiera lub ustawia katalog wyświetlany jako katalog główny nawigacji dla okna dialogowego. (Odziedziczone po CommonItemDialog)
SafeFileName	Pobiera ciąg zawierający tylko nazwę pliku dla wybranego pliku. (Odziedziczone po FileDialog)
SafeFileNames	Pobiera tablicę zawierającą jedną bezpieczną nazwę pliku dla każdego wybranego pliku. (Odziedziczone po FileDialog)
ShowHiddenItems	Pobiera lub ustawia wartość wskazującą, czy w oknie dialogowym będą wyświetlane ukryte i systemowe elementy niezależnie od preferencji użytkownika. (Odziedziczone po CommonItemDialog)
ShowReadOnly	Pobiera lub ustawia wartość wskazującą, czy OpenFileDialog zawiera pole wyboru tylko do odczytu.
Tag	Pobiera lub ustawia obiekt skojarzony z oknie dialogowym. Zapewnia to możliwość dołączania dowolnego obiektu do okna dialogowego. (Odziedziczone po CommonDialog)
Title	Pobiera lub ustawia tekst wyświetlany na pasku tytułu okna dialogowego pliku. (Odziedziczone po FileDialog)
ValidateNames	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe akceptuje tylko prawidłowe nazwy plików Win32. (Odziedziczone po FileDialog)

Metody

CheckPermissionsToShowDialog()	Określa, czy istnieją wystarczające uprawnienia do wyświetlania okna dialogowego. (Odziedziczone po CommonDialog)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje typową procedurę zaczepienia okna dialogowego pliku, która jest zastępowana w celu dodania typowych funkcji do okna dialogowego pliku. (Odziedziczone po FileDialog)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnFileOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog)
OnItemOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog)
OpenFile()	Otwiera strumień tylko do odczytu dla pliku wybranego przez użytkownika przy użyciu polecenia OpenFileDialog.
OpenFiles()	Tworzy tablicę zawierającą jeden strumień tylko do odczytu dla każdego pliku wybranego przez użytkownika przy użyciu polecenia OpenFileDialog.
Reset()	Resetuje wszystkie OpenFileDialog właściwości do ich wartości domyślnych.
RunDialog(IntPtr)	RunDialog(IntPtr) element jest wywoływany w celu wyświetlenia okna dialogowego pliku w klasie pochodnej, takiej jak OpenFileDialog i SaveFileDialog. (Odziedziczone po FileDialog)
ShowDialog()	Wyświetla typowe okno dialogowe. (Odziedziczone po CommonDialog)
ShowDialog(Window)	Wyświetla typowe okno dialogowe. (Odziedziczone po CommonDialog)
ToString()	Zwraca ciąg reprezentujący okno dialogowe pliku. (Odziedziczone po FileDialog)

Zdarzenia

FileOk

Występuje, gdy użytkownik wybierze nazwę pliku, klikając przycisk OpenFileDialogOtwórz lub przycisk Zapisz .SaveFileDialog (Odziedziczone po FileDialog)

Zobacz też

• SaveFileDialog