OpenFileDialog Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyświetla standardowe okno dialogowe z monitem użytkownika o otwarcie pliku. Klasa ta nie może być dziedziczona.
public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class OpenFileDialog : System.Windows.Forms.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic NotInheritable Class OpenFileDialog
Inherits FileDialog- Dziedziczenie
Przykłady
Poniższy przykład kodu tworzy element OpenFileDialog, ustawia kilka właściwości w celu zdefiniowania zachowania filtru rozszerzenia pliku i okna dialogowego, a następnie wyświetla okno dialogowe przy użyciu CommonDialog.ShowDialog metody . Przykład wymaga formularza umieszczonego Button na nim i odwołania do dodanej System.IO do niej przestrzeni nazw.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
Stream^ myStream;
OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;
openFileDialog1->InitialDirectory = "c:\\";
openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog1->FilterIndex = 2;
openFileDialog1->RestoreDirectory = true;
if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
{
if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
{
// Insert code to read the stream here.
myStream->Close();
}
}
}
var fileContent = string.Empty;
var filePath = string.Empty;
using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
openFileDialog.InitialDirectory = "c:\\";
openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog.FilterIndex = 2;
openFileDialog.RestoreDirectory = true;
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
//Get the path of specified file
filePath = openFileDialog.FileName;
//Read the contents of the file into a stream
var fileStream = openFileDialog.OpenFile();
using (StreamReader reader = new StreamReader(fileStream))
{
fileContent = reader.ReadToEnd();
}
}
}
MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Dim myStream As Stream = Nothing
Dim openFileDialog1 As New OpenFileDialog()
openFileDialog1.InitialDirectory = "c:\"
openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
openFileDialog1.FilterIndex = 2
openFileDialog1.RestoreDirectory = True
If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
Try
myStream = openFileDialog1.OpenFile()
If (myStream IsNot Nothing) Then
' Insert code to read the stream here.
End If
Catch Ex As Exception
MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
Finally
' Check this again, since we need to make sure we didn't throw an exception on open.
If (myStream IsNot Nothing) Then
myStream.Close()
End If
End Try
End If
End Sub
Uwagi
Ta klasa umożliwia sprawdzenie, czy plik istnieje i czy go otworzyć. Właściwość ShowReadOnly określa, czy pole wyboru tylko do odczytu jest wyświetlane w oknie dialogowym. Właściwość ReadOnlyChecked wskazuje, czy pole wyboru tylko do odczytu jest zaznaczone.
Większość podstawowych funkcji tej klasy znajduje się w FileDialog klasie.
W systemie operacyjnym od prawej do lewej ustaw właściwość formularza zawierająca RightToLeft , aby RightToLeft.Yes lokalizować ustawienia nazwy pliku okna dialogowego, Otwórz i Anuluj . Jeśli właściwość nie jest ustawiona na RightToLeft.Yes, zamiast tego jest używany tekst angielski.
Jeśli chcesz dać użytkownikowi możliwość wybrania folderu zamiast pliku, użyj FolderBrowserDialog zamiast tego.
Konstruktory
| OpenFileDialog() |
Inicjuje wystąpienie klasy OpenFileDialog. |
Właściwości
| AddExtension |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe 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 dodaje otwierany lub zapisywany plik na najnowszej liście. (Odziedziczone po FileDialog) |
| AutoUpgradeEnabled |
Pobiera lub ustawia wartość wskazującą, czy to FileDialog wystąpienie powinno automatycznie uaktualniać wygląd i zachowanie podczas uruchamiania w systemie Windows Vista. (Odziedziczone po FileDialog) |
| CanRaiseEvents |
Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component) |
| CheckFileExists |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która nie istnieje. |
| CheckPathExists |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa ścieżkę, która nie istnieje. (Odziedziczone po FileDialog) |
| ClientGuid |
Pobiera lub ustawia identyfikator GUID do skojarzenia z tym stanem okna dialogowego. Zazwyczaj stan, taki jak ostatni odwiedzony folder i położenie i rozmiar okna dialogowego, są utrwalane na podstawie nazwy pliku wykonywalnego. Określając identyfikator GUID, aplikacja może mieć różne stany utrwalone dla różnych wersji okna dialogowego w tej samej aplikacji (na przykład okno dialogowe importowania i otwarte okno dialogowe). Ta funkcja nie jest dostępna, jeśli aplikacja nie używa stylów wizualnych lub jeśli AutoUpgradeEnabled jest ustawiona na |
| Container |
Pobiera element IContainer zawierający element Component. (Odziedziczone po Component) |
| CustomPlaces |
Pobiera kolekcję miejsc niestandardowych dla tego FileDialog wystąpienia. (Odziedziczone po FileDialog) |
| DefaultExt |
Pobiera lub ustawia domyślne rozszerzenie nazwy pliku. (Odziedziczone po FileDialog) |
| DereferenceLinks |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zwraca lokalizację pliku, do których odwołuje się skrót, czy też zwraca lokalizację skrótu (lnk). (Odziedziczone po FileDialog) |
| DesignMode |
Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component) |
| Events |
Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component) |
| FileName |
Pobiera lub ustawia ciąg zawierający nazwę pliku wybraną w oknie dialogowym pliku. (Odziedziczone po FileDialog) |
| FileNames |
Pobiera nazwy plików wszystkich wybranych plików w oknie dialogowym. (Odziedziczone po FileDialog) |
| Filter |
Pobiera lub ustawia bieżący ciąg filtru nazwy pliku, który określa opcje wyświetlane w oknie dialogowym "Zapisz jako typ pliku" lub "Pliki typu". (Odziedziczone po FileDialog) |
| FilterIndex |
Pobiera lub ustawia indeks filtru aktualnie wybranego w oknie dialogowym pliku. (Odziedziczone po FileDialog) |
| InitialDirectory |
Pobiera lub ustawia początkowy katalog wyświetlany przez okno dialogowe pliku. (Odziedziczone po FileDialog) |
| Instance |
Pobiera dojście wystąpienia Win32 dla aplikacji. (Odziedziczone po FileDialog) |
| Multiselect |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe umożliwia wybranie wielu plików. |
| OkRequiresInteraction |
Pobiera lub ustawia wartość wskazującą, czy przycisk OK okna dialogowego jest wyłączony, dopóki użytkownik nie przejdzie do widoku lub edytuje nazwę pliku (jeśli ma to zastosowanie). (Odziedziczone po FileDialog) |
| Options |
Pobiera wartości w celu zainicjowania elementu FileDialog. (Odziedziczone po FileDialog) |
| ReadOnlyChecked |
Pobiera lub ustawia wartość wskazującą, czy zaznaczono pole wyboru tylko do odczytu. |
| RestoreDirectory |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe przywraca katalog do wcześniej wybranego katalogu przed zamknięciem. (Odziedziczone po FileDialog) |
| SafeFileName |
Pobiera nazwę i rozszerzenie pliku wybranego w oknie dialogowym. Nazwa pliku nie zawiera ścieżki. |
| SafeFileNames |
Pobiera tablicę nazw plików i rozszerzeń dla wszystkich wybranych plików w oknie dialogowym. Nazwy plików nie zawierają ścieżki. |
| SelectReadOnly |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zezwala na wybór plików tylko do odczytu. |
| ShowHelp |
Pobiera lub ustawia wartość wskazującą, czy przycisk Pomoc jest wyświetlany w oknie dialogowym pliku. (Odziedziczone po FileDialog) |
| ShowHiddenFiles |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ukryte i systemowe pliki. (Odziedziczone po FileDialog) |
| ShowPinnedPlaces |
Pobiera lub ustawia wartość wskazującą, czy elementy wyświetlane domyślnie w okienku nawigacji widoku są wyświetlane. (Odziedziczone po FileDialog) |
| ShowPreview |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla podgląd wybranych plików. |
| ShowReadOnly |
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zawiera pole wyboru tylko do odczytu. |
| Site |
Pobiera lub ustawia ISite element .Component (Odziedziczone po Component) |
| SupportMultiDottedExtensions |
Pobiera lub ustawia, czy okno dialogowe obsługuje wyświetlanie i zapisywanie plików z wieloma rozszerzeniami nazw plików. (Odziedziczone po FileDialog) |
| Tag |
Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Odziedziczone po CommonDialog) |
| Title |
Pobiera lub ustawia tytuł 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
| CreateObjRef(Type) |
Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject) |
| Dispose() |
Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component) |
| Dispose(Boolean) |
Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component) |
| 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) |
| GetLifetimeService() |
Przestarzałe.
Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
| GetService(Type) |
Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component) |
| GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definiuje wspólną procedurę zaczepienia okna dialogowego, która jest zastępowana w celu dodania określonych funkcji do okna dialogowego pliku. (Odziedziczone po FileDialog) |
| InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
| OnFileOk(CancelEventArgs) |
FileOk Zgłasza zdarzenie. (Odziedziczone po FileDialog) |
| OnHelpRequest(EventArgs) |
HelpRequest Zgłasza zdarzenie. (Odziedziczone po CommonDialog) |
| OpenFile() |
Otwiera plik wybrany przez użytkownika z uprawnieniem tylko do odczytu. Plik jest określony przez FileName właściwość . |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Definiuje procedurę okna właściciela, która jest zastępowana, aby dodać określone funkcje do wspólnego okna dialogowego. (Odziedziczone po CommonDialog) |
| Reset() |
Resetuje wszystkie właściwości do ich wartości domyślnych. |
| RunDialog(IntPtr) |
Określa typowe okno dialogowe. (Odziedziczone po FileDialog) |
| ShowDialog() |
Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Odziedziczone po CommonDialog) |
| ShowDialog(IWin32Window) |
Uruchamia wspólne okno dialogowe z określonym właścicielem. (Odziedziczone po CommonDialog) |
| ToString() |
Udostępnia wersję ciągu tego obiektu. (Odziedziczone po FileDialog) |
Zdarzenia
| Disposed |
Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component) |
| FileOk |
Występuje, gdy użytkownik kliknie przycisk Otwórz lub Zapisz w oknie dialogowym plik. (Odziedziczone po FileDialog) |
| HelpRequest |
Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Odziedziczone po CommonDialog) |
