Type Members
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
The runtime allows you to define members of your type: events, fields, nested types, methods, and properties. Each member has a signature. The following table describes the type members used in the .NET Framework.
Member |
Description |
|---|---|
Defines an incident that can be responded to, and defines methods for subscribing to, unsubscribing from, and raising the event. Events are often used to inform other types of state changes. |
|
Field |
Describes and contains part of the type's state. Fields can be of any type supported by the runtime. |
Defines a type within the scope of the enclosing type. |
|
Method |
Describes operations available on the type. A method's signature specifies the allowable types of all its arguments and of its return value. A constructor is a special kind of method that creates new instances of a type. |
Names a value or state of the type and defines methods for getting or setting the property's value. Properties can be primitive types, collections of primitive types, user-defined types, or collections of user-defined types. Properties are often used to keep the public interface of a type independent from the type's actual representation. |
Member Characteristics
The common type system allows type members to have a variety of characteristics, but languages are not required to support all these characteristics. The following table describes these member characteristics.
Characteristic |
Can apply to |
Description |
|---|---|---|
abstract |
Methods, properties, and events |
The type does not supply the method's implementation. Types that inherit abstract methods and types that implement interfaces with abstract methods must supply an implementation for the method. The only exception is when the derived type is itself an abstract type. All abstract methods are virtual. |
private, family, assembly, family and assembly, family or assembly, or public |
All |
Defines the accessibility of the member:
|
final |
Methods, properties, and events |
The virtual method cannot be overridden in a derived type. |
initialize-only |
Fields |
The value can only be initialized, and cannot be written after initialization. |
instance |
Fields, methods, properties, and events |
If a member is not marked as static (C# and C++), Shared (Visual Basic), virtual (C# and C++), or Overridable (Visual Basic), it is an instance member (there is no instance keyword). There will be as many copies of such members in memory as there are objects that use it. |
literal |
Fields |
The value assigned to the field is a fixed value, known at compile time, of a built-in value type. Literal fields are sometimes referred to as constants. |
newslot or override |
All |
Defines how the member interacts with inherited members with the same signature:
The default is newslot. |
static |
Fields, methods, properties, and events |
The member belongs to the type it is defined on, not to a particular instance of the type; the member exists even if an instance of the type is not created, and it is shared among all instances of the type. |
virtual |
Methods, properties, and events |
The method can be implemented by a derived type and can be invoked either statically or dynamically. If dynamic invocation is used, the type of the instance that makes the call at run time determines which implementation of the method is called, rather than the type known at compile time. To invoke a virtual method statically, the variable might need to be cast to a type that uses the desired version of the method. |
Overloading
Each type member has a unique signature. Method signatures consist of the method name and a parameter list (the order and types of the method's arguments). More than one method with the same name can be defined within a type as long as the signatures differ. When two or more methods with the same name are defined, the method is said to be overloaded. For example, in System.Char, IsDigit is overloaded. One method takes a Char and returns a Boolean. The other method takes a String and an Int32, and returns a Boolean. Parameter lists can also be qualified by the varargs constraint, which indicates that the method supports a variable argument list.
Inheriting, Overriding, and Hiding Members
A derived type inherits all members of its base type; that is, these members are defined on and available to the derived type. The behavior or qualities of inherited members can be modified in two ways:
A derived type can hide an inherited member by defining a new member with the same signature. This might be done to make a previously public member private or to define new behavior for an inherited method that is marked as final.
A derived type can override an inherited virtual method. The overriding method provides a new definition of the method that will be invoked based on the type of the value at run time rather than the type of the variable known at compile time. A method can override a virtual method only if the virtual method is not marked as final and the new method is at least as accessible as the virtual method.