FileDialog.Filter Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta la stringa filtro del nome file corrente, che determina le scelte visualizzate nelle casella relative al tipo di file nella finestra di dialogo.

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

Valore della proprietà

String

Opzioni di filtro dei file disponibili nella finestra di dialogo.

Eccezioni

ArgumentException

Il formato Filter non è valido.

Esempio

Nell'esempio di codice seguente viene utilizzata l'implementazione di FileDialog e viene illustrata la OpenFileDialog creazione, l'impostazione delle proprietà e la visualizzazione della finestra di dialogo. Nell'esempio vengono utilizzate le Filter proprietà e FilterIndex per fornire un elenco di filtri per l'utente. L'esempio richiede un form con un Button oggetto posizionato su di esso e lo System.IO spazio dei nomi aggiunto.

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

Commenti

Per ogni opzione di filtro, la stringa di filtro contiene una descrizione del filtro, seguita dalla barra verticale (|) e dal modello di filtro. Le stringhe per diverse opzioni di filtro sono separate dalla barra verticale.

Di seguito è riportato un esempio di stringa di filtro:

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

È possibile aggiungere diversi modelli di filtro a un filtro separando i tipi di file con punti e virgola, ad esempio:

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

Utilizzare la FilterIndex proprietà per impostare l'opzione di filtro visualizzata per prima all'utente.

Si applica a

Vedi anche