Kutulama ve Kutudan Çıkarma (C# Programlama Kılavuzu)
Kutulama, bir değer türünü türe veya bu değer türü tarafından uygulanan herhangi bir arabirim object türüne dönüştürme işlemidir. Ortak dil çalışma zamanı (CLR) bir değer türünü kutularına katıyorsa, değeri bir örneğin içine sarmalar ve System.Object yönetilen yığında depolar. Kutulama, nesneden değer türünü ayıklar. Kutulama örtülü bir iştir; unboxing açık. Kutulama ve kutulamayı açma kavramı, herhangi bir türde bir değerin nesne olarak kabul edilebilir olduğu tür sisteminin C# birleşik görünümünün altında yer verir.
Aşağıdaki örnekte tamsayı değişkeni kutu i içindedir ve nesnesine o atanır.
int i = 123;
// The following line boxes i.
object o = i;
Daha sonra o nesnesi kutulanmamış olabilir ve tamsayı değişkenine atanabilir: i
o = 123;
i = (int)o; // unboxing
Aşağıdaki örneklerde, kutulamanın C# içinde nasıl kullanıldıkları göstermektedir.
// String.Concat example.
// String.Concat has many versions. Rest the mouse pointer on
// Concat in the following statement to verify that the version
// that is used here takes three object arguments. Both 42 and
// true must be boxed.
Console.WriteLine(String.Concat("Answer", 42, true));
// List example.
// Create a list of objects to hold a heterogeneous collection
// of elements.
List<object> mixedList = new List<object>();
// Add a string element to the list.
mixedList.Add("First Group:");
// Add some integers to the list.
for (int j = 1; j < 5; j++)
{
// Rest the mouse pointer over j to verify that you are adding
// an int to a list of objects. Each element j is boxed when
// you add j to mixedList.
mixedList.Add(j);
}
// Add another string and more integers.
mixedList.Add("Second Group:");
for (int j = 5; j < 10; j++)
{
mixedList.Add(j);
}
// Display the elements in the list. Declare the loop variable by
// using var, so that the compiler assigns its type.
foreach (var item in mixedList)
{
// Rest the mouse pointer over item to verify that the elements
// of mixedList are objects.
Console.WriteLine(item);
}
// The following loop sums the squares of the first group of boxed
// integers in mixedList. The list elements are objects, and cannot
// be multiplied or added to the sum until they are unboxed. The
// unboxing must be done explicitly.
var sum = 0;
for (var j = 1; j < 5; j++)
{
// The following statement causes a compiler error: Operator
// '*' cannot be applied to operands of type 'object' and
// 'object'.
//sum += mixedList[j] * mixedList[j]);
// After the list elements are unboxed, the computation does
// not cause a compiler error.
sum += (int)mixedList[j] * (int)mixedList[j];
}
// The sum displayed is 30, the sum of 1 + 4 + 9 + 16.
Console.WriteLine("Sum: " + sum);
// Output:
// Answer42True
// First Group:
// 1
// 2
// 3
// 4
// Second Group:
// 5
// 6
// 7
// 8
// 9
// Sum: 30
Performans
Basit atamalar ile bağlantılı olarak, kutulama ve kutulamayı açma işlemleri işlemsel olarak pahalı işlemlerdir. Bir değer türü kutu içinde olduğunda, yeni bir nesne ayrılmış ve oluşturulmuş gerekir. Daha düşük bir ölçüde, kutulama için gereken cast işlemi de işlem olarak pahalıdır. Daha fazla bilgi için bkz. Performans.
Kutulama
Kutulama, değer türlerini atık olarak toplanan yığında depolamak için kullanılır. Kutulama, bir değer türünün türe veya bu değer türü tarafından uygulanan herhangi bir arabirim object türüne örtülü bir dönüştürme işlemidir. Bir değer türü kutulama yığında bir nesne örneği ayırır ve değeri yeni nesneye kopyalar.
Bir değer türü değişkeninin aşağıdaki bildirimini göz önünde bulundurun:
int i = 123;
Aşağıdaki deyim, boxing işlemi değişkenini örtülü olarak i uygular:
// Boxing copies the value of i into object o.
object o = i;
Bu deyimin sonucu, yığında yığın üzerinde türünde bir değere başvurulan bir o nesne int başvurusu oluşturmaktır. Bu değer, değişkenine atanan değer türü değerinin bir i kopyasıdır. İki değişken (ve) i arasındaki o fark, kutulama dönüştürmenin aşağıdaki görüntüsünde gösterildiği gibi:

Kutulama aşağıdaki örnekte olduğu gibi açıkça da mümkündür, ancak açık kutulama hiçbir zaman gerekli değildir:
int i = 123;
object o = (object)i; // explicit boxing
Örnek
Bu örnek, kutulama kullanarak tamsayı i değişkenlerini o bir nesneye dönüştürür. Ardından, değişkende depolanan değeri i olarak 123 456 değiştirilir. Örnekte özgün değer türü ve kutu halindeki nesne ayrı bellek konumları kullanır ve bu nedenle farklı değerleri depolar.
class TestBoxing
{
static void Main()
{
int i = 123;
// Boxing copies the value of i into object o.
object o = i;
// Change the value of i.
i = 456;
// The change in i doesn't affect the value stored in o.
System.Console.WriteLine("The value-type value = {0}", i);
System.Console.WriteLine("The object-type value = {0}", o);
}
}
/* Output:
The value-type value = 456
The object-type value = 123
*/
Kutulama
Kutulama, türden değer türüne veya arabirim türünden arabirimi object uygulayan bir değer türüne açık bir dönüştürmedir. Kutulamadan çalışma şu işlemlerden oluşur:
Nesne örneğini işaret ederek verilen değer türünün kutu içinde bir değer olduğundan emin olun.
Örnekteki değeri değer türü değişkenine kopyalama.
Aşağıdaki deyimler hem kutulama hem de kutudan açma işlemlerini gösteriyor:
int i = 123; // a value type
object o = i; // boxing
int j = (int)o; // unboxing
Aşağıdaki şekilde, önceki deyimlerin sonucu gösterildi:

Değer türlerinin çalışma zamanında başarıyla kutudan başarıyla unboxing için, kutulandırılan öğe, daha önce bu değer türünün bir örneğini kutulama tarafından oluşturulmuş bir nesneye başvuru olması gerekir. Kutusunun unbox'un un unbox null denemesi bir neden NullReferenceException olur. Uyumsuz bir değer türüne yapılan bir başvurunun kutusunu unbox'a almak bir neden InvalidCastException olur.
Örnek
Aşağıdaki örnekte geçersiz bir kutulama durumu ve sonuçta elde edilen . InvalidCastException tryve catch kullanılarak hata oluştuğunda bir hata iletisi görüntülenir.
class TestUnboxing
{
static void Main()
{
int i = 123;
object o = i; // implicit boxing
try
{
int j = (short)o; // attempt to unbox
System.Console.WriteLine("Unboxing OK.");
}
catch (System.InvalidCastException e)
{
System.Console.WriteLine("{0} Error: Incorrect unboxing.", e.Message);
}
}
}
Bu program şunları çıkış olarak sağlar:
Specified cast is not valid. Error: Incorrect unboxing.
deyimini değiştirirsiniz:
int j = (short)o;
Yeni değer:
int j = (int)o;
dönüştürme gerçekleştirilir ve çıktıyı alırsiniz:
Unboxing OK.
C# dili belirtimi
Daha fazla bilgi edinmek için, bkz. C# Dil Belirtimi. Dil belirtimi, C# sözdizimi ve kullanımı için kesin bir kaynaktır.