Partager via


Strings.Filter Méthode

Définition

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Surcharges

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

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

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

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

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

Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

public static string[]? Filter (object?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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()

Paramètres

Source
Object[]

Obligatoire. Tableau unidimensionnel de chaînes dans lequel la recherche doit être effectuée.

Match
String

Obligatoire. Chaîne à rechercher.

Include
Boolean

Optionnel. Valeur Boolean qui indique s'il faut retourner les sous-chaînes incluant ou excluant Match. Si Include a la valeur True, la fonction Filter retourne le sous-ensemble du tableau contenant Match comme sous-chaîne. Si Include a la valeur False, la fonction Filter retourne le sous-ensemble du tableau ne contenant pas Match comme sous-chaîne.

Compare
CompareMethod

Optionnel. Valeur numérique indiquant le type de comparaison de chaîne à utiliser. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String[]

Un tableau de base zéro et contenant un sous-ensemble d’un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Exceptions

Source a la valeur Nothing ou n'est pas un tableau unidimensionnel.

Exemples

Cet exemple illustre l’utilisation de la Filter fonction .

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)

Remarques

Si aucune correspondance de n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source est défini sur Nothing ou n’est pas un tableau unidimensionnel.

Le tableau retourné par la Filter fonction contient uniquement suffisamment d’éléments pour contenir le nombre d’éléments correspondants.

L’argument Compare peut avoir les valeurs suivantes.

Constant Description
CompareMethod.Binary Effectue une comparaison binaire
CompareMethod.Text Effectue une comparaison textuelle

Voir aussi

S’applique à

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

Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

public static string[]? Filter (string?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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()

Paramètres

Source
String[]

Obligatoire. Tableau unidimensionnel de chaînes dans lequel la recherche doit être effectuée.

Match
String

Obligatoire. Chaîne à rechercher.

Include
Boolean

Optionnel. Valeur Boolean qui indique s'il faut retourner les sous-chaînes incluant ou excluant Match. Si Include a la valeur True, la fonction Filter retourne le sous-ensemble du tableau contenant Match comme sous-chaîne. Si Include a la valeur False, la fonction Filter retourne le sous-ensemble du tableau ne contenant pas Match comme sous-chaîne.

Compare
CompareMethod

Optionnel. Valeur numérique indiquant le type de comparaison de chaîne à utiliser. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String[]

Un tableau de base zéro et contenant un sous-ensemble d’un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Exceptions

Source a la valeur Nothing ou n'est pas un tableau unidimensionnel.

Exemples

Cet exemple illustre l’utilisation de la Filter fonction .

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)

Remarques

Si aucune correspondance de n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source est défini sur Nothing ou n’est pas un tableau unidimensionnel.

Le tableau retourné par la Filter fonction contient uniquement suffisamment d’éléments pour contenir le nombre d’éléments correspondants.

L’argument Compare peut avoir les valeurs suivantes.

Constant Description
CompareMethod.Binary Effectue une comparaison binaire
CompareMethod.Text Effectue une comparaison textuelle

Voir aussi

S’applique à