Strings.Filter Método

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.Core.dll
Ensamblado:
Microsoft.VisualBasic.dll

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

Sobrecargas

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

Devuelve una matriz de base cero que contiene un subconjunto de una String matriz basada en criterios de filtro especificados.
Filter(String[], String, Boolean, CompareMethod)

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

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

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

Devuelve una matriz de base cero que contiene un subconjunto de una String matriz 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[]

Required. Matriz unidimensional de cadenas que se van a buscar.

Match
String

Required. Cadena que se va a buscar.

Include
Boolean

Optional. Boolean valor que indica si se devuelven subcadenas que incluyen o excluyen Match. Si Include es True, la Filter función devuelve el subconjunto de la matriz que contiene Match como una subcadena. Si Include es False, la Filter función devuelve el subconjunto de la matriz que no contiene Match como una subcadena.

Compare
CompareMethod

Optional. Valor numérico que indica el tipo de comparación de cadena que se va a usar. Consulte "Configuración" para ver los valores.

Devoluciones

String[]

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

Excepciones

ArgumentException

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 , Sourcela Filter función devuelve una matriz vacía. 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 Description
CompareMethod.Binary Realiza una comparación binaria
CompareMethod.Text Realiza una comparación de texto

Consulte también

Se aplica a

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

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

Devuelve una matriz de base cero que contiene un subconjunto de una String matriz 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[]

Required. Matriz unidimensional de cadenas que se van a buscar.

Match
String

Required. Cadena que se va a buscar.

Include
Boolean

Optional. Boolean valor que indica si se devuelven subcadenas que incluyen o excluyen Match. Si Include es True, la Filter función devuelve el subconjunto de la matriz que contiene Match como una subcadena. Si Include es False, la Filter función devuelve el subconjunto de la matriz que no contiene Match como una subcadena.

Compare
CompareMethod

Optional. Valor numérico que indica el tipo de comparación de cadena que se va a usar. Consulte "Configuración" para ver los valores.

Devoluciones

String[]

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

Excepciones

ArgumentException

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 , Sourcela Filter función devuelve una matriz vacía. 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 Description
CompareMethod.Binary Realiza una comparación binaria
CompareMethod.Text Realiza una comparación de texto

Consulte también

Se aplica a