Strings.Filter Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.

Overload

Filter(Object[], String, Boolean, CompareMethod)	Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.
Filter(String[], String, Boolean, CompareMethod)	Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.

Filter(Object[], String, Boolean, CompareMethod)

Source:

Strings.vb

Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.

public static string[]? Filter (object?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Filter : obj[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]

Public Function Filter (Source As Object(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parametri

Source

Object[]

Obbligatorio. Matrice unidimensionale delle stringhe da cercare.

Match

String

Obbligatorio. Stringa da cercare.

Include

Boolean

facoltativo. Valore Boolean che indica se restituire sottostringhe che includono o escludono il parametro Match. Se Include è True, la funzione Filter restituisce il sottoinsieme della matrice che contiene Match in formato di sottostringa. Se Include è False, la funzione Filter restituisce il sottoinsieme della matrice che non contiene Match in formato di sottostringa.

Compare

CompareMethod

facoltativo. Valore numerico che indica il tipo di confronto da utilizzare per le stringhe. Per un elenco dei valori possibili, vedere "Impostazioni".

Restituisce

String[]

Matrice in base zero contenente un subset di una matrice String sulla base di criteri di filtro specificati.

Eccezioni

ArgumentException

Source è Nothing oppure non è una matrice unidimensionale.

Esempio

In questo esempio viene illustrato l'uso della Filter funzione .

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Commenti

Se non viene trovata alcuna corrispondenza all'interno Sourcedi Match , la Filter funzione restituisce una matrice vuota. Si verifica un errore se Source è impostato su Nothing o non è una matrice unidimensionale.

La matrice restituita dalla Filter funzione contiene solo elementi sufficienti per contenere il numero di elementi corrispondenti.

L'argomento Compare può avere i valori seguenti.

Costante	Descrizione
CompareMethod.Binary	Esegue un confronto binario
CompareMethod.Text	Esegue un confronto testuale

Vedi anche

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Riepilogo della modifica delle stringhe

Filter(String[], String, Boolean, CompareMethod)

Source:

Strings.vb

Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.

public static string[]? Filter (string?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Filter : string[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]

Public Function Filter (Source As String(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parametri

Source

String[]

Obbligatorio. Matrice unidimensionale delle stringhe da cercare.

Match

String

Obbligatorio. Stringa da cercare.

Include

Boolean

facoltativo. Valore Boolean che indica se restituire sottostringhe che includono o escludono il parametro Match. Se Include è True, la funzione Filter restituisce il sottoinsieme della matrice che contiene Match in formato di sottostringa. Se Include è False, la funzione Filter restituisce il sottoinsieme della matrice che non contiene Match in formato di sottostringa.

Compare

CompareMethod

facoltativo. Valore numerico che indica il tipo di confronto da utilizzare per le stringhe. Per un elenco dei valori possibili, vedere "Impostazioni".

Restituisce

String[]

Matrice in base zero contenente un subset di una matrice String sulla base di criteri di filtro specificati.

Eccezioni

ArgumentException

Source è Nothing oppure non è una matrice unidimensionale.

Esempio

In questo esempio viene illustrato l'uso della Filter funzione .

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Commenti

Se non viene trovata alcuna corrispondenza all'interno Sourcedi Match , la Filter funzione restituisce una matrice vuota. Si verifica un errore se Source è impostato su Nothing o non è una matrice unidimensionale.

La matrice restituita dalla Filter funzione contiene solo elementi sufficienti per contenere il numero di elementi corrispondenti.

L'argomento Compare può avere i valori seguenti.

Costante	Descrizione
CompareMethod.Binary	Esegue un confronto binario
CompareMethod.Text	Esegue un confronto testuale

Vedi anche

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Riepilogo della modifica delle stringhe