Enumerable.OfType<TResult>(IEnumerable) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Фильтрует элементы IEnumerable на основе указанного типа.
public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TResult> ^ OfType(System::Collections::IEnumerable ^ source);
public static System.Collections.Generic.IEnumerable<TResult> OfType<TResult>(this System.Collections.IEnumerable source);
static member OfType : System.Collections.IEnumerable -> seq<'Result>
<Extension()>
Public Function OfType(Of TResult) (source As IEnumerable) As IEnumerable(Of TResult)
Параметры типа
- TResult
Тип для фильтрации элементов последовательности.
Параметры
- source
- IEnumerable
Элементы IEnumerable , которые необходимо фильтровать.
Возвращаемое значение
Объект, IEnumerable<T> содержащий элементы из входной последовательности типа TResult.
Исключения
source равно null.
Примеры
В следующем примере кода показано, как фильтровать OfType элементы объекта IEnumerable.
System.Collections.ArrayList fruits = new()
{
"Mango",
"Orange",
null,
"Apple",
3.0,
"Banana"
};
// Apply OfType() to the ArrayList.
IEnumerable<string> query1 = fruits.OfType<string>();
Console.WriteLine("Elements of type 'string' are:");
foreach (string fruit in query1)
{
Console.WriteLine(fruit);
}
// The following query shows that the standard query operators such as
// Where() can be applied to the ArrayList type after calling OfType().
IEnumerable<string> query2 =
fruits.OfType<string>().Where(fruit =>
fruit.Contains('n', StringComparison.CurrentCultureIgnoreCase));
Console.WriteLine("\nThe following strings contain 'n':");
foreach (string fruit in query2)
{
Console.WriteLine(fruit);
}
// This code produces the following output:
//
// Elements of type 'string' are:
// Mango
// Orange
// Apple
// Banana
//
// The following strings contain 'n':
// Mango
// Orange
// Banana
' Create an ArrayList and add items to it.
Dim fruits As New ArrayList() From {
"Mango",
"Orange",
Nothing,
"Apple",
3.0,
"Banana"
}
' Apply OfType(Of String)() to the ArrayList
' to filter out non-string items.
Dim query1 As IEnumerable(Of String) = fruits.OfType(Of String)()
' Print the results.
Dim output As New System.Text.StringBuilder("Elements of type 'string' are:" _
& vbCrLf)
For Each fruit As String In query1
output.AppendLine(fruit)
Next
' The following query shows that the standard query operators such as
' Where() can be applied to the ArrayList type after calling OfType().
Dim query2 As IEnumerable(Of String) =
fruits.OfType(Of String)().Where(Function(fruit) _
fruit.Contains("n"c, StringComparison.CurrentCultureIgnoreCase))
output.AppendLine(vbCrLf & "The following strings contain 'n':")
For Each fruit As String In query2
output.AppendLine(fruit)
Next
' Display the output.
Console.WriteLine(output.ToString())
' This code produces the following output:
'
' Elements of type 'string' are:
' Mango
' Orange
' Apple
' Banana
'
' The following strings contain 'n':
' Mango
' Orange
' Banana
Комментарии
Этот метод реализуется с помощью отложенного выполнения. Немедленное возвращаемое значение — это объект, в который хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется, пока объект не перечисляется путем вызова метода GetEnumerator напрямую или с помощью метода foreach в C# или For Each в Visual Basic.
Метод OfType<TResult>(IEnumerable) возвращает только те элементы, которые source не имеют значения NULL и совместимы с типом TResult. Чтобы получить исключение, если элемент не может быть приведение к типу TResult, используйте Cast<TResult>(IEnumerable).
Этот метод является одним из немногих стандартных методов оператора запроса, которые можно применить к коллекции, которая имеет не параметризованный тип, например ArrayList. Это связано с OfType расширением типа IEnumerable. OfType нельзя применять только к коллекциям, основанным на параметризованном IEnumerable<T> типе, но коллекции, основанные на не параметризованном IEnumerable типе.
При применении OfType к коллекции, которая реализуется IEnumerable, вы получаете возможность запрашивать коллекцию с помощью стандартных операторов запросов. Например, указание аргумента типа Object для OfType возвращает объект типа IEnumerable<Object> в C# или IEnumerable(Of Object) в Visual Basic, к которому могут применяться стандартные операторы запросов.