ValueType Класс

Определение

Предоставляет базовый класс для типов значений.

public abstract class ValueType
[System.Serializable]
public abstract class ValueType
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class ValueType
Наследование
ValueType
Производный
Атрибуты

Комментарии

ValueType переопределяет виртуальные методы из Object с более подходящими реализациями для типов значений. См. также Enum, который наследует от ValueType.

Типы данных разделены на типы значений и ссылочные типы. Типы значений — выделенные стеком или выделенные встроенные в структуре. Ссылочные типы выделяются кучей. Ссылки и типы значений являются производными от конечного базового класса Object. В случаях, когда для типа значения необходимо вести себя как объект, оболочка, которая делает тип значения похожим на эталонный объект выделяется в куче, а значение типа значения копируется в него. Оболочка помечена так, что система знает, что она содержит тип значения. Этот процесс называется боксом, а обратный процесс называется распаковки. Бокс и распаковка позволяют рассматривать любой тип как объект.

Хотя ValueType является неявным базовым классом для типов значений, нельзя создать класс, наследующий от ValueType напрямую. Вместо этого отдельные компиляторы предоставляют ключевое слово или конструкцию языка (например, struct в C# и Structure...End Structure в Visual Basic) для поддержки создания типов значений.

Помимо использования базового класса для типов значений в .NET Framework, структура ValueType обычно не используется непосредственно в коде. Однако его можно использовать в качестве параметра в вызовах методов, чтобы ограничить возможные аргументы типами значений вместо всех объектов или разрешить методу обрабатывать ряд различных типов значений. В следующем примере показано, как ValueType предотвращает передаче ссылочных типов в методы. Он определяет класс с именем Utility, который содержит четыре метода: IsNumeric, который указывает, является ли его аргумент числом; IsInteger, указывающее, является ли его аргумент целым числом; IsFloat, указывающее, является ли его аргумент числом с плавающей запятой; и Compare, указывающие связь между двумя числовыми значениями. В каждом случае параметры метода имеют тип ValueType, а ссылочные типы не передаются в методы.

using System;
using System.Numerics;

public class Utility
{
   public enum NumericRelationship {
      GreaterThan = 1, 
      EqualTo = 0,
      LessThan = -1
   };
   
   public static NumericRelationship Compare(ValueType value1, ValueType value2)
   {
      if (! IsNumeric(value1)) 
         throw new ArgumentException("value1 is not a number.");
      else if (! IsNumeric(value2))
         throw new ArgumentException("value2 is not a number.");

      // Use BigInteger as common integral type
      if (IsInteger(value1) && IsInteger(value2)) {
         BigInteger bigint1 = (BigInteger) value1;
         BigInteger bigint2 = (BigInteger) value2;
         return (NumericRelationship) BigInteger.Compare(bigint1, bigint2);
      }
      // At least one value is floating point; use Double.
      else {
         Double dbl1 = 0;
         Double dbl2 = 0;
         try {
            dbl1 = Convert.ToDouble(value1);
         }
         catch (OverflowException) {
            Console.WriteLine("value1 is outside the range of a Double.");
         }
         try {
            dbl2 = Convert.ToDouble(value2);
         }
         catch (OverflowException) {
            Console.WriteLine("value2 is outside the range of a Double.");
         }
         return (NumericRelationship) dbl1.CompareTo(dbl2);
      }
   }
   
   public static bool IsInteger(ValueType value)
   {         
      return (value is SByte || value is Int16 || value is Int32 
              || value is Int64 || value is Byte || value is UInt16  
              || value is UInt32 || value is UInt64 
              || value is BigInteger); 
   }

   public static bool IsFloat(ValueType value) 
   {         
      return (value is float || value is double || value is Decimal);
   }

   public static bool IsNumeric(ValueType value)
   {
      return (value is Byte ||
              value is Int16 ||
              value is Int32 ||
              value is Int64 ||
              value is SByte ||
              value is UInt16 ||
              value is UInt32 ||
              value is UInt64 ||
              value is BigInteger ||
              value is Decimal ||
              value is Double ||
              value is Single);
   }
}

В следующем примере показаны вызовы методов класса Utility.

public class Example
{
   public static void Main()
   {
      Console.WriteLine(Utility.IsNumeric(12));
      Console.WriteLine(Utility.IsNumeric(true));
      Console.WriteLine(Utility.IsNumeric('c'));
      Console.WriteLine(Utility.IsNumeric(new DateTime(2012, 1, 1)));
      Console.WriteLine(Utility.IsInteger(12.2));
      Console.WriteLine(Utility.IsInteger(123456789));
      Console.WriteLine(Utility.IsFloat(true));
      Console.WriteLine(Utility.IsFloat(12.2));
      Console.WriteLine(Utility.IsFloat(12));
      Console.WriteLine("{0} {1} {2}", 12.1, Utility.Compare(12.1, 12), 12);
   }
}
// The example displays the following output:
//       True
//       False
//       False
//       False
//       False
//       True
//       False
//       True
//       False
//       12.1 GreaterThan 12

Конструкторы

ValueType()

Инициализирует новый экземпляр класса ValueType.

Методы

Equals(Object)

Указывает, равны ли этот экземпляр и указанный объект.

GetHashCode()

Возвращает хэш-код для этого экземпляра.

GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ToString()

Возвращает полное имя типа этого экземпляра.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел