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 contenant un sous-ensemble d’un String tableau en fonction des critères de filtre spécifiés.
Surcharges
| Nom | Description |
|---|---|
| Filter(Object[], String, Boolean, CompareMethod) |
Retourne un tableau de base zéro contenant un sous-ensemble d’un |
| Filter(String[], String, Boolean, CompareMethod) |
Retourne un tableau de base zéro contenant un sous-ensemble d’un |
Filter(Object[], String, Boolean, CompareMethod)
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
Retourne un tableau de base zéro contenant un sous-ensemble d’un String tableau en fonction 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 à rechercher.
- Match
- String
Obligatoire. Chaîne à rechercher.
- Include
- Boolean
Optional.
Boolean valeur indiquant s’il faut retourner des sous-chaînes qui incluent ou excluent Match. Si Include c’est Truele cas, la Filter fonction retourne le sous-ensemble du tableau qui contient Match en tant que sous-chaîne. Si Include c’est Falsele cas, la Filter fonction retourne le sous-ensemble du tableau qui ne contient Match pas en tant que sous-chaîne.
- Compare
- CompareMethod
Optional. Valeur numérique indiquant le type de comparaison de chaînes à utiliser. Consultez « Paramètres » pour connaître les valeurs.
Retours
Tableau de base zéro contenant un sous-ensemble d’un String tableau basé sur des critères de filtre spécifiés.
Exceptions
Source est ou n’est Nothing 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 n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source elle est définie Nothing sur 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.
| Constante | Description |
|---|---|
CompareMethod.Binary |
Effectue une comparaison binaire |
CompareMethod.Text |
Effectue une comparaison textuelle |
Voir aussi
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Résumé de la manipulation de chaînes
S’applique à
Filter(String[], String, Boolean, CompareMethod)
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
Retourne un tableau de base zéro contenant un sous-ensemble d’un String tableau en fonction 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 à rechercher.
- Match
- String
Obligatoire. Chaîne à rechercher.
- Include
- Boolean
Optional.
Boolean valeur indiquant s’il faut retourner des sous-chaînes qui incluent ou excluent Match. Si Include c’est Truele cas, la Filter fonction retourne le sous-ensemble du tableau qui contient Match en tant que sous-chaîne. Si Include c’est Falsele cas, la Filter fonction retourne le sous-ensemble du tableau qui ne contient Match pas en tant que sous-chaîne.
- Compare
- CompareMethod
Optional. Valeur numérique indiquant le type de comparaison de chaînes à utiliser. Consultez « Paramètres » pour connaître les valeurs.
Retours
Tableau de base zéro contenant un sous-ensemble d’un String tableau basé sur des critères de filtre spécifiés.
Exceptions
Source est ou n’est Nothing 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 n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source elle est définie Nothing sur 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.
| Constante | Description |
|---|---|
CompareMethod.Binary |
Effectue une comparaison binaire |
CompareMethod.Text |
Effectue une comparaison textuelle |
Voir aussi
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Résumé de la manipulation de chaînes