DocumentList.Filter, propriété
Mise à jour : novembre 2007
Obtient ou définit une spécification de filtrage de fichier.
Espace de noms : Microsoft.WindowsCE.Forms
Assembly : Microsoft.WindowsCE.Forms (dans Microsoft.WindowsCE.Forms.dll)
Syntaxe
'Déclaration
Public Property Filter As String
'Utilisation
Dim instance As DocumentList
Dim value As String
value = instance.Filter
instance.Filter = value
public string Filter { get; set; }
public:
property String^ Filter {
String^ get ();
void set (String^ value);
}
public function get Filter () : String
public function set Filter (value : String)
Valeur de propriété
Type : System.String
Filtres de fichier actuellement spécifiés.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | La spécification de filtrage n'est pas valide. |
Notes
Pour chaque option de filtrage, la chaîne de filtre contient une description du filtre, suivie d'une barre verticale (|) et du modèle de filtre. En raison de l'espace limité, les indications du Pocket PC suggèrent d'ignorer la description. Une description omise requiert un espace avant la barre verticale.
Par exemple, la chaîne de filtre suivante contient une description :
"Text files (*.txt)|*.txt"
Sans description, cette chaîne de filtre se présenterait comme suit :
" |*.txt"
Une barre verticale sépare également les options de filtrage. Vous pouvez utiliser des points-virgules pour démarquer plusieurs modèles de filtres dans une option de filtre. La chaîne de filtre suivante spécifie cinq options de filtrage :
" |*.*| |*.pwi;*.pdt| |*.rtf| |*.txt| |*.xml"
Utilisez la propriété FilterIndex pour spécifier quelle option de filtrage s'affiche en premier à l'attention de l'utilisateur. FilterIndex est de base zéro. Si vous utilisez la chaîne de filtre précédemment décrite, les valeurs d'index se présentent comme suit :
Valeur d'index |
Modèle de filtre |
|---|---|
0 |
*.* |
1 |
*.pwi;*.pdt |
2 |
*.rtf |
3 |
*.txt |
4 |
*.xml |
Exemples
L'exemple de code suivant définit la propriété Filter. Cet exemple de code fait partie d'un exemple plus développé fourni pour la classe DocumentList.
.Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| |*.pxl;*.psw| |*.jpg;*.gif;*.bmp| |*.wav;*.wmv;*.mpg;"
DocList.Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| " +
"|*.pxl;*.psw| |*.jpg;*.gif;*.bmp| |*.wav;*.wmv;*.mpg;";
Autorisations
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.
Plateformes
Windows Mobile pour Pocket PC
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Informations de version
.NET Compact Framework
Pris en charge dans : 3.5, 2.0