FieldBuilder クラス

定義

フィールドを定義および表現します。Defines and represents a field. このクラスは継承できません。This class cannot be inherited.

public ref class FieldBuilder sealed : System::Reflection::FieldInfo, System::Runtime::InteropServices::_FieldBuilder
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FieldBuilder : System.Reflection.FieldInfo, System.Runtime.InteropServices._FieldBuilder
type FieldBuilder = class
    inherit FieldInfo
    interface _FieldBuilder
Public NotInheritable Class FieldBuilder
Inherits FieldInfo
Implements _FieldBuilder
継承
FieldBuilder
属性
実装

次の例は、FieldBuilder クラスの使用方法を示しています。The following example illustrates the use of the FieldBuilder class.

using System;
using System.Reflection;
using System.Reflection.Emit;

public class FieldBuilder_Sample
{
   private static Type CreateType()
   {
      // Create an assembly.
      AssemblyName assemName = new AssemblyName();
      assemName.Name = "DynamicAssembly";
      AssemblyBuilder assemBuilder =
                     AssemblyBuilder.DefineDynamicAssembly(assemName, AssemblyBuilderAccess.Run);
      // Create a dynamic module in Dynamic Assembly.
      ModuleBuilder modBuilder = assemBuilder.DefineDynamicModule("DynamicModule");
      // Define a public class named "DynamicClass" in the assembly.
      TypeBuilder typBuilder = modBuilder.DefineType("DynamicClass", TypeAttributes.Public);

      // Define a private String field named "DynamicField" in the type.
      FieldBuilder fldBuilder = typBuilder.DefineField("DynamicField",
          typeof(string), FieldAttributes.Private | FieldAttributes.Static);
      // Create the constructor.
      Type[] constructorArgs = { typeof(String) };
      ConstructorBuilder constructor = typBuilder.DefineConstructor(
         MethodAttributes.Public, CallingConventions.Standard, constructorArgs);
      ILGenerator constructorIL = constructor.GetILGenerator();
      constructorIL.Emit(OpCodes.Ldarg_0);
      ConstructorInfo superConstructor = typeof(Object).GetConstructor(new Type[0]);
      constructorIL.Emit(OpCodes.Call, superConstructor);
      constructorIL.Emit(OpCodes.Ldarg_0);
      constructorIL.Emit(OpCodes.Ldarg_1);
      constructorIL.Emit(OpCodes.Stfld, fldBuilder);
      constructorIL.Emit(OpCodes.Ret);

      // Create the DynamicMethod method.
      MethodBuilder methBuilder= typBuilder.DefineMethod("DynamicMethod",
                           MethodAttributes.Public,typeof(String),null);
      ILGenerator methodIL = methBuilder.GetILGenerator();
      methodIL.Emit(OpCodes.Ldarg_0);
      methodIL.Emit(OpCodes.Ldfld, fldBuilder);
      methodIL.Emit(OpCodes.Ret);

      Console.WriteLine($"Name               : {fldBuilder.Name}");
      Console.WriteLine($"DeclaringType      : {fldBuilder.DeclaringType}");
      Console.WriteLine($"Type               : {fldBuilder.FieldType}");
      return typBuilder.CreateType();
   }

   public static void Main()
   {
      Type dynType = CreateType();
      try
      {
         // Create an instance of the "HelloWorld" class.
         Object helloWorld = Activator.CreateInstance(dynType, new Object[] { "HelloWorld" });
         // Invoke the "DynamicMethod" method of the "DynamicClass" class.
         Object obj  = dynType.InvokeMember("DynamicMethod",
                        BindingFlags.InvokeMethod, null, helloWorld, null);
         Console.WriteLine($"DynamicClass.DynamicMethod returned: \"{obj}\"");
      }
      catch(MethodAccessException e)
      {
         Console.WriteLine($"{e.GetType().Name}: {e.Message}");
      }
  }
}
Imports System.Reflection
Imports System.Reflection.Emit

