Strings.Filter Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

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

Aşırı Yüklemeler

Filter(Object[], String, Boolean, CompareMethod)	Belirtilen filtre ölçütlerini temel alan bir dizi alt kümesini içeren sıfır tabanlı bir String dizi döndürür.
Filter(String[], String, Boolean, CompareMethod)	Belirtilen filtre ölçütlerini temel alan bir dizi 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çütlerini temel alan bir dizi 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[]

Gereklidir. Aranacak tek boyutlu dize dizisi.

Match

String

Gereklidir. Aranacak dize.

Include

Boolean

İsteğe bağlı. Boolean değerini içeren veya dışlayan Matchalt dizelerin döndürülip döndürülmeyeceğini belirten değer. ise IncludeTrueFilter, işlevi bir alt dize olarak içeren Match dizinin alt kümesini döndürür. ise IncludeFalseişlevi, Filter alt dize olarak içermeyen Match dizinin alt kümesini döndürür.

Compare

CompareMethod

İsteğe bağlı. Kullanılacak dize karşılaştırma türünü gösteren sayısal değer. Değerler için "Ayarlar"a 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 SourceFilter eşleşme Match bulunmazsa işlevi boş bir dizi döndürür. Tek boyutlu bir dizi olarak Nothing ayarlandıysa Source veya ayarlanmadıysa bir hata oluşur.

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

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

Sabit	Description
CompareMethod.Binary	İkili karşılaştırma yapar
CompareMethod.Text	Metinsel karşılaştırma yapar

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çütlerini temel alan bir dizi 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[]

Gereklidir. Aranacak tek boyutlu dize dizisi.

Match

String

Gereklidir. Aranacak dize.

Include

Boolean

İsteğe bağlı. Boolean değerini içeren veya dışlayan Matchalt dizelerin döndürülip döndürülmeyeceğini belirten değer. ise IncludeTrueFilter, işlevi bir alt dize olarak içeren Match dizinin alt kümesini döndürür. ise IncludeFalseişlevi, Filter alt dize olarak içermeyen Match dizinin alt kümesini döndürür.

Compare

CompareMethod

İsteğe bağlı. Kullanılacak dize karşılaştırma türünü gösteren sayısal değer. Değerler için "Ayarlar"a 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 SourceFilter eşleşme Match bulunmazsa işlevi boş bir dizi döndürür. Tek boyutlu bir dizi olarak Nothing ayarlandıysa Source veya ayarlanmadıysa bir hata oluşur.

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

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

Sabit	Description
CompareMethod.Binary	İkili karşılaştırma yapar
CompareMethod.Text	Metinsel karşılaştırma yapar

Ayrıca bkz.

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