Udostępnij za pośrednictwem


OpenFileDialog Klasa

Definicja

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
OpenFileDialog
Dziedziczenie

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)

Dotyczy

Zobacz też