Compartir a través de


Strings.Filter Método

Definición

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 String basada en criterios de filtro especificados.

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

Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.

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

String[]

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

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

String[]

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

Se aplica a