Strings.Filter Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.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

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

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Resumen de manipulación de cadenas

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

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

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Resumen de manipulación de cadenas