Public Module FieldBuilder_Sample
   Private Function CreateType() As Type
      ' Create an assembly.
      Dim assemName As New AssemblyName()
      assemName.Name = "DynamicAssembly"
      Dim assemBuilder As AssemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(assemName,
                                                AssemblyBuilderAccess.Run)
      ' Create a dynamic module in Dynamic Assembly.
      Dim modBuilder As ModuleBuilder = assemBuilder.DefineDynamicModule("DynamicModule")
      ' Define a public class named "DynamicClass" in the assembly.
      Dim typBuilder As TypeBuilder = modBuilder.DefineType("DynamicClass", 
                                          TypeAttributes.Public)
      ' Define a private String field named "DynamicField" in the type.
      Dim fldBuilder As FieldBuilder = typBuilder.DefineField("DynamicField",
                  GetType(String), FieldAttributes.Private Or FieldAttributes.Static)
      ' Create the constructor.
      Dim constructorArgs As Type() = {GetType(String)}
      Dim constructor As ConstructorBuilder = 
                  typBuilder.DefineConstructor(MethodAttributes.Public, 
                           CallingConventions.Standard, constructorArgs)
      Dim constructorIL As ILGenerator = constructor.GetILGenerator()
      constructorIL.Emit(OpCodes.Ldarg_0)
      Dim superConstructor As ConstructorInfo = GetType(Object).GetConstructor(New Type() {})
      constructorIL.Emit(OpCodes.Call, superConstructor)
      constructorIL.Emit(OpCodes.Ldarg_0)
      constructorIL.Emit(OpCodes.Ldarg_1)
      constructorIL.Emit(OpCodes.Stfld, fldBuilder)
      constructorIL.Emit(OpCodes.Ret)

      ' Create the DynamicMethod method.
      Dim methBuilder As MethodBuilder = typBuilder.DefineMethod("DynamicMethod", 
                        MethodAttributes.Public, GetType(String), Nothing)
      Dim methodIL As ILGenerator = methBuilder.GetILGenerator()
      methodIL.Emit(OpCodes.Ldarg_0)
      methodIL.Emit(OpCodes.Ldfld, fldBuilder)
      methodIL.Emit(OpCodes.Ret)

      Console.WriteLine($"Name               : {fldBuilder.Name}")
      Console.WriteLine($"DeclaringType      : {fldBuilder.DeclaringType}")
      Console.WriteLine($"Type               : {fldBuilder.FieldType}")
      Return typBuilder.CreateType()
   End Function 

   Public Sub Main()
      Dim dynType As Type = CreateType()
      Try  
        ' Create an instance of the "HelloWorld" class.
         Dim helloWorld As Object = Activator.CreateInstance(dynType, New Object() {"HelloWorld"})
         ' Invoke the "DynamicMethod" method of the "DynamicClass" class.
         Dim obj As Object = dynType.InvokeMember("DynamicMethod", 
                  BindingFlags.InvokeMethod, Nothing, helloWorld, Nothing)
         Console.WriteLine($"DynamicClass.DynamicMethod returned: ""{obj}""")
      Catch e As MethodAccessException
            Console.WriteLine($"{e.GetType().Name}: {e.Message}")
      End Try
   End Sub 
End Module

注釈

DefineFieldDefineInitializedData、または DefineUninitializedDataを呼び出して、FieldBuilder のインスタンスを取得します。Get an instance of FieldBuilder by calling DefineField, DefineInitializedData, or DefineUninitializedData.

注意

SetValue メソッドは現在サポートされていません。The SetValue method is currently not supported. 回避策として、完成した型を反映して FieldInfo を取得し、SetValue を呼び出してフィールドの値を設定します。As a workaround, retrieve the FieldInfo by reflecting on the finished type and call SetValue to set the value of the field.

プロパティ

Attributes

このフィールドの属性を示します。Indicates the attributes of this field. このプロパティは読み取り専用です。This property is read-only.

CustomAttributes

このメンバーのカスタム属性を含むコレクションを取得します。Gets a collection that contains this member's custom attributes.

(継承元 MemberInfo)
DeclaringType

このフィールドを宣言する型の Type オブジェクトへの参照を示します。Indicates a reference to the Type object for the type that declares this field. このプロパティは読み取り専用です。This property is read-only.

FieldHandle

このフィールドの内部メタデータ ハンドルを示します。Indicates the internal metadata handle for this field. このプロパティは読み取り専用です。This property is read-only.

FieldType

このフィールドの型を表す Type オブジェクトを示します。Indicates the Type object that represents the type of this field. このプロパティは読み取り専用です。This property is read-only.

