Export (0) Print
Expand All

FieldInfo Class

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

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

'Declaration
<SerializableAttribute> _
<ClassInterfaceAttribute(ClassInterfaceType.None)> _
<ComVisibleAttribute(True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public MustInherit Class FieldInfo _
	Inherits MemberInfo _
	Implements _FieldInfo

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 FrameworkAttributesGets the attributes associated with this field.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryDeclaringTypeGets 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 LibraryFieldTypeGets the type of this field object.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryIsAssemblyGets 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 LibraryIsFamilyGets 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 LibraryIsFamilyAndAssemblyGets 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 LibraryIsFamilyOrAssemblyGets 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 LibraryIsInitOnlyGets 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 LibraryIsLiteralGets 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 LibraryIsPrivateGets a value indicating whether the field is private.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryIsPublicGets 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 LibraryIsSpecialNameGets a value indicating whether the corresponding SpecialName attribute is set in the FieldAttributes enumerator.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryIsStaticGets a value indicating whether the field is static.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryMemberTypeGets 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 by Portable Class LibraryModuleGets 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 LibraryNameGets 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 LibraryFinalizeAllows 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 LibraryGetFieldFromHandle(RuntimeFieldHandle)Gets a FieldInfo for the field represented by the specified handle.
Public methodStatic memberGetFieldFromHandle(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 LibraryGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetValueWhen 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 LibraryMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySetValue(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 LibraryToStringReturns 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
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.


Imports System
Imports System.Reflection
Imports Microsoft.VisualBasic

Public Class FieldInfoClass
    Public myField1 As Integer = 0
    Protected myField2 As String = Nothing

    Public Shared Sub Main()
        Dim myFieldInfo() As FieldInfo
        Dim myType As Type = GetType(FieldInfoClass)
        ' Get the type and fields of FieldInfoClass.
        myFieldInfo = myType.GetFields(BindingFlags.NonPublic Or _
                      BindingFlags.Instance Or BindingFlags.Public)
        Console.WriteLine(ControlChars.NewLine & "The fields of " & _
                      "FieldInfoClass class are " & ControlChars.NewLine)
        ' Display the field information of FieldInfoClass.
        Dim i As Integer
        For i = 0 To myFieldInfo.Length - 1
            Console.WriteLine(ControlChars.NewLine + "Name            : {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)
        Next i
    End Sub
End Class


.NET Framework

Supported in: 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

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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.

Community Additions

ADD
Show:
© 2014 Microsoft