Strings.Filter Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.
Sobrecargas
| Filter(Object[], String, Boolean, CompareMethod) |
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz |
| Filter(String[], String, Boolean, CompareMethod) |
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz |
Filter(Object[], String, Boolean, CompareMethod)
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.
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()Parámetros
- Source
- Object[]
Obligatorio. Matriz unidimensional de cadenas en la que se va a buscar.
- Match
- String
Obligatorio. Cadena que se va a buscar.
- Include
- Boolean
Opcional. Valor de tipo Boolean que indica si se van a devolver subcadenas que incluyen o excluyen Match. Si el valor de Include es True, la función Filter devuelve el subconjunto de la matriz que contiene Match como subcadena. Si el valor de Include es False, la función Filter devuelve el subconjunto de la matriz que no contiene Match como subcadena.
- Compare
- CompareMethod
Opcional. Valor numérico que indica el tipo de comparación de cadenas que se va a utilizar. Consulte los valores en "Configuración".
Devoluciones
Matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.
Excepciones
Source es Nothing o no es una matriz unidimensional.
Ejemplos
En este ejemplo se muestra el uso de la Filter función .
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)
Comentarios
Si no se encuentran coincidencias de Match , la Filter función devuelve una matriz vacía.Source Se produce un error si Source se establece Nothing en o no es una matriz unidimensional.
La matriz devuelta por la Filter función contiene solo elementos suficientes para contener el número de elementos coincidentes.
El Compare argumento puede tener los valores siguientes.
| Constante | Descripción |
|---|---|
CompareMethod.Binary |
Realiza una comparación binaria |
CompareMethod.Text |
Realiza una comparación textual |
Consulte también
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumen de la manipulación de cadenas
Se aplica a
Filter(String[], String, Boolean, CompareMethod)
- Source:
- Strings.vb
- Source:
- Strings.vb
- Source:
- Strings.vb
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.
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()Parámetros
- Source
- String[]
Obligatorio. Matriz unidimensional de cadenas en la que se va a buscar.
- Match
- String
Obligatorio. Cadena que se va a buscar.
- Include
- Boolean
Opcional. Valor de tipo Boolean que indica si se van a devolver subcadenas que incluyen o excluyen Match. Si el valor de Include es True, la función Filter devuelve el subconjunto de la matriz que contiene Match como subcadena. Si el valor de Include es False, la función Filter devuelve el subconjunto de la matriz que no contiene Match como subcadena.
- Compare
- CompareMethod
Opcional. Valor numérico que indica el tipo de comparación de cadenas que se va a utilizar. Consulte los valores en "Configuración".
Devoluciones
Matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.
Excepciones
Source es Nothing o no es una matriz unidimensional.
Ejemplos
En este ejemplo se muestra el uso de la Filter función .
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)
Comentarios
Si no se encuentran coincidencias de Match , la Filter función devuelve una matriz vacía.Source Se produce un error si Source se establece Nothing en o no es una matriz unidimensional.
La matriz devuelta por la Filter función contiene solo elementos suficientes para contener el número de elementos coincidentes.
El Compare argumento puede tener los valores siguientes.
| Constante | Descripción |
|---|---|
CompareMethod.Binary |
Realiza una comparación binaria |
CompareMethod.Text |
Realiza una comparación textual |
Consulte también
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumen de la manipulación de cadenas
