Proprietà DocumentList.Filter
Aggiornamento: novembre 2007
Ottiene o imposta una specifica per i filtri per file.
Spazio dei nomi: Microsoft.WindowsCE.Forms
Assembly: Microsoft.WindowsCE.Forms (in Microsoft.WindowsCE.Forms.dll)
Sintassi
'Dichiarazione
Public Property Filter As String
'Utilizzo
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)
Valore proprietà
Tipo: System.String
Filtri per file attualmente specificati.
Eccezioni
Eccezione | Condizione |
---|---|
ArgumentException | La specifica per i filtri non è valida. |
Note
Per ogni opzione di filtro, la stringa relativa al filtro contiene una descrizione del filtro, seguita da una barra verticale (|)e dal modello del filtro. A causa di limitazioni di spazio, nelle linee guida per Pocket PC viene suggerito di saltare la descrizione. Se si omette la descrizione, è necessario immettere uno spazio prima della barra verticale.
Nella seguente stringa, ad esempio, è presente la descrizione:
"Text files (*.txt)|*.txt"
Di seguito è riportata la stessa stringa senza descrizione:
" |*.txt"
La barra verticale viene utilizzata anche per separare le opzioni di filtro. Per delineare più modelli di filtro all'interno di un'opzione di filtro, è possibile utilizzare il punto e virgola. Nella seguente stringa vengono specificate cinque opzioni di filtro:
" |*.*| |*.pwi;*.pdt| |*.rtf| |*.txt| |*.xml"
Utilizzare la proprietà FilterIndex per specificare l'opzione di filtro che verrà visualizzata per prima. La proprietà FilterIndex è a base zero. Utilizzando la stringa di filtro descritta, il valori degli indici sono i seguenti:
Valore indice |
Modello filtro |
---|---|
0 |
*.* |
1 |
*.pwi;*.pdt |
2 |
*.rtf |
3 |
*.txt |
4 |
*.xml |
Esempi
Nell'esempio di codice riportato di seguito viene impostata la proprietà Filter. Questo esempio di codice fa parte di un esempio più esaustivo fornito per 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;";
Autorizzazioni
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.
Piattaforme
Windows Mobile per Pocket PC
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Compact Framework
Supportato in: 3.5, 2.0