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<TResult>

Объект, 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, к которому могут применяться стандартные операторы запросов.

Применяется к