ValueType Třída

Definice

Poskytuje základní třídu pro typy hodnot.

C#
public abstract class ValueType
C#
[System.Serializable]
public abstract class ValueType
C#
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class ValueType
Dědičnost
ValueType
Odvozené
Atributy

Poznámky

ValueType přepíše virtuální metody z Object vhodnějšími implementacemi pro typy hodnot. Viz také Enum, který dědí z ValueType.

Datové typy jsou oddělené do hodnotových typů a odkazových typů. Typy hodnot se přidělují zásobníkem nebo přidělují vložené do struktury. Odkazové typy jsou přiděleny haldou. Referenční i hodnotové typy jsou odvozeny od konečné základní třídy Object. V případech, kdy je nutné, aby se typ hodnoty choval jako objekt, obálka, která typ hodnoty vypadá jako referenční objekt, je přidělen na haldě a hodnota typu hodnoty se do něj zkopíruje. Obálka je označena tak, aby systém věděl, že obsahuje typ hodnoty. Tento proces se označuje jako boxování a reverzní proces se označuje jako unboxing. Boxing and unboxing allow any type to be treated as an object.

I když ValueType je implicitní základní třída pro typy hodnot, nelze vytvořit třídu, která dědí z ValueType přímo. Místo toho jednotlivé kompilátory poskytují klíčové slovo jazyka nebo konstruktor (například struct v jazyce C# a Structure...End Structure v jazyce Visual Basic) pro podporu vytváření typů hodnot.

Kromě toho, že slouží jako základní třída pro typy hodnot v rozhraní .NET Framework, struktura ValueType se obecně nepoužívá přímo v kódu. Lze však použít jako parametr ve volání metody omezit možné argumenty na hodnotové typy místo všech objektů nebo povolit metodu zpracování řady různých typů hodnot. Následující příklad ukazuje, jak ValueType brání předání typům odkazů do metod. Definuje třídu s názvem Utility, která obsahuje čtyři metody: IsNumeric, který označuje, zda jeho argument je číslo; IsInteger, který označuje, zda jeho argument je celé číslo; IsFloat, který označuje, zda je jeho argument číslo s plovoucí desetinou čárkou; a Compare, který označuje vztah mezi dvěma číselnými hodnotami. V každém případě jsou parametry metody typu ValueTypea odkazové typy nejsou předány metodám.

C#
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);
   }
}

Následující příklad znázorňuje volání metod Utility třídy.

C#
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

Konstruktory

ValueType()

Inicializuje novou instanci ValueType třídy.

Metody

Equals(Object)

Určuje, zda tato instance a zadaný objekt jsou rovny.

GetHashCode()

Vrátí kód hash pro tuto instanci.

GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ToString()

Vrátí plně kvalifikovaný název typu této instance.

Platí pro

Produkt Verze
.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

Viz také