OpenFileDialog Klas

Definitie

Naamruimte:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Bron:: OpenFileDialog.cs

Bron:: OpenFileDialog.cs

Bron:: OpenFileDialog.cs

Bron:: OpenFileDialog.cs

Bron:: OpenFileDialog.cs

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt een standaarddialoogvenster weergegeven waarin de gebruiker wordt gevraagd een bestand te openen. Deze klasse kan niet worden overgenomen.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Overname: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
OpenFileDialog

Voorbeelden

In het volgende codevoorbeeld maakt u een OpenFileDialog, stelt u verschillende eigenschappen in om het filter en het dialoogvenster te definiëren en wordt het dialoogvenster met behulp van de CommonDialog.ShowDialog methode weergegeven. Voor het voorbeeld is een formulier vereist met een Button geplaatst formulier en een verwijzing naar de System.IO naamruimte die eraan is toegevoegd.

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

Opmerkingen

Met deze klasse kunt u controleren of er een bestand bestaat en het bestand openen. De ShowReadOnly eigenschap bepaalt of een alleen-lezen selectievakje wordt weergegeven in het dialoogvenster. De ReadOnlyChecked eigenschap geeft aan of het selectievakje Alleen-lezen is ingeschakeld.

De meeste kernfunctionaliteit voor deze klasse vindt u in de FileDialog klasse.

Stel in een besturingssysteem van rechts naar links de eigenschap van RightToLeft het formulier in om de knoppen RightToLeft.Yes, Openen en Annuleren van het dialoogvenster te lokaliseren. Als de eigenschap niet is ingesteld op RightToLeft.Yes, wordt in plaats daarvan Engelse tekst gebruikt.

Als u de gebruiker de mogelijkheid wilt geven om een map te selecteren in plaats van een bestand, gebruikt FolderBrowserDialog u in plaats daarvan.

Constructors

Name	Description
OpenFileDialog()	Initialiseert een exemplaar van de OpenFileDialog klasse.

Eigenschappen

Name	Description
AddExtension	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of in het dialoogvenster automatisch een extensie wordt toegevoegd aan een bestandsnaam als de gebruiker de extensie weglaat. (Overgenomen van FileDialog)
AddToRecent	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster het bestand toevoegt dat wordt geopend of opgeslagen in de recente lijst. (Overgenomen van FileDialog)
AutoUpgradeEnabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of dit FileDialog-exemplaar het uiterlijk en gedrag automatisch moet upgraden wanneer deze wordt uitgevoerd op Windows Vista. (Overgenomen van FileDialog)
CanRaiseEvents	Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component)
CheckFileExists	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of in het dialoogvenster een waarschuwing wordt weergegeven als de gebruiker een bestandsnaam opgeeft die niet bestaat.
CheckPathExists	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of in het dialoogvenster een waarschuwing wordt weergegeven als de gebruiker een pad opgeeft dat niet bestaat. (Overgenomen van FileDialog)
ClientGuid	Hiermee wordt de GUID opgehaald of ingesteld om aan deze dialoogvensterstatus te koppelen. Normaal gesproken wordt de status zoals de laatst bezochte map en de positie en grootte van het dialoogvenster behouden op basis van de naam van het uitvoerbare bestand. Door een GUID op te geven, kan een toepassing verschillende persistente statussen hebben voor verschillende versies van het dialoogvenster binnen dezelfde toepassing (bijvoorbeeld een importdialoogvenster en een geopend dialoogvenster). Deze functionaliteit is niet beschikbaar als een toepassing geen visuele stijlen gebruikt of als AutoUpgradeEnabled deze is ingesteld op `false`. (Overgenomen van FileDialog)
Container	Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component)
CustomPlaces	Hiermee haalt u de verzameling aangepaste locaties voor dit FileDialog exemplaar op. (Overgenomen van FileDialog)
DefaultExt	Hiermee haalt u de standaardbestandsextensie op of stelt u deze in. (Overgenomen van FileDialog)
DereferenceLinks	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster de locatie retourneert van het bestand waarnaar wordt verwezen door de snelkoppeling of de locatie van de snelkoppeling (.lnk). (Overgenomen van FileDialog)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is. (Overgenomen van Component)
Events	Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld. (Overgenomen van Component)
FileName	Hiermee haalt u een tekenreeks op die de bestandsnaam bevat die is geselecteerd in het dialoogvenster Bestand. (Overgenomen van FileDialog)
FileNames	Hiermee haalt u de bestandsnamen op van alle geselecteerde bestanden in het dialoogvenster. (Overgenomen van FileDialog)
Filter	Hiermee haalt u de filtertekenreeks voor de huidige bestandsnaam op of stelt u deze in. Hiermee bepaalt u de opties die worden weergegeven in het vak Opslaan als bestandstype of bestandstype in het dialoogvenster. (Overgenomen van FileDialog)
FilterIndex	Hiermee haalt u de index op van het filter dat momenteel is geselecteerd in het dialoogvenster Bestand. (Overgenomen van FileDialog)
InitialDirectory	Hiermee wordt de eerste map opgehaald of ingesteld die wordt weergegeven in het dialoogvenster Bestand. (Overgenomen van FileDialog)
Instance	Hiermee haalt u de Win32-exemplaargreep voor de toepassing op. (Overgenomen van FileDialog)
Multiselect	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of in het dialoogvenster meerdere bestanden kunnen worden geselecteerd.
OkRequiresInteraction	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de knop OK van het dialoogvenster is uitgeschakeld totdat de gebruiker door de weergave navigeert of de bestandsnaam bewerkt (indien van toepassing). (Overgenomen van FileDialog)
Options	Hiermee worden waarden opgehaald voor het initialiseren van de FileDialog. (Overgenomen van FileDialog)
ReadOnlyChecked	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het selectievakje Alleen-lezen is ingeschakeld.
RestoreDirectory	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster de map herstelt naar de eerder geselecteerde map voordat u deze sluit. (Overgenomen van FileDialog)
SafeFileName	Hiermee haalt u de bestandsnaam en extensie op voor het bestand dat in het dialoogvenster is geselecteerd. De bestandsnaam bevat het pad niet.
SafeFileNames	Hiermee haalt u een matrix met bestandsnamen en extensies op voor alle geselecteerde bestanden in het dialoogvenster. De bestandsnamen bevatten het pad niet.
SelectReadOnly	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster selectie van alleen-lezenbestanden toestaat.
ShowHelp	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Knop Help wordt weergegeven in het dialoogvenster Bestand. (Overgenomen van FileDialog)
ShowHiddenFiles	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster verborgen en systeembestanden weergeeft. (Overgenomen van FileDialog)
ShowPinnedPlaces	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de items die standaard worden weergegeven in het navigatiedeelvenster van de weergave, worden weergegeven. (Overgenomen van FileDialog)
ShowPreview	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of in het dialoogvenster een voorbeeld voor geselecteerde bestanden wordt weergegeven.
ShowReadOnly	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster een selectievakje met het kenmerk Alleen-lezen bevat.
Site	Haalt of stelt de ISite van de Component. (Overgenomen van Component)
SupportMultiDottedExtensions	Hiermee haalt u op of stelt u in of het dialoogvenster ondersteuning biedt voor het weergeven en opslaan van bestanden met meerdere bestandsnaamextensies. (Overgenomen van FileDialog)
Tag	Hiermee wordt een object opgehaald of ingesteld dat gegevens over het besturingselement bevat. (Overgenomen van CommonDialog)
Title	Hiermee haalt u de titel van het dialoogvenster bestand op of stelt u deze in. (Overgenomen van FileDialog)
ValidateNames	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het dialoogvenster alleen geldige Win32-bestandsnamen accepteert. (Overgenomen van FileDialog)

