Export (0) Print
Expand All

FieldInfo Class

Discovers the attributes of a field and provides access to field metadata.

Namespace:  System.Reflection
Assemblies:   System.Reflection (in System.Reflection.dll)
  mscorlib (in mscorlib.dll)

public abstract class FieldInfo : MemberInfo

The FieldInfo type exposes the following members.

  NameDescription
Protected methodSupported by the XNA FrameworkFieldInfoInitializes a new instance of the FieldInfo class.
Top

  NameDescription
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsAttributesGets the attributes associated with this field.
Public propertySupported in .NET for Windows Store appsCustomAttributesGets a collection that contains this member's custom attributes. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsDeclaringTypeGets the class that declares this member. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryFieldHandleGets a RuntimeFieldHandle, which is a handle to the internal metadata representation of a field.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsFieldTypeGets the type of this field object.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsAssemblyGets a value indicating whether the potential visibility of this field is described by FieldAttributes.Assembly; that is, the field is visible at most to other types in the same assembly, and is not visible to derived types outside the assembly.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyGets a value indicating whether the visibility of this field is described by FieldAttributes.Family; that is, the field is visible only within its class and derived classes.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyAndAssemblyGets a value indicating whether the visibility of this field is described by FieldAttributes.FamANDAssem; that is, the field can be accessed from derived classes, but only if they are in the same assembly.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyOrAssemblyGets a value indicating whether the potential visibility of this field is described by FieldAttributes.FamORAssem; that is, the field can be accessed by derived classes wherever they are, and by classes in the same assembly.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsInitOnlyGets a value indicating whether the field can only be set in the body of the constructor.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsLiteralGets a value indicating whether the value is written at compile time and cannot be changed.
Public propertySupported by the XNA FrameworkIsNotSerializedGets a value indicating whether this field has the NotSerialized attribute.
Public propertySupported by the XNA FrameworkIsPinvokeImplGets a value indicating whether the corresponding PinvokeImpl attribute is set in FieldAttributes.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsPrivateGets a value indicating whether the field is private.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsPublicGets a value indicating whether the field is public.
Public propertyIsSecurityCriticalGets a value that indicates whether the current field is security-critical or security-safe-critical at the current trust level.
Public propertyIsSecuritySafeCriticalGets a value that indicates whether the current field is security-safe-critical at the current trust level.
Public propertyIsSecurityTransparentGets a value that indicates whether the current field is transparent at the current trust level.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsSpecialNameGets a value indicating whether the corresponding SpecialName attribute is set in the FieldAttributes enumerator.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsStaticGets a value indicating whether the field is static.
Public propertySupported by the XNA FrameworkMemberTypeGets a MemberTypes value indicating that this member is a field. (Overrides MemberInfo.MemberType.)
Public propertyMetadataTokenGets a value that identifies a metadata element. (Inherited from MemberInfo.)
Public propertySupported in .NET for Windows Store appsModuleGets the module in which the type that declares the member represented by the current MemberInfo is defined. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsNameGets the name of the current member. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryReflectedTypeGets the class object that was used to obtain this instance of MemberInfo. (Inherited from MemberInfo.)
Top

  NameDescription
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryEqualsReturns a value that indicates whether this instance is equal to a specified object. (Overrides MemberInfo.Equals(Object).)

In XNA Framework 3.0, this member is inherited from Object.Equals(Object).


