Strings.Filter Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Belirtilen filtre ölçütlerine göre bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi döndürür.

Aşırı Yüklemeler

Name	Description
Filter(Object[], String, Boolean, CompareMethod)	Belirtilen filtre ölçütlerine göre bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi döndürür.
Filter(String[], String, Boolean, CompareMethod)	Belirtilen filtre ölçütlerine göre bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi döndürür.

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

Kaynak:

Strings.vb

Belirtilen filtre ölçütlerine göre bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi döndürür.

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

Parametreler

Source

Object[]

Gerekli. Aranacak tek boyutlu dize dizisi.

Match

String

Gerekli. Aranacak dize.

Include

Boolean

Optional. Boolean değerini içeren veya dışlayan Matchalt dizelerin döndürülerek döndürülmeyeceğini belirten değer. ise IncludeTrueişlevi, Filter alt dize olarak içeren Match dizinin alt kümesini döndürür. ise IncludeFalseFilter işlevi, alt dize olarak içermeyen Match dizinin alt kümesini döndürür.

Compare

CompareMethod

Optional. Kullanılacak dize karşılaştırma türünü gösteren sayısal değer. Değerler için "Ayarlar" bölümüne bakın.

Döndürülenler

String[]

Belirtilen filtre ölçütlerini temel alan bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi.

Özel durumlar

ArgumentException

Source veya Nothing tek boyutlu bir dizi değildir.

Örnekler

Bu örnekte işlevin kullanımı gösterilmektedir Filter .

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)

Açıklamalar

içinde MatchSource eşleşme Filter bulunmazsa işlevi boş bir dizi döndürür. Tek boyutlu bir dizi olarak Source ayarlandıysa Nothing veya ayarlanmadıysa bir hata oluşur.

İşlev tarafından döndürülen dizi, Filter eşleşen öğe sayısını içerecek kadar öğe içerir.

Bağımsız Compare değişken aşağıdaki değerlere sahip olabilir.

Sabit	Açıklama
CompareMethod.Binary	İkili karşılaştırma gerçekleştirir
CompareMethod.Text	Metinsel karşılaştırma gerçekleştirir

Ayrıca bkz.

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Dize Düzenleme Özeti

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

Kaynak:

Strings.vb

Belirtilen filtre ölçütlerine göre bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi döndürür.

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

Parametreler

Source

String[]

Gerekli. Aranacak tek boyutlu dize dizisi.

Match

String

Gerekli. Aranacak dize.

Include

Boolean

Optional. Boolean değerini içeren veya dışlayan Matchalt dizelerin döndürülerek döndürülmeyeceğini belirten değer. ise IncludeTrueişlevi, Filter alt dize olarak içeren Match dizinin alt kümesini döndürür. ise IncludeFalseFilter işlevi, alt dize olarak içermeyen Match dizinin alt kümesini döndürür.

Compare

CompareMethod

Optional. Kullanılacak dize karşılaştırma türünü gösteren sayısal değer. Değerler için "Ayarlar" bölümüne bakın.

Döndürülenler

String[]

Belirtilen filtre ölçütlerini temel alan bir dizinin alt kümesini içeren sıfır tabanlı bir String dizi.

Özel durumlar

ArgumentException

Source veya Nothing tek boyutlu bir dizi değildir.

Örnekler

Bu örnekte işlevin kullanımı gösterilmektedir Filter .

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)

Açıklamalar

içinde MatchSource eşleşme Filter bulunmazsa işlevi boş bir dizi döndürür. Tek boyutlu bir dizi olarak Source ayarlandıysa Nothing veya ayarlanmadıysa bir hata oluşur.

İşlev tarafından döndürülen dizi, Filter eşleşen öğe sayısını içerecek kadar öğe içerir.

Bağımsız Compare değişken aşağıdaki değerlere sahip olabilir.

Sabit	Açıklama
CompareMethod.Binary	İkili karşılaştırma gerçekleştirir
CompareMethod.Text	Metinsel karşılaştırma gerçekleştirir

Ayrıca bkz.

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Dize Düzenleme Özeti