FileDialog.Filter Eigenschap

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };

public string Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

Waarde van eigenschap

De opties voor het filteren van bestanden die beschikbaar zijn in het dialoogvenster.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt gebruikgemaakt van de OpenFileDialog implementatie van het maken en illustreren van FileDialog het maken, instellen van eigenschappen en het weergeven van het dialoogvenster. In het voorbeeld worden de Filter en FilterIndex eigenschappen gebruikt om een lijst met filters voor de gebruiker op te geven. Voor het voorbeeld is een formulier vereist met een Button geplaatst formulier en 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

Voor elke filteroptie bevat de filtertekenreeks een beschrijving van het filter, gevolgd door de verticale balk (|) en het filterpatroon. De tekenreeksen voor verschillende filteropties worden gescheiden door de verticale balk.

Hier volgt een voorbeeld van een filtertekenreeks:

Text files (*.txt)|*.txt|All files (*.*)|*.*

U kunt verschillende filterpatronen toevoegen aan een filter door de bestandstypen te scheiden met puntkomma's, bijvoorbeeld:

Image Files(*.BMP;*.JPG;*.GIF)|*.BMP;*.JPG;*.GIF|All files (*.*)|*.*

Gebruik de FilterIndex eigenschap om in te stellen welke filteroptie eerst voor de gebruiker wordt weergegeven.

Zie ook

• CheckFileExists
• FilterIndex