Strings.Filter Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

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

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);

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

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 , 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

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

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);

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

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 , 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