Enumerable.OfType<TResult>(IEnumerable) Metodo

Definizione

Spazio dei nomi:

System.Linq

Assembly:

System.Linq.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.

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)

Parametri di tipo

TResult

Il tipo in base al quale filtrare gli elementi della sequenza.

Parametri

source

IEnumerable

L’oggetto IEnumerable i cui elementi devono essere filtrati.

Restituisce

IEnumerable<TResult>

Oggetto IEnumerable<T> che contiene elementi della sequenza di input del tipo TResult.

Eccezioni

ArgumentNullException

source è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare OfType per filtrare gli elementi di un IEnumerableoggetto .

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

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando il GetEnumerator relativo metodo direttamente o usando foreach in Visual C# o For Each in Visual Basic.

Il OfType<TResult>(IEnumerable) metodo restituisce solo gli elementi in source cui è possibile eseguire il cast per digitare TResult. Per ricevere invece un'eccezione se non è possibile eseguire il cast di un elemento per digitare TResult, usare Cast<TResult>(IEnumerable).

Questo metodo è uno dei pochi metodi dell'operatore di query standard che possono essere applicati a una raccolta con un tipo non con parametri, ad esempio un ArrayListoggetto . Questo perché OfType estende il tipo IEnumerable. OfType non può essere applicato solo alle raccolte basate sul tipo con parametri, ma le raccolte basate sul tipo non con parametri IEnumerable<T> IEnumerable .

Applicando OfType a una raccolta che implementa IEnumerable, è possibile eseguire query sulla raccolta usando gli operatori di query standard. Ad esempio, specificando un argomento di tipo di Object per OfType restituire un oggetto di tipo IEnumerable<Object> in C# o IEnumerable(Of Object) in Visual Basic, a cui possono essere applicati gli operatori di query standard.