Methoden

Name	Description
CreateObjRef(Type)	Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject)
Dispose()	Alle resources die worden gebruikt door de Component. (Overgenomen van Component)
Dispose(Boolean)	Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Component)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLifetimeService()	Verouderd. Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetService(Type)	Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container. (Overgenomen van Component)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Hiermee definieert u de algemene dialoogvensterhookprocedure die wordt overschreven om specifieke functionaliteit toe te voegen aan het dialoogvenster Bestand. (Overgenomen van FileDialog)
InitializeLifetimeService()	Verouderd. Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MemberwiseClone(Boolean)	Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject)
OnFileOk(CancelEventArgs)	Hiermee wordt de FileOk gebeurtenis gegenereerd. (Overgenomen van FileDialog)
OnHelpRequest(EventArgs)	Hiermee wordt de HelpRequest gebeurtenis gegenereerd. (Overgenomen van CommonDialog)
OpenFile()	Hiermee opent u het bestand dat is geselecteerd door de gebruiker, met de machtiging Alleen-lezen. Het bestand wordt opgegeven door de FileName eigenschap.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Hiermee definieert u de procedure voor het eigenaarvenster dat wordt overschreven om specifieke functionaliteit toe te voegen aan een algemeen dialoogvenster. (Overgenomen van CommonDialog)
Reset()	Hiermee stelt u alle eigenschappen opnieuw in op de standaardwaarden.
RunDialog(IntPtr)	Hiermee geeft u een algemeen dialoogvenster. (Overgenomen van FileDialog)
ShowDialog()	Hiermee wordt een algemeen dialoogvenster met een standaardeigenaar uitgevoerd. (Overgenomen van CommonDialog)
ShowDialog(IWin32Window)	Hiermee wordt een algemeen dialoogvenster met de opgegeven eigenaar uitgevoerd. (Overgenomen van CommonDialog)
ToString()	Biedt een tekenreeksversie van dit object. (Overgenomen van FileDialog)

gebeurtenis

Name	Description
Disposed	Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component)
FileOk	Treedt op wanneer de gebruiker op de knop Openen of Opslaan in een dialoogvenster bestand klikt. (Overgenomen van FileDialog)
HelpRequest	Treedt op wanneer de gebruiker op de knop Help in een algemeen dialoogvenster klikt. (Overgenomen van CommonDialog)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?