Enumerable.OfType<TResult>(IEnumerable) Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Сборка:

System.Core.dll

Сборка:

netstandard.dll

Выполняет фильтрацию элементов объекта 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<TResult>

Объект IEnumerable<T>, содержащий элементы входной последовательности типа TResult.

Исключения

ArgumentNullException

source имеет значение null.

Примеры

В следующем примере кода показано, как использовать для OfType фильтрации элементов объекта IEnumerable.

System.Collections.ArrayList fruits = new System.Collections.ArrayList(4);
fruits.Add("Mango");
fruits.Add("Orange");
fruits.Add("Apple");
fruits.Add(3.0);
fruits.Add("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.ToLower().Contains("n"));

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 System.Collections.ArrayList(4)
fruits.Add("Mango")
fruits.Add("Orange")
fruits.Add("Apple")
fruits.Add(3.0)
fruits.Add("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.ToLower().Contains("n"))

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 в Visual C# или For Each в Visual Basic.

Метод OfType<TResult>(IEnumerable) возвращает только те элементы, в source которых можно привести к типу TResult. Чтобы вместо этого получить исключение, если элемент не может быть приведен к типу TResult, используйте Cast<TResult>(IEnumerable).

Этот метод является одним из немногих стандартных методов оператора запроса, которые можно применить к коллекции, которая имеет не параметризованный тип, например ArrayList. Это связано с тем, что OfType расширяет тип IEnumerable. OfType не может применяться только к коллекциям, основанным на параметризованном IEnumerable<T> типе, но коллекции, основанные также на непараметровизованном IEnumerable типе.

Применяя к OfType коллекции, реализующей IEnumerableэту коллекцию, вы получаете возможность запрашивать коллекцию с помощью стандартных операторов запросов. Например, указание аргумента Object типа для OfType возврата объекта типа IEnumerable<Object> в C# или IEnumerable(Of Object) в Visual Basic, к которому можно применять стандартные операторы запросов.