Strings.Filter Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 ( |
| Filter(String[], String, Boolean, CompareMethod) |
Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes ( |
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Liste des manipulations de chaînes
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Liste des manipulations de chaînes