IsAssembly

このフィールドを参照可能な範囲が Assembly によって示されるかどうかを表す値を取得します。ここで判定されるのは、フィールドは同じアセンブリ内の他の型でのみ参照できる可能性があり、アセンブリ外部の派生型では参照できないということです。Gets a value indicating whether the potential visibility of this field is described by 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.

(継承元 FieldInfo)
IsCollectible

この MemberInfo オブジェクトが、収集可能な AssemblyLoadContext に保持されているアセンブリの一部であるかどうかを示す値を取得します。Gets a value that indicates whether this MemberInfo object is part of an assembly held in a collectible AssemblyLoadContext.

(継承元 MemberInfo)
IsFamily

このフィールドへの参照範囲が Family によって示されるかどうかを表す値を取得します。ここで判定されるのは、フィールドはそのフィールドのクラスと派生クラスの内側でのみ参照できるということです。Gets a value indicating whether the visibility of this field is described by Family; that is, the field is visible only within its class and derived classes.

(継承元 FieldInfo)
IsFamilyAndAssembly

フィールドへの参照範囲が FamANDAssem によって示されるかどうかを表す値を取得します。ここで判定されるのは、フィールドは派生クラスからアクセスできるが、それらのフィールドが同じアセンブリ内にある場合に限るものであることです。Gets a value indicating whether the visibility of this field is described by FamANDAssem; that is, the field can be accessed from derived classes, but only if they are in the same assembly.

(継承元 FieldInfo)
IsFamilyOrAssembly

このフィールドへの参照範囲が FamORAssem によって示されるかどうかを表す値を取得します。ここで判定されるのは、フィールドは任意の場所にある派生クラスと、同じアセンブリ内のクラスでアクセスできることです。Gets a value indicating whether the potential visibility of this field is described by FamORAssem; that is, the field can be accessed by derived classes wherever they are, and by classes in the same assembly.

(継承元 FieldInfo)
IsInitOnly

フィールドをコンストラクターの本体だけでしか設定できないのかどうかを示す値を取得します。Gets a value indicating whether the field can only be set in the body of the constructor.

(継承元 FieldInfo)
IsLiteral

値がコンパイル時に書き込まれ、変更できないかどうかを示す値を取得します。Gets a value indicating whether the value is written at compile time and cannot be changed.

(継承元 FieldInfo)
IsNotSerialized

このフィールドに、NotSerialized 属性が設定されているかどうかを示す値を取得します。Gets a value indicating whether this field has the NotSerialized attribute.

(継承元 FieldInfo)
IsPinvokeImpl

対応する PinvokeImpl 属性が FieldAttributes に設定されているかどうかを示す値を取得します。Gets a value indicating whether the corresponding PinvokeImpl attribute is set in FieldAttributes.

(継承元 FieldInfo)
IsPrivate

フィールドがプライベートかどうかを示す値を取得します。Gets a value indicating whether the field is private.

(継承元 FieldInfo)
IsPublic

フィールドがパブリックかどうかを示す値を取得します。Gets a value indicating whether the field is public.

(継承元 FieldInfo)
IsSecurityCritical

現在のフィールドが、現在の信頼レベルでセキュリティ クリティカルまたはセキュリティ セーフ クリティカルであるかどうかを示す値を取得します。Gets a value that indicates whether the current field is security-critical or security-safe-critical at the current trust level.

(継承元 FieldInfo)
IsSecuritySafeCritical

現在のフィールドが、現在の信頼レベルでセキュリティ セーフ クリティカルであるかどうかを示す値を取得します。Gets a value that indicates whether the current field is security-safe-critical at the current trust level.

(継承元 FieldInfo)
IsSecurityTransparent

現在のフィールドが、現在の信頼レベルで透過的であるかどうかを示す値を取得します。Gets a value that indicates whether the current field is transparent at the current trust level.

(継承元 FieldInfo)
IsSpecialName

対応する SpecialName 属性が FieldAttributes 列挙子に設定されているかどうかを示す値を取得します。Gets a value indicating whether the corresponding SpecialName attribute is set in the FieldAttributes enumerator.

(継承元 FieldInfo)
IsStatic

