Enumerable.Cast<TResult>(IEnumerable) Yöntem

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kod:

System.Linq.dll

Kaynak:

Cast.cs

öğesinin IEnumerable öğelerini belirtilen türe atar.

public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Cast(System::Collections::IEnumerable ^ source);

public static System.Collections.Generic.IEnumerable<TResult> Cast<TResult> (this System.Collections.IEnumerable source);

static member Cast : System.Collections.IEnumerable -> seq<'Result>

<Extension()>
Public Function Cast(Of TResult) (source As IEnumerable) As IEnumerable(Of TResult)

Tür Parametreleri

TResult

öğelerinin source ataması yapılan tür.

Parametreler

source

IEnumerable

IEnumerable türüne TResultyayınlanacak öğeleri içeren öğesi.

Döndürülenler

IEnumerable<TResult>

IEnumerable<T> Kaynak dizisinin her öğesini içeren bir belirtilen türe yayın.

Özel durumlar

ArgumentNullException

source, null değeridir.

InvalidCastException

Dizideki bir öğe türüne TResultdönüştürilemez.

Örnekler

Aşağıdaki kod örneği, üzerinde ArrayListstandart sorgu işleçlerinin kullanımını etkinleştirmek için nasıl kullanılacağını Cast<TResult>(IEnumerable) gösterir.

System.Collections.ArrayList fruits = new System.Collections.ArrayList();
fruits.Add("mango");
fruits.Add("apple");
fruits.Add("lemon");

IEnumerable<string> query =
    fruits.Cast<string>().OrderBy(fruit => fruit).Select(fruit => fruit);

// The following code, without the cast, doesn't compile.
//IEnumerable<string> query1 =
//    fruits.OrderBy(fruit => fruit).Select(fruit => fruit);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

// This code produces the following output:
//
// apple
// lemon
// mango

' Create an ArrayList and add items to it.
Dim fruits As New System.Collections.ArrayList()
fruits.Add("mango")
fruits.Add("apple")
fruits.Add("lemon")

' Call Cast(Of String) to cast the ArrayList elements to strings.
Dim query As IEnumerable(Of String) =
fruits.Cast(Of String)().OrderBy(Function(fruit) fruit).Select(Function(fruit) fruit)

'' The following code, without the cast, doesn't compile.
'Dim query As IEnumerable(Of String) = _
'    fruits.OrderBy(Function(fruit) fruit).Select(Function(fruit) fruit)

Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next

' Display the output.
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' apple
' lemon
' mango

Açıklamalar

Bu yöntem ertelenmiş yürütme kullanılarak uygulanır. Hemen dönüş değeri, eylemi gerçekleştirmek için gereken tüm bilgileri depolayan bir nesnedir. Bu yöntemle temsil edilen sorgu, doğrudan yöntemini çağırarak GetEnumerator veya C# içinde veya For Each Visual Basic'te kullanarak foreach nesne numaralandırılana kadar yürütülür.

yöntemi, Cast<TResult>(IEnumerable) standart sorgu işleçlerinin gerekli tür bilgilerini sağlayarak genel olmayan koleksiyonlarda çağrılmalarını sağlar. Örneğin, ArrayList uygulamaz IEnumerable<T>, ancak nesnesini çağırarak Cast<TResult>(IEnumerable)ArrayList , standart sorgu işleçleri daha sonra diziyi sorgulamak için kullanılabilir.

Bir öğe türüne TResultdönüştürülemiyorsa, bu yöntem bir InvalidCastExceptionoluşturur.

Bu yöntemin kaynak dizisi olur IEnumerable. Bu, öğelerin derleme zamanı statik türüne objectsahip olduğu anlamına gelir. Bu yöntem tarafından gerçekleştirilen tek tür dönüştürmeleri, başvuru dönüştürmeleri ve kutulama dönüştürmeleridir. Koleksiyondaki öğelerin çalışma zamanı türü hedef türle eşleşmelidir veya değer türleri söz konusu olduğunda öğelerin çalışma zamanı türü, hedef türün kutulama dönüştürmesinin sonucu olmalıdır. Farklı sayısal türler arasındakiler gibi diğer dönüştürme türlerine izin verilmez.

Yalnızca türüne TResultdönüştürülebilecek öğeleri elde etmek için yerine Cast<TResult>(IEnumerable)yöntemini kullanınOfType.

Sorgu ifadesinde, açıkça yazılan bir yineleme değişkeni çağrısına Cast<TResult>(IEnumerable)dönüşür. Bu örnekte, açıkça yazılan aralık değişkeninin söz dizimi gösterilmektedir.

from int i in objects

From i As Integer In objects

select Örtük sayısal dönüştürmeler gibi diğer dönüştürme türlerini gerçekleştirmek için sorgunun yan tümcesini kullanın. Aşağıdaki örnek, bir kutulu tamsayı dizisini çiftler dizisine dönüştürmek için hem yöntemini select hem de Cast deyimini kullanır.

IEnumerable sequence = Enumerable.Range(0, 10);
var doubles = from int item in sequence
                select (double)item;

Dim sequence As IEnumerable = Enumerable.Range(0, 10)
Dim doubles = From item As Integer In sequence
                Select CType(item, Double)

Ayrıca bkz.

• from tümcesi (C# Başvurusu)
• From Tümcesi (Visual Basic)