FileDialog.FilterIndex-Eigenschaft
Ruft den Index des derzeit im Dateidialogfeld ausgewählten Filters ab oder legt diesen fest.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Property FilterIndex As Integer
'Usage
Dim instance As FileDialog
Dim value As Integer
value = instance.FilterIndex
instance.FilterIndex = value
public int FilterIndex { get; set; }
public:
property int FilterIndex {
int get ();
void set (int value);
}
/** @property */
public int get_FilterIndex ()
/** @property */
public void set_FilterIndex (int value)
public function get FilterIndex () : int
public function set FilterIndex (value : int)
Eigenschaftenwert
Ein Wert, der den Index des derzeit im Dateidialogfeld ausgewählten Filters enthält. Der Standardwert ist 1.
Hinweise
Mit der FilterIndex-Eigenschaft können Sie festlegen, welche Filteroption den Benutzern zuerst angezeigt wird. Je nach dem ausgewähltem Filter können Sie nach der Anzeige des Dateidialogfelds außerdem mithilfe des Werts von FilterIndex besondere Dateivorgänge ausführen.
Hinweis
Der Indexwert des ersten Filtereintrags ist 1.
Beispiel
Im folgenden Codebeispiel wird die OpenFileDialog-Implementierung von FileDialog verwendet und veranschaulicht, wie ein Dialogfeld erstellt und nach Festlegen der Eigenschaften angezeigt wird. Im Beispiel wird mithilfe der Filter-Eigenschaft und der FilterIndex-Eigenschaft eine Liste von Filtern für den Benutzer bereitgestellt. Voraussetzung für dieses Beispiel ist ein Formular, auf dem Button platziert und dem der System.IO-Namespace hinzugefügt wurde.
Private Sub button1_Click(sender As Object, e As System.EventArgs)
Dim myStream As Stream
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() = DialogResult.OK Then
myStream = openFileDialog1.OpenFile()
If Not (myStream Is Nothing) Then
' Insert code to read the stream here.
myStream.Close()
End If
End If
End Sub
private void button1_Click(object sender, System.EventArgs e)
{
Stream myStream;
OpenFileDialog openFileDialog1 = new OpenFileDialog();
openFileDialog1.InitialDirectory = "c:\\" ;
openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" ;
openFileDialog1.FilterIndex = 2 ;
openFileDialog1.RestoreDirectory = true ;
if(openFileDialog1.ShowDialog() == DialogResult.OK)
{
if((myStream = openFileDialog1.OpenFile())!= null)
{
// Insert code to read the stream here.
myStream.Close();
}
}
}
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() == ::DialogResult::OK )
{
if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
{
// Insert code to read the stream here.
myStream->Close();
}
}
}
protected void button1_Click(Object sender, System.EventArgs e)
{
Stream myStream;
OpenFileDialog openFileDialog1 = new OpenFileDialog();
openFileDialog1.set_InitialDirectory("c:\\");
openFileDialog1.set_Filter(
"txt files (*.txt)|*.txt|All files (*.*)|*.*");
openFileDialog1.set_FilterIndex(2);
openFileDialog1.set_RestoreDirectory(true);
if (openFileDialog1.ShowDialog().Equals(get_DialogResult().OK)) {
if ((myStream = openFileDialog1.OpenFile()) != null) {
// Insert code to read the stream here.
myStream.Close();
}
}
} //button1_Click
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
FileDialog-Klasse
FileDialog-Member
System.Windows.Forms-Namespace
FileDialog.CheckFileExists-Eigenschaft
FileDialog.Filter-Eigenschaft