In Portable Class Library Portable Class Library, this member is inherited from Object.Equals(Object).
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetCustomAttributes(Boolean)When overridden in a derived class, returns an array of all custom attributes applied to this member. (Inherited from MemberInfo.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetCustomAttributes(Type, Boolean)When overridden in a derived class, returns an array of custom attributes applied to this member and identified by Type. (Inherited from MemberInfo.)
Public methodGetCustomAttributesDataReturns a list of CustomAttributeData objects representing data about the attributes that have been applied to the target member. (Inherited from MemberInfo.)
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetFieldFromHandle(RuntimeFieldHandle)Gets a FieldInfo for the field represented by the specified handle.
Public methodStatic memberSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetFieldFromHandle(RuntimeFieldHandle, RuntimeTypeHandle)Gets a FieldInfo for the field represented by the specified handle, for the specified generic type.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetHashCodeReturns the hash code for this instance. (Overrides MemberInfo.GetHashCode().)

In XNA Framework 3.0, this member is inherited from Object.GetHashCode().


In Portable Class Library Portable Class Library, this member is inherited from Object.GetHashCode().
Public methodGetOptionalCustomModifiersGets an array of types that identify the optional custom modifiers of the field.
Public methodGetRawConstantValueReturns a literal value associated with the field by a compiler.
Public methodGetRequiredCustomModifiersGets an array of types that identify the required custom modifiers of the property.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetValueWhen overridden in a derived class, returns the value of a field supported by a given object.
Public methodGetValueDirectReturns the value of a field supported by a given object.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryIsDefinedWhen overridden in a derived class, indicates whether one or more attributes of the specified type or of its derived types is applied to this member. (Inherited from MemberInfo.)
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsSetValue(Object, Object)Sets the value of the field supported by the given object.
Public methodSupported by the XNA FrameworkSetValue(Object, Object, BindingFlags, Binder, CultureInfo)When overridden in a derived class, sets the value of the field supported by the given object.
Public methodSetValueDirectSets the value of the field supported by the given object.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public operatorStatic memberEqualityIndicates whether two FieldInfo objects are equal.
Public operatorStatic memberInequalityIndicates whether two FieldInfo objects are not equal.
Top

  NameDescription
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type, Boolean)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type, Boolean)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>()Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>()Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>(Boolean)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>(Boolean)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes()Overloaded. Retrieves a collection of custom attributes that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes()Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Boolean)Overloaded. Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Type)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Type)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Type, Boolean)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>()Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>()Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>(Boolean)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>(Boolean)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsIsDefined(Type)Overloaded. Indicates whether custom attributes of a specified type are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsIsDefined(Type)Overloaded. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsIsDefined(Type, Boolean)Overloaded. Indicates whether custom attributes of a specified type are applied to a specified member, and, optionally, applied to its ancestors. (Defined by CustomAttributeExtensions.)
Top

  NameDescription
Explicit interface implemetationPrivate method_FieldInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers.
Explicit interface implemetationPrivate method_FieldInfo.GetTypeGets a Type object representing the FieldInfo type.
Explicit interface implemetationPrivate method_FieldInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface.
Explicit interface implemetationPrivate method_FieldInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1).
Explicit interface implemetationPrivate method_FieldInfo.InvokeProvides access to properties and methods exposed by an object.
Explicit interface implemetationPrivate method_MemberInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeGets a Type object representing the MemberInfo class. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.InvokeProvides access to properties and methods exposed by an object. (Inherited from MemberInfo.)
Top

The field information is obtained from metadata. The FieldInfo class does not have a public constructor. FieldInfo objects are obtained by calling either the GetFields or GetField method of a Type object.

Fields are variables defined in the class. FieldInfo provides access to the metadata for a field within a class and provides dynamic set and get functionality for the field. The class is not loaded into memory until invoke or get is called on the object.

Notes to Inheritors

When you inherit from FieldInfo, you must override the following members: GetValue and SetValue.

The following example uses the Type.GetFields method to get the field-related information from the FieldInfo class, and then displays field attributes.

using System;
using System.Reflection;

public class FieldInfoClass
{
    public int myField1 = 0;
    protected string myField2 = null;
    public static void Main()
    {
        FieldInfo[] myFieldInfo;
        Type myType = typeof(FieldInfoClass);
        // Get the type and fields of FieldInfoClass.
        myFieldInfo = myType.GetFields(BindingFlags.NonPublic | BindingFlags.Instance
            | BindingFlags.Public);
        Console.WriteLine("\nThe fields of " + 
            "FieldInfoClass are \n");
        // Display the field information of FieldInfoClass. 
        for(int i = 0; i < myFieldInfo.Length; i++)
        {
            Console.WriteLine("\nName            : {0}", myFieldInfo[i].Name);
            Console.WriteLine("Declaring Type  : {0}", myFieldInfo[i].DeclaringType);
            Console.WriteLine("IsPublic        : {0}", myFieldInfo[i].IsPublic);
            Console.WriteLine("MemberType      : {0}", myFieldInfo[i].MemberType);
            Console.WriteLine("FieldType       : {0}", myFieldInfo[i].FieldType);
            Console.WriteLine("IsFamily        : {0}", myFieldInfo[i].IsFamily);
        }
    }
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

This type is thread safe.

Show:
© 2014 Microsoft