Kutulama ve Kutudan Çıkarma (C# Programlama Kılavuzu)

Kutulama, bir değer türünü türeobject veya bu değer türü tarafından uygulanan herhangi bir arabirim türüne dönüştürme işlemidir. Ortak dil çalışma zamanı (CLR) bir değer türünü kutuladığında, değeri bir System.Object örneğin içine sarmalar ve yönetilen yığında depolar. Kutu açma, nesneden değer türünü ayıklar. Boks örtülüdür; kutu açma açık. Kutulama ve kutu açma kavramı, herhangi bir türdeki değerin nesne olarak ele alınabileceği tür sisteminin C# birleşik görünümünün altını çizer.

Aşağıdaki örnekte, tamsayı değişkeni ikutulanır ve nesnesine oatanır.

int i = 123;
// The following line boxes i.
object o = i;

o Nesne daha sonra kutusu kaldırılabilir ve tamsayı değişkenine iatanabilir:

o = 123;
i = (int)o;  // unboxing

Aşağıdaki örneklerde, C# dilinde kutulamanın nasıl kullanıldığı gösterilmektedir.

// 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 atamalarla ilgili olarak, kutulama ve kutu açma işlem açısından pahalı işlemlerdir. Bir değer türü kutulandığında, yeni bir nesne ayrılıp oluşturulmalıdır. Daha az bir dereceye kadar, kutu açma için gereken tür dönüştürme işlemi de hesaplama açısından pahalıdır. Daha fazla bilgi için bkz . Performans.

Kutulama

Boks, değer türlerini çöp toplama yığınında depolamak için kullanılır. Kutulama, bir değer türünün türeobject veya bu değer türü tarafından uygulanan herhangi bir arabirim türüne örtük bir dönüşümüdür. Değer türünün kutulanması 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şlemini değişkenine iörtük olarak uygular:

// Boxing copies the value of i into object o.
object o = i;

Bu deyimin sonucu yığında yığındaki türünde intbir değere başvuran bir nesne başvurusu ooluşturmaktır. Bu değer, değişkenine iatanan değer türü değerinin bir kopyasıdır. ve oiki değişkeni arasındaki fark, i aşağıdaki kutu dönüştürme görüntüsünde gösterilmiştir:

Graphic showing the difference between i and o variables.

Aşağıdaki örnekte olduğu gibi kutulama açıkça gerçekleştirilmesi de 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 bir tamsayı değişkensini i bir nesneye o dönüştürür. Ardından değişkeninde i depolanan değer olarak 123456değiştirilir. Örnekte, özgün değer türü ile kutulu nesnenin ayrı bellek konumları kullandığı ve bu nedenle farklı değerleri depolayabildiği gösterilmektedir.

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

Kutu açma, türünden objectbir değer türüne veya arabirim türünden arabirimi uygulayan bir değer türüne açık bir dönüştürmedir. Kutu açma işlemi şunlardan oluşur:

  • Verilen değer türünün kutulanmış değeri olduğundan emin olmak için nesne örneği denetleniyor.

  • Örnekteki değeri değer türü değişkenine kopyalama.

Aşağıdaki deyimler hem kutulama hem de kutu açma işlemlerini gösterir:

int i = 123;      // a value type
object o = i;     // boxing
int j = (int)o;   // unboxing

Aşağıdaki şekilde, önceki deyimlerin sonucu gösterilmektedir:

Graphic showing an unboxing conversion.

Çalışma zamanında değer türlerinin kutusundan çıkarılma işleminin başarılı olması için, kutudan kaldırılan öğenin daha önce bu değer türünün bir örneğini kutulayarak oluşturulmuş bir nesneye başvuru olması gerekir. Kutusunun null kaldırılmaya çalışılması bir NullReferenceExceptionneden olur. Uyumsuz bir değer türüne yapılan başvuruyu kutusundan kaldırma girişimi, bir InvalidCastExceptionneden olur.

Örnek

Aşağıdaki örnekte, geçersiz bir kutu açma durumu ve sonuçta elde edilen InvalidCastExceptiongösterilir. ve trycatchkullanıldığında, 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 oluşturur:

Specified cast is not valid. Error: Incorrect unboxing.

deyimini değiştirirseniz:

int j = (short)o;

Yeni değer:

int j = (int)o;

dönüştürme gerçekleştirilir ve çıkışı alırsınız:

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.

Ayrıca bkz.