دالة CType

يقوم بإرجاع نتيجة تحويل تعبير إلى نوع بيانات محدد، كائن، بنية، فئة، أو الواجهة بشكل صريح.

CType(expression, typename)

الأجزاء

  • expression
    أي تعبير صالح. إذا كانت قيمة expression خارج النطاق المسموح به من قبل typename، يطرح Visual Basic استثناء.

  • typename
    أي تعبير قانوني داخل بند As في عبارة Dim التي هي اسم لأي نوع بيانات، كائن، بنية، فئة أو واجهة.

ملاحظات

CType يتم تحويله البرمجي بشكل مضمن، مما يعني أن التعليمات البرمجية للتحويل هي جزء من التعليمات البرمجية التي تقيم التعبير. في بعض الحالات لا يوجد أي استدعاء لإجراء لإنجاز التحويل، الذي يجعل التنفيذ أسرع.

إذا لم يتم تعريف تحويل من expression إلى typename، على سبيل المثال من Integer إلى Date، يعرض Visual Basic رسالة خطأ في وقت التحويل البرمجي.

إذا فشل التحويل في وقت التشغيل، يظهر الاستثناء المناسب. إذا فشل تحويل تضييقي, OverflowException يكون الناتج الأكثر شيوعاً. إذا كان التحويل غير معرّف, يظهر InvalidCastException. يمكن أن يحدث هذا, على سبيل المثال، إذا كان expression من نوع Object لا يوجد تحويل لنوع وقت التشغيل الخاص به إلى typename.

إذا كان نوع البيانات من expression أو typename هو فئة أو بنية قمت بتعريفها، يمكنك تعريف CType على تلك الفئة أو البنية كعامل تحويل. هذا يجعل CType تعمل كأنها عامل التشغيل محمل بشكل زائد. إذا قمت بذلك، يمكنك التحكم في سلوك التحويلات إلى و من فئة أو بنية, متضمناً الاستثناءات التي قد يتم طرحها.

التحميل الزائد

عامل التشغيل CType يمكن أيضاً أن يحمل بشكل زائد على فئة أو بنية معرفه خارج التعليمات البرمجية الخاصة بك. إذا كانت التعليمات البرمجية تحول إلى أو من مثل هذه الفئة أو البنية، يجب التأكد من أنك تفهم سلوك عامل التشغيل CType الخاص به. لمزيد من المعلومات، راجع إجراءات عامل التشغيل.

تحويل كائنات ديناميكية

إذا كنت تعمل مع كائنات ديناميكية، حيث يتم تنفيذ تحويلات نوع بواسطة تحويلات ديناميكية معرفة من قبل مستخدم التي تستخدم أساليب TryConvert أو BindConvert، استخدام أساليب CTypeDynamic أو CTypeDynamic لتحويل الكائن الديناميكي.

مثال

يستخدم المثال التالي دالة CType لتحويل تعبير إلى نوع بيانات محدد.

Dim testNumber As Long = 1000
' The following line of code sets testNewType to 1000.0.
Dim testNewType As Single = CType(testNumber, Single)

راجع أيضًا:

المهام

كيفية القيام بما يلي: تعريف تحويل عامل التشغيل

المرجع

دوال تحويل النوع

دالات التحويل (Visual Basic)

OverflowException

InvalidCastException

كشف العامل