フィールドが静的かどうかを示す値を取得します。Gets a value indicating whether the field is static.

(継承元 FieldInfo)
MemberType

このメンバーがフィールドであることを示す MemberTypes 値を取得します。Gets a MemberTypes value indicating that this member is a field.

(継承元 FieldInfo)
MetadataToken

メタデータ要素を識別する値を取得します。Gets a value that identifies a metadata element.

(継承元 MemberInfo)
Module

このフィールドを含む型が定義されるモジュールを取得します。Gets the module in which the type that contains this field is being defined.

Name

このフィールドの名前を示します。Indicates the name of this field. このプロパティは読み取り専用です。This property is read-only.

ReflectedType

このオブジェクトの取得元である Type オブジェクトへの参照を示します。Indicates the reference to the Type object from which this object was obtained. このプロパティは読み取り専用です。This property is read-only.

メソッド

Equals(Object)

このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to a specified object.

(継承元 FieldInfo)
GetCustomAttributes(Boolean)

このフィールドに対して定義されているすべてのカスタム属性を返します。Returns all the custom attributes defined for this field.

GetCustomAttributes(Type, Boolean)

指定された型によって識別されるこのフィールドに定義されたすべてのカスタム属性を返します。Returns all the custom attributes defined for this field identified by the given type.

GetCustomAttributesData()

ターゲット メンバーに適用されている属性に関するデータを表す CustomAttributeData オブジェクトのリストを返します。Returns a list of CustomAttributeData objects representing data about the attributes that have been applied to the target member.

(継承元 MemberInfo)
GetHashCode()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

(継承元 FieldInfo)
GetOptionalCustomModifiers()

フィールドの省略可能なカスタム修飾子を識別する型の配列を取得します。Gets an array of types that identify the optional custom modifiers of the field.

(継承元 FieldInfo)
GetRawConstantValue()

コンパイラによってフィールドに関連付けられているリテラル値を返します。Returns a literal value associated with the field by a compiler.

(継承元 FieldInfo)
GetRequiredCustomModifiers()

プロパティの必須のカスタム修飾子を識別する型の配列を取得します。Gets an array of types that identify the required custom modifiers of the property.

(継承元 FieldInfo)
GetToken()

このフィールドを表すトークンを返します。Returns the token representing this field.

GetType() (継承元 FieldInfo)
GetValue(Object)

指定したオブジェクトでサポートされているフィールドの値を取得します。Retrieves the value of the field supported by the given object.

GetValueDirect(TypedReference)

指定したオブジェクトでサポートされているフィールドの値を返します。Returns the value of a field supported by a given object.

(継承元 FieldInfo)
HasSameMetadataDefinitionAs(MemberInfo) (継承元 MemberInfo)
IsDefined(Type, Boolean)

指定した型の属性がフィールドで定義されているかどうかを示します。Indicates whether an attribute having the specified type is defined on a field.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
SetConstant(Object)

このフィールドの既定値を設定します。Sets the default value of this field.

SetCustomAttribute(ConstructorInfo, Byte[])

指定されたカスタム属性の blob を使用して、カスタム属性を設定します。Sets a custom attribute using a specified custom attribute blob.

SetCustomAttribute(CustomAttributeBuilder)

カスタム属性ビルダーを使用して、カスタム属性を設定します。Sets a custom attribute using a custom attribute builder.

SetMarshal(UnmanagedMarshal)

フィールドのネイティブ マーシャリングを記述します。Describes the native marshaling of the field.

SetOffset(Int32)

フィールド レイアウトを指定します。Specifies the field layout.

SetValue(Object, Object)

指定したオブジェクトでサポートされているフィールドの値を設定します。Sets the value of the field supported by the given object.

(継承元 FieldInfo)
SetValue(Object, Object, BindingFlags, Binder, CultureInfo)

指定したオブジェクトでサポートされているフィールドの値を設定します。Sets the value of the field supported by the given object.

SetValueDirect(TypedReference, Object)

指定したオブジェクトでサポートされているフィールドの値を設定します。Sets the value of the field supported by the given object.

(継承元 FieldInfo)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

明示的なインターフェイスの実装

_FieldBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

_FieldBuilder.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この型情報を使用して、インターフェイスの型情報を取得できます。Retrieves the type information for an object, which can then be used to get the type information for an interface.

