Value Types
Collapse the table of content
Expand the table of content
This documentation is archived and is not being maintained.

Value Types (C# Reference)

The value types consist of two main categories:

Structs fall into these categories:

Variable that are based on value types directly contain a values. Assigning one value type variable to another copies the contained value. This differs from the assignment of reference type variables, which copies a reference to the object but not the object itself.

All value types are derived implicitly from the System.ValueType.

Unlike reference types, it is not possible to derive a new type from a value type. However, like reference types, structs can implement interfaces.

Unlike reference types, it is not possible for a value type to contain the null value. However, the nullable types feature does allow values types to be assigned to null.

Each value type has an implicit default constructor that initializes the default value of that type. For information on default values of value types, see Default Values Table.

All of the simple types -- those integral to the C# language -- are aliases of the .NET Framework System types. For example, int is an alias of System.Int32. For a complete list of aliases, see Built-In Types Table (C# Reference).

Constant expressions, whose operands are all simple type constants, are evaluated at compilation time.

Simple types can be initialized using literals. For example, 'A' is a literal of the type char and 2001 is a literal of the type int.

Local variables in C# must be initialized before being used. Therefore, if you declare a local variable without initialization like this:

int myInt;

you cannot use it before you initialize it. You can initialize it using the following statement:

myInt = new int();  // Invoke default constructor for int type.

which is equivalent to:

myInt = 0;         // Assign an initial value, 0 in this example.

You can, of course, have the declaration and the initialization in the same statement like this:

int myInt = new int();


int myInt = 0;

Using the new operator calls the default constructor of the specific type and assigns the default value to the variable. In the preceding example, the default constructor assigned the value 0 to myInt. For more information on values assigned by calling default constructors, see Default Values Table.

With user-defined types, use new to invoke the default constructor. For example, the following statement invokes the default constructor of the Point struct:

Point p = new Point(); // Invoke default constructor for the struct.

After this call, the struct is considered to be definitely assigned; that is, all of its members are initialized to their default values.

For more information on the new operator, see new.

For information on formatting the output of numeric types, see Formatting Numeric Results Table.

© 2016 Microsoft