تحويل النوع في .NET Framework
تحتوي كل قيمة على نوع مقترن، والذي يقوم بتعريف سمات مثل مقدار المساحة المخصصة للقيمة ونطاق القيم المحتملة التي يمكن أن تصل لها، والأعضاء المتوفرة. يمكن التعبير عن القيم بأكثر من نوع واحد. على سبيل المثال، صواب يمكن التعبير عن القيمة 4 كقيمة عدد صحيح أو كقيمة فاصلة عائمة. يقوم تحويل النوع بإنشاء قيمة في نوع جديد مكافئ لقيمة نوع قديم، ولكن ليس بالضرورة أن يحافظ علي الهوية (أو القيمة الصحيحة) للكائن الأصلي.
يوفر .NET Framework عدة ميزات تدعم تحويل النوع. وتتضمن ما يلي:
العامل Implicit، والذي يقوم بتعريف التحويل التوسيعي المتوفر بين الأنواع. لمزيد من المعلومات، راجع المقطع التحويل الضمني باستخدام عامل ضمني.
العامل Explicit، والذي يقوم بتعريف التحويل التضييقي المتوفر بين الأنواع. لمزيد من المعلومات، راجع المقطع التحويل الصريح باستخدام عامل صريح.
الواجهة IConvertible ، والتي تعرّف تحويلات لكل أنواع البيانات الأساسية في .NET Framework. لمزيد من المعلومات، راجع المقطع الواجهة IConvertible.
الفئة Convert، والتي توفر مجموعة من الأساليب التي تقوم بتنفيذ الأساليب الموجودة في الواجهة IConvertible. لمزيد من المعلومات، راجع المقطع فئة التحويل.
الفئة TypeConverter هي فئة أساسية يمكن توسيعها لتدعم التحويل من النوع المحدد إلي أي نوع اَخر. لمزيد من المعلومات، راجع المقطع فئة TypeConverter.
التحويل الضمني باستخدام عامل الضمني
تتضمن عمليات التحويل التوسيعي إنشاء قيمة جديدة من قيمة نوع موجود مسبقاً والتي إما أن يكون نطاقها أكثر تقييداً أو تكون قائمة أعضاءها أكثر تقييداً من نوع الهدف. لا ينتج عن تحويلات فقد في البيانات (على الرغم من أن أنها قد تؤدي إلى فقدان في الدقة). لأن البيانات لا يمكن أن تفقد، فتستطيع المحولات البرمجية معالجة التحويل ضمنياً أو بشفافية، دون الحاجة إلى استخدام أسلوب تحويل صريح أو عامل تحويل للنوع.
.gif "ملاحظة") ملاحظة |
|---|
على الرغم من أن التعليمة البرمجية التي تستطيع أن تنفذ التحويل يمكنها أن تقوم باستدعاء أسلوب تحويل أو استخدام عامل تحويل للنوع، فاستخدامهم غير مطلوب من قبل المحولات البرمجية التي تدعم التحويلات الضمنية. |
على سبيل المثال، النوع Decimal يدعم تحويلات ضمنية من القيم Byte ، Char ، Int16 ، Int32 ، Int64 ، SByte ، UInt16 ، UInt32 ، UInt64. يوضح المثال التالي بعض هذه التحويلات الضمنية بتعيين القيم إلى المتغير Decimal .
Dim byteValue As Byte = 16
Dim shortValue As Short = -1024
Dim intValue As Integer = -1034000
Dim longValue As Long = CLng(1024^6)
Dim ulongValue As ULong = ULong.MaxValue
Dim decimalValue As Decimal
decimalValue = byteValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
byteValue.GetType().Name, decimalValue)
decimalValue = shortValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
shortValue.GetType().Name, decimalValue)
decimalValue = intValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
intValue.GetType().Name, decimalValue)
decimalValue = longValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
longValue.GetType().Name, decimalValue)
decimalValue = ulongValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
longValue.GetType().Name, decimalValue)
' The example displays the following output:
' After assigning a Byte value, the Decimal value is 16.
' After assigning a Int16 value, the Decimal value is -1024.
' After assigning a Int32 value, the Decimal value is -1034000.
' After assigning a Int64 value, the Decimal value is 1152921504606846976.
' After assigning a Int64 value, the Decimal value is 18446744073709551615.
byte byteValue = 16;
short shortValue = -1024;
int intValue = -1034000;
long longValue = 1152921504606846976;
ulong ulongValue = UInt64.MaxValue;
decimal decimalValue;
decimalValue = byteValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
byteValue.GetType().Name, decimalValue);
decimalValue = shortValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
shortValue.GetType().Name, decimalValue);
decimalValue = intValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
intValue.GetType().Name, decimalValue);
decimalValue = longValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
longValue.GetType().Name, decimalValue);
decimalValue = ulongValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
longValue.GetType().Name, decimalValue);
// The example displays the following output:
// After assigning a Byte value, the Decimal value is 16.
// After assigning a Int16 value, the Decimal value is -1024.
// After assigning a Int32 value, the Decimal value is -1034000.
// After assigning a Int64 value, the Decimal value is 1152921504606846976.
// After assigning a Int64 value, the Decimal value is 18446744073709551615.
إذا كان برنامج تحويل برمجي للغة معينة يدعم عوامل التشغيل المخصصة، فيمكنك أيضاً تعريف تحويلات ضمنية في الأنواع المخصصة الخاصة بك. يوفر المثال التالي تطبيق جزئي لنوع بيانات بايت موقع باسم ByteWithSign والذي يستخدم تمثيل الإشارة و المقدار. وهو يدعم التحويل الضمني للقيم Byte و SByte إلي القيم ByteWithSign.
Public Structure ByteWithSign
Private signValue As SByte
Private value As Byte
Public Overloads Shared Widening Operator CType(value As SByte) As ByteWithSign
Dim newValue As ByteWithSign
newValue.signValue = CSByte(Math.Sign(value))
newValue.value = CByte(Math.Abs(value))
Return newValue
End Operator
Public Overloads Shared Widening Operator CType(value As Byte) As ByteWithSign
Dim NewValue As ByteWithSign
newValue.signValue = 1
newValue.value = value
Return newValue
End Operator
Public Overrides Function ToString() As String
Return (signValue * value).ToString()
End Function
End Structure
public struct ByteWithSign
{
private SByte signValue;
private Byte value;
public static implicit operator ByteWithSign(SByte value)
{
ByteWithSign newValue;
newValue.signValue = (SByte) Math.Sign(value);
newValue.value = (byte) Math.Abs(value);
return newValue;
}
public static implicit operator ByteWithSign(Byte value)
{
ByteWithSign newValue;
newValue.signValue = 1;
newValue.value = value;
return newValue;
}
public override string ToString()
{
return (signValue * value).ToString();
}
}
يمكن للتعليمات البرمجية الموجودة التي تعمل عند العميل عندئذ أن تقوم بتعريف المتغير ByteWithSign وتعيينه إلي القيم Byte و SByte بدون إجراء أية تحويلات صريحة أو استخدام أي عوامل تحويل للنوع كما يعرض المثال التالي.
Dim sbyteValue As SByte = -120
Dim value As ByteWithSign = sbyteValue
Console.WriteLine(value.ToString())
value = Byte.MaxValue
Console.WriteLine(value.ToString())
' The example displays the following output:
' -120
' 255
SByte sbyteValue = -120;
ByteWithSign value = sbyteValue;
Console.WriteLine(value);
value = Byte.MaxValue;
Console.WriteLine(value);
// The example displays the following output:
// -120
// 255
العودة إلى الأعلى
التحويل الصريح باستخدام عامل صريح
تتضمن عمليات التحويل التضييقي إنشاء قيم جديدة من قيمة لنوع موجود مسبقاً والذي يكون لديها إما نطاق أكبر أو قائمة أعضاء أكبر من نوع الهدف. بسبب إجراء تحويل تضييقي يمكن أن يؤدي فقدان في البيانات، غالباً ما تتطلب المحولات البرمجية أن يتم إجراء التحويل الصريح من خلال استدعاء أسلوب تحويل أو عامل تحويل للنوع. بمعني، يجب معالجة التحويل بشكل صريح في التعليمات البرمجية الخاصة بالمطور.
| ملاحظة |
|---|
الغرض الرئيسي من طلب أسلوب تحويل أو عامل تحويل النوع لتضييق التحويلات لكي تجعل المطور واعي باحتمالية فقدان البيانات أو OverflowException بحيث يكون قادر علي معالجة هذا في التعليمات البرمجية.ومع ذلك، يمكن أن تتسامح بعض المحولات البرمجية مع هذا الطلب.على سبيل المثال، في Visual Basic ، إذا كان Option Strict مغلق off (الإعداد الافتراضي الخاص به)، فسيحاول برنامج التحويل البرمجي Visual Basic إجراء تحويل تضييقي ضمنياً. |
على سبيل المثال، أنواع البيانات UInt32 ، Int64 ، و UInt64 لديها نطاقات تتجاوز نوع البيانات Int32، كما يوضح الجدول التالي.
Type |
المقارنة مع نطاق Int32 |
|---|---|
Int64.MaxValue أكبر من Int32.MaxValue ، وInt64.MinValue أقل من (يحتوي على نطاق سالب أكبر من)Int32.MinValue. |
|
UInt32.MaxValueأكبر من Int32.MaxValue. |
|
UInt64.MaxValueأكبر من Int32.MaxValue. |
لمعالجة مثل هذا التحويل التضييقي: يسمح .NET Framework للأنواع أن تقوم بتعريف العامل Explicit. ثم يمكن لمحولات اللغة الفردية أن تقوم بتطبيق عامل التشغيل هذا باستخدام بناء الجملة الخاصة بهم، أو يمكن استدعاء عضو من الفئة Convert لإجراء التحويل. (لمزيد من المعلومات حول الفئة Convert، راجع فئة تحويل لاحقًا في هذا الموضوع.) يوضح المثال التالي استخدام ميزات اللغة لمعالجة التحويل الصريح من قيم الأعداد الصحيحة تلك التي يمكن أن تكون خارج النطاق إلي القيم Int32.
Dim number1 As Long = Integer.MaxValue + 20L
Dim number2 As UInteger = Integer.MaxValue - 1000
Dim number3 As ULong = Integer.MaxValue
Dim intNumber As Integer
Try
intNumber = CInt(number1)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number1.GetType().Name, intNumber)
Catch e As OverflowException
If number1 > Integer.MaxValue Then
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, Integer.MaxValue)
Else
Console.WriteLine("Conversion failed: {0} is less than {1}.\n",
number1, Integer.MinValue)
End If
End Try
Try
intNumber = CInt(number2)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number2.GetType().Name, intNumber)
Catch e As OverflowException
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number2, Integer.MaxValue)
End Try
Try
intNumber = CInt(number3)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number3.GetType().Name, intNumber)
Catch e As OverflowException
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, Integer.MaxValue)
End Try
' The example displays the following output:
' Conversion failed: 2147483667 exceeds 2147483647.
' After assigning a UInt32 value, the Integer value is 2147482647.
' After assigning a UInt64 value, the Integer value is 2147483647.
long number1 = int.MaxValue + 20L;
uint number2 = int.MaxValue - 1000;
ulong number3 = int.MaxValue;
int intNumber;
try {
intNumber = checked((int) number1);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number1.GetType().Name, intNumber);
}
catch (OverflowException) {
if (number1 > int.MaxValue)
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, int.MaxValue);
else
Console.WriteLine("Conversion failed: {0} is less than {1}.",
number1, int.MinValue);
}
try {
intNumber = checked((int) number2);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number2.GetType().Name, intNumber);
}
catch (OverflowException) {
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number2, int.MaxValue);
}
try {
intNumber = checked((int) number3);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number3.GetType().Name, intNumber);
}
catch (OverflowException) {
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, int.MaxValue);
}
// The example displays the following output:
// Conversion failed: 2147483667 exceeds 2147483647.
// After assigning a UInt32 value, the Integer value is 2147482647.
// After assigning a UInt64 value, the Integer value is 2147483647.
قد يينتج من التحويلات الصريحة نتائج مختلفة في لغات مختلفة، و يمكن أن تختلف هذه النتائج عن القيمة التي تم إرجاعها بواسطة الأسلوب المطابق Convert. على سبيل المثال، إذا Doubleالقيمة 12.63251 هو محولها إلى Int32، كلا من Vهوual الأساسية CIntالطريقة وإطار عمل.NET Convert.ToInt32(Double)الأسلوب الدائري Doubleإرجاع قيمة من 13، لكن C# (int)اقتطاع العامل Doubleلإرجاع قيمة 12. وبشكل مماثل، C# (int)operaإلىr لا يعتمد التحويل Boolean-إلى-integer، لكن Visual أساسى CIntالطريقة بتحويل القيمة trueإلى-1. تشغيل يد غير ذلك، Convert.ToInt32(Boolean)أسلوب تحويل القيمة trueإلى 1.
تسمح معظم المحولات البرمجية للتحويلات صريحة بأن يتم تنفيذها بطريقة محددة أو غير محددة. عند تنفيذ التحويل بطريقة محددة، فسيتم طرح OverflowException عندما يتم تحويل قيمة النوع خارج نطاق نوع الهدف. عند تنفيذ التحويل غير المحدد تحت نفس الظروف، قد لايقوم التحويل بطرح استثناء، ولكن السلوك بالضبط قد يصبح غير محدد و قد ينتج عنه قيمة غير صحيحة.
| ملاحظة |
|---|
في C# ، يمكن أن يتم تنفيذ التحويلات المحددة باستخدام الكلمة الأساسية checked مع عامل تحويل النوع، أو بواسطة تحديد خيارات المحول البرمجي /checked+.في C# ، يمكن أن يتم تنفيذ التحويلات غير المحددة باستخدام الكلمة الأساسية unchecked مع عامل تحويل النوع، أو بواسطة تحديد خيارات المحول البرمجي /checked-.بشكل افتراضي، تكون التحويلات صريحة غير محددة.في Visual Basic، يمكن تنفيذ تحويلات محددة بواسطة مسح خانة الاختيار Remove في مربع الحوارإعدادات المحول البرمجي المتقدمة للمشروع، أو بتحديد خيار المحول /removeintchecks-.علي النقيض، يمكن تنفيذ تحويلات غير محددة بواسطة تحديد خانة الاختيار Remove في مربع الحوارإعدادات المحول البرمجي المتقدمة للمشروع، أو بتحديد خيار المحول /removeintchecks+.بشكل افتراضي، تكون التحويلات الصريحة غير محددة. |
يستخدم مثال C# التالي الكلمات الأساسية checked و unchecked لتوضيح الاختلاف في السلوك عندما يتم تحويل قيمة خارج النطاق Byte إلي Byte. يطرح التحويل المحدد استثناء، ولكن يقوم التحويل غير المحدد بتعيين Byte.MaxValue إلي المتغير Byte.
int largeValue = Int32.MaxValue;
byte newValue;
try {
newValue = unchecked((byte) largeValue);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
largeValue.GetType().Name, largeValue,
newValue.GetType().Name, newValue);
}
catch (OverflowException) {
Console.WriteLine("{0} is outside the range of the Byte data type.",
largeValue);
}
try {
newValue = checked((byte) largeValue);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
largeValue.GetType().Name, largeValue,
newValue.GetType().Name, newValue);
}
catch (OverflowException) {
Console.WriteLine("{0} is outside the range of the Byte data type.",
largeValue);
}
// The example displays the following output:
// Converted the Int32 value 2147483647 to the Byte value 255.
// 2147483647 is outside the range of the Byte data type.
إذا كان برنامج تحويل برمجي للغة معينة يدعم عوامل تحميل زائد مخصصة، فيمكنك أيضاً تعريف تحويلات صريحة في الأنواع المخصصة الخاصة بك. يوفر المثال التالي تطبيق جزئي لنوع بيانات بايت موقع باسم ByteWithSign والذي يستخدم تمثيل الإشارة و المقدار. وهو يدعم التحويل الصريح للقيم Int32 و UInt32 إلي القيم ByteWithSign.
Public Structure ByteWithSign
Private signValue As SByte
Private value As Byte
Private Const MaxValue As Byte = Byte.MaxValue
Private Const MinValue As Integer = -1 * Byte.MaxValue
Public Overloads Shared Narrowing Operator CType(value As Integer) As ByteWithSign
' Check for overflow.
If value > ByteWithSign.MaxValue Or value < ByteWithSign.MinValue Then
Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
End If
Dim newValue As ByteWithSign
newValue.signValue = CSByte(Math.Sign(value))
newValue.value = CByte(Math.Abs(value))
Return newValue
End Operator
Public Overloads Shared Narrowing Operator CType(value As UInteger) As ByteWithSign
If value > ByteWithSign.MaxValue Then
Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
End If
Dim NewValue As ByteWithSign
newValue.signValue = 1
newValue.value = CByte(value)
Return newValue
End Operator
Public Overrides Function ToString() As String
Return (signValue * value).ToString()
End Function
End Structure
public struct ByteWithSign
{
private SByte signValue;
private Byte value;
private const byte MaxValue = byte.MaxValue;
private const int MinValue = -1 * byte.MaxValue;
public static explicit operator ByteWithSign(int value)
{
// Check for overflow.
if (value > ByteWithSign.MaxValue || value < ByteWithSign.MinValue)
throw new OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.",
value));
ByteWithSign newValue;
newValue.signValue = (SByte) Math.Sign(value);
newValue.value = (byte) Math.Abs(value);
return newValue;
}
public static explicit operator ByteWithSign(uint value)
{
if (value > ByteWithSign.MaxValue)
throw new OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.",
value));
ByteWithSign newValue;
newValue.signValue = 1;
newValue.value = (byte) value;
return newValue;
}
public override string ToString()
{
return (signValue * value).ToString();
}
}
تستطيع التعليمات البرمجية للعميل أن تقوم عندئذ بتعريف المتغير ByteWithSign وتعيينه للقيم Int32 و UInt32 إذا كانت التعيينات تتضمين عامل تحويل للنوع أو أسلوب تحويل، كما يوضح المثال التالي.
Dim value As ByteWithSign
Try
Dim intValue As Integer = -120
value = CType(intValue, ByteWithSign)
Console.WriteLine(value)
Catch e As OverflowException
Console.WriteLine(e.Message)
End Try
Try
Dim uintValue As UInteger = 1024
value = CType(uintValue, ByteWithSign)
Console.WriteLine(value)
Catch e As OverflowException
Console.WriteLine(e.Message)
End Try
' The example displays the following output:
' -120
' '1024' is out of range of the ByteWithSign data type.
ByteWithSign value;
try {
int intValue = -120;
value = (ByteWithSign) intValue;
Console.WriteLine(value);
}
catch (OverflowException e) {
Console.WriteLine(e.Message);
}
try {
uint uintValue = 1024;
value = (ByteWithSign) uintValue;
Console.WriteLine(value);
}
catch (OverflowException e) {
Console.WriteLine(e.Message);
}
// The example displays the following output:
// -120
// '1024' is out of range of the ByteWithSign data type.
العودة إلى الأعلى
الواجهة IConvertible
لدعم التحويل أي نوع إلى النوع الأساسي لوقت تشغيل الغة العامة، يوفر .NET Framework الواجهة IConvertible. يكون نوع التنفيذ مطلوب لتوفير ما يلي:
أسلوب إرجاع في TypeCode من نوع التنفيذ.
أساليب لتحويل نوع التنفيذ إلي كل نوع أساسي لوقت تشغيل اللغة العامة ( Boolean ، Byte ، DateTime ، Decimal ، Double وهكذا).
أسلوب تحويل معمم لتحويل مثيل من نوع التنفيذ إلي نوع آخر محدد. تقوم التحويلات الغير مدعمة بطرح InvalidCastException.
كل نوع أساسي لوقت تشغيل اللغة العامة (بمعني، الأنواع Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32, and UInt64), وايضاً الأنواع DBNull و Enum تقوم بتنفيذ الواجهة IConvertible. ومع ذلك، هذه هي التطبيقات الصريحة للواجهات; يمكن لأسلوب التحويل أن يتم استدعاءه فقط من خلال متغير الواجهة IConvertible، كما يوضح المثال التالي. يقوم هذا المثال بتحويل القيمة Int32 إلي قيمة Char المكافئة لها.
Dim codePoint As Integer = 1067
Dim iConv As IConvertible = codePoint
Dim ch As Char = iConv.ToChar(Nothing)
Console.WriteLine("Converted {0} to {1}.", codePoint, ch)
int codePoint = 1067;
IConvertible iConv = codePoint;
char ch = iConv.ToChar(null);
Console.WriteLine("Converted {0} to {1}.", codePoint, ch);
متطلبات استدعاء الأسلوب التحويل على الواجهة الخاصة به بدلاً من نوع التنفيذ يجعل تطبيق الواجهة الصريح مكلف نسبيًا. و بدلاً من ذلك، نوصي باستدعاء العضو المناسب من الفئة Convert للتحويل بين الأنواع الأساسية للغة وقت التشغيل العامة. لمزيد من المعلومات، راجع المقطع التالي فئة التحويل.
| ملاحظة |
|---|
بالإضافة إلى الواجهة IConvertible و الفئة Convertالتموفرة من قبل .NET Framework، قد توفر اللغات الفردية أيضاً طرق تنفيذ للتحويلات.على سبيل المثال، تستخدم C# عوامل تحويل للنوع; و تستخدم Visual Basic دالات تحويل مُنفذة ببرنامج التحويل البرمجي مثل CType، و CInt، و DirectCast. |
في معظم الحالات، تم تصميم الواجهة IConvertible لدعم التحويل بين الأنواع الأساسية في .NET Framework. ومع ذلك، يمكن أيضاً تطبيق الواجهة بواسطة نوع مخصص لدعم التحويل لهذا النوع إلى أنواع أخرى مخصصة. لمزيد من المعلومات، راجع المقطع التحويلات المخصص مع أسلوب ChangeType لاحقًا في هذا الموضوع.
العودة إلى الأعلى
فئة التحويل
على الرغم من أنه يمكن استدعاء كل نوع أساسي لتطبيق الواجهة IConvertible لإجراء تحويل نوع، فمن المستحسن استدعاء الأساليب من الفئة System.Convert كطريقة محايدة للغة للتحويل من نوع أساسي واحد إلى نوع أساسي آخر. بالإضافة إلى ذلك، يمكن استخدام الأسلوب Convert.ChangeType(Object, Type, IFormatProvider) للتحويل من نوع مخصص محدد إلى نوع آخر.
التحويلات بين الأنواع الأساسية
توفر الفئة Convert طريقة محايدة للغة لتنفيذ تحويلات بين الأنواع الأساسية وهي متوفرة لكافة اللغات التي تستهدف وقت تشغيل اللغة العامة. وتوفر مجموعة كاملة من أساليب لكل من تحويلات التوسيع و تحويلات التضييق، ثم تطرح InvalidCastException للتحويلات غير المدعمة (مثل تحويل القيمة DateTimeإلي قيمة عدد صحيح). يتم تنفيذ تحويلات تضييقية في سياق محدد، و يتم طرح OverflowException إذا فشل التحويل.
.gif "ملاحظة هامة") هام |
|---|
لأن الفئة Convert تتضمن أساليب للتحويل إلى ومن كل نوع أساسي، فإنها تقلل الحاجة إلى استدعاء كل نوع أساسي لتطبيق الواجهة الصريح IConvertible. |
يوضح المثال التالي استخدام الفئة System.Convert لتنفيذ تحويلات متعددة توسيعة و تضييقة بين الأنواع الأساسي في.NET Framework.
' Convert an Int32 value to a Decimal (a widening conversion).
Dim integralValue As Integer = 12534
Dim decimalValue As Decimal = Convert.ToDecimal(integralValue)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3:N2}.",
integralValue.GetType().Name,
integralValue,
decimalValue.GetType().Name,
decimalValue)
' Convert a Byte value to an Int32 value (a widening conversion).
Dim byteValue As Byte = Byte.MaxValue
Dim integralValue2 As Integer = Convert.ToInt32(byteValue)
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
byteValue.GetType().Name,
byteValue,
integralValue2.GetType().Name,
integralValue2)
' Convert a Double value to an Int32 value (a narrowing conversion).
Dim doubleValue As Double = 16.32513e12
Try
Dim longValue As Long = Convert.ToInt64(doubleValue)
Console.WriteLine("Converted the {0} value {1:E} to " +
"the {2} value {3:N0}.",
doubleValue.GetType().Name,
doubleValue,
longValue.GetType().Name,
longValue)
Catch e As OverflowException
Console.WriteLine("Unable to convert the {0:E} value {1}.",
doubleValue.GetType().Name, doubleValue)
End Try
' Convert a signed byte to a byte (a narrowing conversion).
Dim sbyteValue As SByte = -16
Try
Dim byteValue2 As Byte = Convert.ToByte(sbyteValue)
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
sbyteValue.GetType().Name,
sbyteValue,
byteValue2.GetType().Name,
byteValue2)
Catch e As OverflowException
Console.WriteLine("Unable to convert the {0} value {1}.",
sbyteValue.GetType().Name, sbyteValue)
End Try
' The example displays the following output:
' Converted the Int32 value 12534 to the Decimal value 12,534.00.
' Converted the Byte value 255 to the Int32 value 255.
' Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
' Unable to convert the SByte value -16.
// Convert an Int32 value to a Decimal (a widening conversion).
int integralValue = 12534;
decimal decimalValue = Convert.ToDecimal(integralValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:N2}.",
integralValue.GetType().Name,
integralValue,
decimalValue.GetType().Name,
decimalValue);
// Convert a Byte value to an Int32 value (a widening conversion).
byte byteValue = Byte.MaxValue;
int integralValue2 = Convert.ToInt32(byteValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
byteValue.GetType().Name,
byteValue,
integralValue2.GetType().Name,
integralValue2);
// Convert a Double value to an Int32 value (a narrowing conversion).
double doubleValue = 16.32513e12;
try {
long longValue = Convert.ToInt64(doubleValue);
Console.WriteLine("Converted the {0} value {1:E} to " +
"the {2} value {3:N0}.",
doubleValue.GetType().Name,
doubleValue,
longValue.GetType().Name,
longValue);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert the {0:E} value {1}.",
doubleValue.GetType().Name, doubleValue);
}
// Convert a signed byte to a byte (a narrowing conversion).
sbyte sbyteValue = -16;
try {
byte byteValue2 = Convert.ToByte(sbyteValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
sbyteValue.GetType().Name,
sbyteValue,
byteValue2.GetType().Name,
byteValue2);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert the {0} value {1}.",
sbyteValue.GetType().Name, sbyteValue);
}
// The example displays the following output:
// Converted the Int32 value 12534 to the Decimal value 12,534.00.
// Converted the Byte value 255 to the Int32 value 255.
// Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
// Unable to convert the SByte value -16.
وفي بعض الحالات، بشكل خاص عند التحويل إلي و من قيم الفاصلة العائمة، قد تؤدي طريقة التحويل إلى فقدان الدقة، حتى إذا لم تقم بطرح OverflowException. يوضح المثال التالي فقدان هذه الدقة. في الحالة الأولى، تحتوي القيمة Decimal على دقة أقل(أرقام هامة أقل) عند تحويلها إلي Double. في الحالة الثانية، يتم تقريب القيمة Double من 42.72 إلي 43 لإتمام التحويل.
Dim doubleValue As Double
' Convert a Double to a Decimal.
Dim decimalValue As Decimal = 13956810.96702888123451471211d
doubleValue = Convert.ToDouble(decimalValue)
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue)
doubleValue = 42.72
Try
Dim integerValue As Integer = Convert.ToInt32(doubleValue)
Console.WriteLine("{0} converted to {1}.",
doubleValue, integerValue)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to an integer.",
doubleValue)
End Try
' The example displays the following output:
' 13956810.96702888123451471211 converted to 13956810.9670289.
' 42.72 converted to 43.
double doubleValue;
// Convert a Double to a Decimal.
decimal decimalValue = 13956810.96702888123451471211m;
doubleValue = Convert.ToDouble(decimalValue);
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue);
doubleValue = 42.72;
try {
int integerValue = Convert.ToInt32(doubleValue);
Console.WriteLine("{0} converted to {1}.",
doubleValue, integerValue);
}
catch (OverflowException) {
Console.WriteLine("Unable to convert {0} to an integer.",
doubleValue);
}
// The example displays the following output:
// 13956810.96702888123451471211 converted to 13956810.9670289.
// 42.72 converted to 43.
للحصول علي جدول يقوم بسرد التحويلات التوسيعية والتضييقية المدعمة من قبل الفئة Convert، راجع جداول تحويل النوع .
التحويلات المخصصة باستخدام أسلوب ChangeType
بالإضافة إلى دعم التحويلات إلي كل نوع أساسي، فإنه يمكن استخدام الفئة Convert لتحويل نوع مخصص إلى نوع واحد أو أكثر معرّف مسبقاً. يتم إجراء هذا التحويل بواسطة الأسلوب Convert.ChangeType(Object, Type, IFormatProvider) ،و الذي بدوره يستدعي الأسلوب IConvertible.ToType من المعلمة value. وهذا يعني أنه الكائن المُمثل بالمعلمة value يجب أن يقوم بتوفير تطبيق للواجهة IConvertible.
يوضح المثال التالي تطبيق ممكن للواجهة IConvertible والتي تسمح للكائن TemperatureCelsius أن يتم تحويله إلى الكائن TemperatureFahrenheit والعكس صحيح. يقوم المثال بتعريف فئة أساسية Temperature، والتي تطبق الواجهة IConvertible و تتجاوز الأسلوب Object.ToString. الفئات المُشتقة TemperatureCelsius و TemperatureFahrenheit تقوم كل منهما بتجاوز الأسلوب ToType و ToString الخاص بالفئة الأساسية.
Public MustInherit Class Temperature
Implements IConvertible
Protected temp As Decimal
Public Sub New(temperature As Decimal)
Me.temp = temperature
End Sub
Public Property Value As Decimal
Get
Return Me.temp
End Get
Set
Me.temp = Value
End Set
End Property
Public Overrides Function ToString() As String
Return temp.ToString() & "º"
End Function
' IConvertible implementations.
Public Function GetTypeCode() As TypeCode Implements IConvertible.GetTypeCode
Return TypeCode.Object
End Function
Public Function ToBoolean(provider As IFormatProvider) As Boolean Implements IConvertible.ToBoolean
Throw New InvalidCastException(String.Format("Temperature-to-Boolean conversion is not supported."))
End Function
Public Function ToByte(provider As IFormatProvider) As Byte Implements IConvertible.ToByte
If temp < Byte.MinValue Or temp > Byte.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the Byte data type.", temp))
Else
Return CByte(temp)
End If
End Function
Public Function ToChar(provider As IFormatProvider) As Char Implements IConvertible.ToChar
Throw New InvalidCastException("Temperature-to-Char conversion is not supported.")
End Function
Public Function ToDateTime(provider As IFormatProvider) As DateTime Implements IConvertible.ToDateTime
Throw New InvalidCastException("Temperature-to-DateTime conversion is not supported.")
End Function
Public Function ToDecimal(provider As IFormatProvider) As Decimal Implements IConvertible.ToDecimal
Return temp
End Function
Public Function ToDouble(provider As IFormatProvider) As Double Implements IConvertible.ToDouble
Return CDbl(temp)
End Function
Public Function ToInt16(provider As IFormatProvider) As Int16 Implements IConvertible.ToInt16
If temp < Int16.MinValue Or temp > Int16.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the Int16 data type.", temp))
End If
Return CShort(Math.Round(temp))
End Function
Public Function ToInt32(provider As IFormatProvider) As Int32 Implements IConvertible.ToInt32
If temp < Int32.MinValue Or temp > Int32.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the Int32 data type.", temp))
End If
Return CInt(Math.Round(temp))
End Function
Public Function ToInt64(provider As IFormatProvider) As Int64 Implements IConvertible.ToInt64
If temp < Int64.MinValue Or temp > Int64.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the Int64 data type.", temp))
End If
Return CLng(Math.Round(temp))
End Function
Public Function ToSByte(provider As IFormatProvider) As SByte Implements IConvertible.ToSByte
If temp < SByte.MinValue Or temp > SByte.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the SByte data type.", temp))
Else
Return CSByte(temp)
End If
End Function
Public Function ToSingle(provider As IFormatProvider) As Single Implements IConvertible.ToSingle
Return CSng(temp)
End Function
Public Overridable Overloads Function ToString(provider As IFormatProvider) As String Implements IConvertible.ToString
Return temp.ToString(provider) & " °C"
End Function
' If conversionType is a implemented by another IConvertible method, call it.
Public Overridable Function ToType(conversionType As Type, provider As IFormatProvider) As Object Implements IConvertible.ToType
Select Case Type.GetTypeCode(conversionType)
Case TypeCode.Boolean
Return Me.ToBoolean(provider)
Case TypeCode.Byte
Return Me.ToByte(provider)
Case TypeCode.Char
Return Me.ToChar(provider)
Case TypeCode.DateTime
Return Me.ToDateTime(provider)
Case TypeCode.Decimal
Return Me.ToDecimal(provider)
Case TypeCode.Double
Return Me.ToDouble(provider)
Case TypeCode.Empty
Throw New NullReferenceException("The target type is null.")
Case TypeCode.Int16
Return Me.ToInt16(provider)
Case TypeCode.Int32
Return Me.ToInt32(provider)
Case TypeCode.Int64
Return Me.ToInt64(provider)
Case TypeCode.Object
' Leave conversion of non-base types to derived classes.
Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
conversionType.Name))
Case TypeCode.SByte
Return Me.ToSByte(provider)
Case TypeCode.Single
Return Me.ToSingle(provider)
Case TypeCode.String
Return Me.ToString(provider)
Case TypeCode.UInt16
Return Me.ToUInt16(provider)
Case TypeCode.UInt32
Return Me.ToUInt32(provider)
Case TypeCode.UInt64
Return Me.ToUInt64(provider)
Case Else
Throw New InvalidCastException("Conversion not supported.")
End Select
End Function
Public Function ToUInt16(provider As IFormatProvider) As UInt16 Implements IConvertible.ToUInt16
If temp < UInt16.MinValue Or temp > UInt16.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the UInt16 data type.", temp))
End If
Return CUShort(Math.Round(temp))
End Function
Public Function ToUInt32(provider As IFormatProvider) As UInt32 Implements IConvertible.ToUInt32
If temp < UInt32.MinValue Or temp > UInt32.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the UInt32 data type.", temp))
End If
Return CUInt(Math.Round(temp))
End Function
Public Function ToUInt64(provider As IFormatProvider) As UInt64 Implements IConvertible.ToUInt64
If temp < UInt64.MinValue Or temp > UInt64.MaxValue Then
Throw New OverflowException(String.Format("{0} is out of range of the UInt64 data type.", temp))
End If
Return CULng(Math.Round(temp))
End Function
End Class
Public Class TemperatureCelsius : Inherits Temperature : Implements IConvertible
Public Sub New(value As Decimal)
MyBase.New(value)
End Sub
' Override ToString methods.
Public Overrides Function ToString() As String
Return Me.ToString(Nothing)
End Function
Public Overrides Function ToString(provider As IFormatProvider ) As String
Return temp.ToString(provider) + "°C"
End Function
' If conversionType is a implemented by another IConvertible method, call it.
Public Overrides Function ToType(conversionType As Type, provider As IFormatProvider) As Object
' For non-objects, call base method.
If Type.GetTypeCode(conversionType) <> TypeCode.Object Then
Return MyBase.ToType(conversionType, provider)
Else
If conversionType.Equals(GetType(TemperatureCelsius)) Then
Return Me
ElseIf conversionType.Equals(GetType(TemperatureFahrenheit))
Return New TemperatureFahrenheit(CDec(Me.temp * 9 / 5 + 32))
' Unspecified object type: throw an InvalidCastException.
Else
Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
conversionType.Name))
End If
End If
End Function
End Class
Public Class TemperatureFahrenheit : Inherits Temperature : Implements IConvertible
Public Sub New(value As Decimal)
MyBase.New(value)
End Sub
' Override ToString methods.
Public Overrides Function ToString() As String
Return Me.ToString(Nothing)
End Function
Public Overrides Function ToString(provider As IFormatProvider ) As String
Return temp.ToString(provider) + "°F"
End Function
Public Overrides Function ToType(conversionType As Type, provider As IFormatProvider) As Object
' For non-objects, call base methood.
If Type.GetTypeCode(conversionType) <> TypeCode.Object Then
Return MyBase.ToType(conversionType, provider)
Else
' Handle conversion between derived classes.
If conversionType.Equals(GetType(TemperatureFahrenheit)) Then
Return Me
ElseIf conversionType.Equals(GetType(TemperatureCelsius))
Return New TemperatureCelsius(CDec((MyBase.temp - 32) * 5 / 9))
' Unspecified object type: throw an InvalidCastException.
Else
Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
conversionType.Name))
End If
End If
End Function
End Class
using System;
public abstract class Temperature : IConvertible
{
protected decimal temp;
public Temperature(decimal temperature)
{
this.temp = temperature;
}
public decimal Value
{
get { return this.temp; }
set { this.temp = Value; }
}
public override string ToString()
{
return temp.ToString(null as IFormatProvider) + "º";
}
// IConvertible implementations.
public TypeCode GetTypeCode() {
return TypeCode.Object;
}
public bool ToBoolean(IFormatProvider provider) {
throw new InvalidCastException(String.Format("Temperature-to-Boolean conversion is not supported."));
}
public byte ToByte(IFormatProvider provider) {
if (temp < Byte.MinValue || temp > Byte.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the Byte data type.", temp));
else
return (byte) temp;
}
public char ToChar(IFormatProvider provider) {
throw new InvalidCastException("Temperature-to-Char conversion is not supported.");
}
public DateTime ToDateTime(IFormatProvider provider) {
throw new InvalidCastException("Temperature-to-DateTime conversion is not supported.");
}
public decimal ToDecimal(IFormatProvider provider) {
return temp;
}
public double ToDouble(IFormatProvider provider) {
return (double) temp;
}
public short ToInt16(IFormatProvider provider) {
if (temp < Int16.MinValue || temp > Int16.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the Int16 data type.", temp));
else
return (short) Math.Round(temp);
}
public int ToInt32(IFormatProvider provider) {
if (temp < Int32.MinValue || temp > Int32.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the Int32 data type.", temp));
else
return (int) Math.Round(temp);
}
public long ToInt64(IFormatProvider provider) {
if (temp < Int64.MinValue || temp > Int64.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the Int64 data type.", temp));
else
return (long) Math.Round(temp);
}
public sbyte ToSByte(IFormatProvider provider) {
if (temp < SByte.MinValue || temp > SByte.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the SByte data type.", temp));
else
return (sbyte) temp;
}
public float ToSingle(IFormatProvider provider) {
return (float) temp;
}
public virtual string ToString(IFormatProvider provider) {
return temp.ToString(provider) + "°";
}
// If conversionType is implemented by another IConvertible method, call it.
public virtual object ToType(Type conversionType, IFormatProvider provider) {
switch (Type.GetTypeCode(conversionType))
{
case TypeCode.Boolean:
return this.ToBoolean(provider);
case TypeCode.Byte:
return this.ToByte(provider);
case TypeCode.Char:
return this.ToChar(provider);
case TypeCode.DateTime:
return this.ToDateTime(provider);
case TypeCode.Decimal:
return this.ToDecimal(provider);
case TypeCode.Double:
return this.ToDouble(provider);
case TypeCode.Empty:
throw new NullReferenceException("The target type is null.");
case TypeCode.Int16:
return this.ToInt16(provider);
case TypeCode.Int32:
return this.ToInt32(provider);
case TypeCode.Int64:
return this.ToInt64(provider);
case TypeCode.Object:
// Leave conversion of non-base types to derived classes.
throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
conversionType.Name));
case TypeCode.SByte:
return this.ToSByte(provider);
case TypeCode.Single:
return this.ToSingle(provider);
case TypeCode.String:
IConvertible iconv = this;
return iconv.ToString(provider);
case TypeCode.UInt16:
return this.ToUInt16(provider);
case TypeCode.UInt32:
return this.ToUInt32(provider);
case TypeCode.UInt64:
return this.ToUInt64(provider);
default:
throw new InvalidCastException("Conversion not supported.");
}
}
public ushort ToUInt16(IFormatProvider provider) {
if (temp < UInt16.MinValue || temp > UInt16.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the UInt16 data type.", temp));
else
return (ushort) Math.Round(temp);
}
public uint ToUInt32(IFormatProvider provider) {
if (temp < UInt32.MinValue || temp > UInt32.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the UInt32 data type.", temp));
else
return (uint) Math.Round(temp);
}
public ulong ToUInt64(IFormatProvider provider) {
if (temp < UInt64.MinValue || temp > UInt64.MaxValue)
throw new OverflowException(String.Format("{0} is out of range of the UInt64 data type.", temp));
else
return (ulong) Math.Round(temp);
}
}
public class TemperatureCelsius : Temperature, IConvertible
{
public TemperatureCelsius(decimal value) : base(value)
{
}
// Override ToString methods.
public override string ToString()
{
return this.ToString(null);
}
public override string ToString(IFormatProvider provider)
{
return temp.ToString(provider) + "°C";
}
// If conversionType is a implemented by another IConvertible method, call it.
public override object ToType(Type conversionType, IFormatProvider provider) {
// For non-objects, call base method.
if (Type.GetTypeCode(conversionType) != TypeCode.Object) {
return base.ToType(conversionType, provider);
}
else
{
if (conversionType.Equals(typeof(TemperatureCelsius)))
return this;
else if (conversionType.Equals(typeof(TemperatureFahrenheit)))
return new TemperatureFahrenheit((decimal) this.temp * 9 / 5 + 32);
else
throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
conversionType.Name));
}
}
}
public class TemperatureFahrenheit : Temperature, IConvertible
{
public TemperatureFahrenheit(decimal value) : base(value)
{
}
// Override ToString methods.
public override string ToString()
{
return this.ToString(null);
}
public override string ToString(IFormatProvider provider)
{
return temp.ToString(provider) + "°F";
}
public override object ToType(Type conversionType, IFormatProvider provider)
{
// For non-objects, call base methood.
if (Type.GetTypeCode(conversionType) != TypeCode.Object) {
return base.ToType(conversionType, provider);
}
else
{
// Handle conversion between derived classes.
if (conversionType.Equals(typeof(TemperatureFahrenheit)))
return this;
else if (conversionType.Equals(typeof(TemperatureCelsius)))
return new TemperatureCelsius((decimal) (this.temp - 32) * 5 / 9);
// Unspecified object type: throw an InvalidCastException.
else
throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
conversionType.Name));
}
}
}
يوضح المثال التالي عدة استدعاءات لتطبيقات IConvertible لتحويل الكائنات TemperatureCelsius إلي الكائنات TemperatureFahrenheit وبالعكس.
Dim tempC1 As New TemperatureCelsius(0)
Dim tempF1 As TemperatureFahrenheit = CType(Convert.ChangeType(tempC1, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempC1, tempF1)
Dim tempC2 As TemperatureCelsius = CType(Convert.ChangeType(tempC1, GetType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempC1, tempC2)
Dim tempF2 As New TemperatureFahrenheit(212)
Dim tempC3 As TEmperatureCelsius = CType(Convert.ChangeType(tempF2, GEtType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempF2, tempC3)
Dim tempF3 As TemperatureFahrenheit = CType(Convert.ChangeType(tempF2, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempF2, tempF3)
' The example displays the following output:
' 0°C equals 32°F.
' 0°C equals 0°C.
' 212°F equals 100°C.
' 212°F equals 212°F.
TemperatureCelsius tempC1 = new TemperatureCelsius(0);
TemperatureFahrenheit tempF1 = (TemperatureFahrenheit) Convert.ChangeType(tempC1, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempF1);
TemperatureCelsius tempC2 = (TemperatureCelsius) Convert.ChangeType(tempC1, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempC2);
TemperatureFahrenheit tempF2 = new TemperatureFahrenheit(212);
TemperatureCelsius tempC3 = (TemperatureCelsius) Convert.ChangeType(tempF2, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempC3);
TemperatureFahrenheit tempF3 = (TemperatureFahrenheit) Convert.ChangeType(tempF2, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempF3);
// The example displays the following output:
// 0°C equals 32°F.
// 0°C equals 0°C.
// 212°F equals 100°C.
// 212°F equals 212°F.
العودة إلى الأعلى
الفئة TypeConverter
يسمح لك .NET Framework أيضاً بتعريف محول نوع لنوع مخصص بواسطة تمديد الفئة System.ComponentModel.TypeConverter ثم إقران نوع التحويل مع النوع من خلال السمة System.ComponentModel.TypeConverterAttribute. يكشف الجدول التالي عن الاختلافات بين هذه الطريقة وتنفيذ الواجهة IConvertible لنوع مخصص.
| ملاحظة |
|---|
يمكن توفير دعم وقت التصميم النوع مخصص فقط في حالة إذا كان لديه محول نوع معرف له. |
التحويل باستخدام TypeConverter |
التحويل باستخدام IConvertible |
|---|---|
يتم تطبيق لنوع مخصص بواسطة اشتقاق فئة منفصلة من TypeConverter. وتكون هذه الفئة المشتقة مقترنة بنوع مخصص عن طريق تطبيق السمة TypeConverterAttribute. |
و يتم تطبيقها بواسطة نوع مخصص لإجراء التحويل. يقوم مستخدم هذا النوع باستدعاء أسلوب التحويل IConvertible على النوع. |
يمكن استخدامه في كلا من وقت التصميم و وقت التشغيل. |
يمكن استخدامه فقط في وقت التشغيل. |
يستخدم الانعكاس; لذلك، فهو أبطأ من التحويل المُمكن بواسطة IConvertible. |
لا يستخدم الانعكاس. |
يسمح لتحويلات النوع ثنائية الاتجاه من النوع المخصص إلي أنواع بيانات أخري، ومن أنواع البيانات الأخري إلي نوع مخصص. على سبيل المثال، تسمح TypeConverter المعرّفة لـ MyType بالتحويلات من MyType إلي String، ومن String إلي MyType. |
يسمح بالتحويل من نوع مخصص إلى أنواع البيانات الأخرى، لكن لا يسمح بالتحويل من أنواع البيانات الأخرى إلى نوع مخصص. |
للحصول على مزيد من المعلومات حول استخدام محولات النوع لإجراء تحويلات، راجع System.ComponentModel.TypeConverter.
العودة إلى الأعلى