_FieldBuilder.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

_FieldBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

_FieldInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(継承元 FieldInfo)
_FieldInfo.GetType()

Type 型を表す FieldInfo オブジェクトを取得します。Gets a Type object representing the FieldInfo type.

(継承元 FieldInfo)
_FieldInfo.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この型情報を使用して、インターフェイスの型情報を取得できます。Retrieves the type information for an object, which can then be used to get the type information for an interface.

(継承元 FieldInfo)
_FieldInfo.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(継承元 FieldInfo)
_FieldInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(継承元 FieldInfo)
_MemberInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(継承元 MemberInfo)
_MemberInfo.GetType()

Type クラスを表す MemberInfo オブジェクトを取得します。Gets a Type object representing the MemberInfo class.

(継承元 MemberInfo)
_MemberInfo.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この型情報を使用して、インターフェイスの型情報を取得できます。Retrieves the type information for an object, which can then be used to get the type information for an interface.

(継承元 MemberInfo)
_MemberInfo.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(継承元 MemberInfo)
_MemberInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(継承元 MemberInfo)
ICustomAttributeProvider.GetCustomAttributes(Boolean) (継承元 MemberInfo)
ICustomAttributeProvider.GetCustomAttributes(Type, Boolean) (継承元 MemberInfo)
ICustomAttributeProvider.IsDefined(Type, Boolean) (継承元 MemberInfo)

拡張メソッド

GetCustomAttribute(MemberInfo, Type)

指定したメンバーに適用される指定した型のカスタム属性を取得します。Retrieves a custom attribute of a specified type that is applied to a specified member.

GetCustomAttribute(MemberInfo, Type, Boolean)

指定したメンバーに適用される指定した型のカスタム属性を取得し、オプションでそのメンバーの先祖を調べます。Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member.

GetCustomAttribute<T>(MemberInfo)

指定したメンバーに適用される指定した型のカスタム属性を取得します。Retrieves a custom attribute of a specified type that is applied to a specified member.

GetCustomAttribute<T>(MemberInfo, Boolean)

指定したメンバーに適用される指定した型のカスタム属性を取得し、オプションでそのメンバーの先祖を調べます。Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member.

GetCustomAttributes(MemberInfo)

指定されたメンバーに適用されるカスタム属性のコレクションを取得します。Retrieves a collection of custom attributes that are applied to a specified member.

GetCustomAttributes(MemberInfo, Boolean)

指定されたメンバーに適用されるカスタム属性のコレクションを取得し、オプションでそのメンバーの先祖を調べます。Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member.

GetCustomAttributes(MemberInfo, Type)

指定されたメンバーに適用される指定された型のカスタム属性のコレクションを取得します。Retrieves a collection of custom attributes of a specified type that are applied to a specified member.

GetCustomAttributes(MemberInfo, Type, Boolean)

指定されたメンバーに適用されている指定された型のカスタム属性のコレクションを取得し、オプションでそのメンバーの先祖を調べます。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.

GetCustomAttributes<T>(MemberInfo)

指定されたメンバーに適用される指定された型のカスタム属性のコレクションを取得します。Retrieves a collection of custom attributes of a specified type that are applied to a specified member.

GetCustomAttributes<T>(MemberInfo, Boolean)

指定されたメンバーに適用されている指定された型のカスタム属性のコレクションを取得し、オプションでそのメンバーの先祖を調べます。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.

IsDefined(MemberInfo, Type)

指定された型のカスタム属性が指定されたメンバーに適用されているかどうかを示します。Indicates whether custom attributes of a specified type are applied to a specified member.

IsDefined(MemberInfo, Type, Boolean)

指定された型のカスタム属性が指定されたメンバーに適用され、オプションで先祖に適用されているかどうかを示します。Indicates whether custom attributes of a specified type are applied to a specified member, and, optionally, applied to its ancestors.

GetMetadataToken(MemberInfo)

指定されたメンバーのメタデータ トークンを取得します (存在する場合)。Gets a metadata token for the given member, if available.

HasMetadataToken(MemberInfo)

指定されたメンバーに対してメタデータ トークンを使用できるかどうかを示す値を返します。Returns a value that indicates whether a metadata token is available for the specified member.

適用対象