FieldBuilder Classe

Definição

Namespace:

System.Reflection.Emit

Assembly:

System.Reflection.Emit.dll

Source:

FieldBuilder.cs

Define e representa um campo. Essa classe não pode ser herdada.

public ref class FieldBuilder abstract : System::Reflection::FieldInfo

public abstract class FieldBuilder : System.Reflection.FieldInfo

type FieldBuilder = class
    inherit FieldInfo

Public MustInherit Class FieldBuilder
Inherits FieldInfo

Herança

Object

MemberInfo

FieldInfo

FieldBuilder

Exemplos

O exemplo a seguir ilustra o uso da FieldBuilder classe .

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
        {
            if (dynType is not null)
            {
                // 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

Comentários

Obtenha uma instância de FieldBuilder chamando DefineField, DefineInitializedDataou DefineUninitializedData.

Observação

No SetValue momento, não há suporte para o método . Como solução alternativa, recupere o FieldInfo refletindo sobre o tipo concluído e chame SetValue para definir o valor do campo.

Construtores

FieldBuilder()

Inicializa uma nova instância da classe FieldBuilder.

Propriedades

Attributes	Indica os atributos desse campo. Esta propriedade é somente para leitura.
CustomAttributes	Obtém uma coleção que contém os atributos personalizados desse membro. (Herdado de MemberInfo)
DeclaringType	Indica uma referência para o objeto Type para o tipo que declara esse membro. Esta propriedade é somente para leitura.
FieldHandle	Indica o identificador de metadados internos para esse campo. Esta propriedade é somente para leitura.
FieldType	Indica o objeto Type que representa o tipo desse campo. Esta propriedade é somente para leitura.
IsAssembly	Obtém um valor que indica se a visibilidade potencial deste campo é ou não descrita por Assembly, ou seja, que o campo está visível no máximo para outros tipos no mesmo assembly, não estando visível para tipos derivados fora do assembly. (Herdado de FieldInfo)
IsCollectible	Obtém um valor que indica se este objeto MemberInfo faz parte de um assembly mantido em uma coleção AssemblyLoadContext. (Herdado de MemberInfo)
IsFamily	Obtém um valor que indica se a visibilidade do campo é ou não descrita por Family, ou seja, que o campo está visível somente dentro de sua classe e das classes derivadas. (Herdado de FieldInfo)
IsFamilyAndAssembly	Obtém um valor que indica se a visibilidade do campo é ou não descrita por FamANDAssem, ou seja, o campo pode ser acessado de classes derivadas, mas somente se elas estiverem no mesmo assembly. (Herdado de FieldInfo)
IsFamilyOrAssembly	Obtém um valor que indica se a visibilidade potencial desse campo é ou não descrita por FamORAssem, ou seja, o campo pode ser acessado por classes derivadas independentemente da localização delas, bem como por classes no mesmo assembly. (Herdado de FieldInfo)
IsInitOnly	Obtém um valor que indica se o campo só pode ser definido no corpo do construtor. (Herdado de FieldInfo)
IsLiteral	Obtém um valor que indica se o valor é gravado no tempo de compilação e não pode ser alterado. (Herdado de FieldInfo)
IsNotSerialized	Obsoleto. Obtém um valor que indica se esse campo tem o atributo NotSerialized. (Herdado de FieldInfo)
IsPinvokeImpl	Obtém um valor que indica se o atributo PinvokeImpl correspondente está definido em FieldAttributes. (Herdado de FieldInfo)
IsPrivate	Obtém um valor que indica se o campo é ou não privado. (Herdado de FieldInfo)
IsPublic	Obtém um valor que indica se o campo é ou não público. (Herdado de FieldInfo)
IsSecurityCritical	Obtém um valor que indica se o campo atual é crítico para segurança ou crítico para segurança e disponível no código transparente no nível de confiança atual. (Herdado de FieldInfo)
IsSecuritySafeCritical	Obtém um valor que indica se o campo atual é crítico para segurança e disponível no código transparente no nível de confiança atual. (Herdado de FieldInfo)
IsSecurityTransparent	Obtém um valor que indica se o campo atual é transparente no nível de confiança atual. (Herdado de FieldInfo)
IsSpecialName	Obtém um valor que indica se o atributo SpecialName correspondente está definido no enumerador FieldAttributes. (Herdado de FieldInfo)
IsStatic	Obtém um valor que indica se o campo é ou não estático. (Herdado de FieldInfo)
MemberType	Obtém um valor MemberTypes que indica que esse membro é um campo. (Herdado de FieldInfo)
MetadataToken	Obtém um token que identifica o módulo dinâmico atual nos metadados.
Module	Obtém o módulo no qual o tipo que contém esse campo está sendo definido.
Name	Indica o nome desse campo. Esta propriedade é somente para leitura.
ReflectedType	Indica a referência para o objeto Type do qual esse objeto foi definido. Esta propriedade é somente para leitura.

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de FieldInfo)
GetCustomAttributes(Boolean)	Retorna todos os atributos personalizados definidos para esse campo.
GetCustomAttributes(Type, Boolean)	Retorna todos os atributos personalizados definidos para esse campo identificado pelo tipo fornecido.
GetCustomAttributesData()	Retorna uma lista de objetos CustomAttributeData que representam dados sobre os atributos que foram aplicados ao membro de destino. (Herdado de MemberInfo)
GetHashCode()	Retorna o código hash para a instância. (Herdado de FieldInfo)
GetModifiedFieldType()	Obtém o tipo modificado deste objeto de campo. (Herdado de FieldInfo)
GetOptionalCustomModifiers()	Obtém uma matriz de tipos que identificam os modificadores personalizados opcionais do campo. (Herdado de FieldInfo)
GetRawConstantValue()	Retorna um valor literal associado ao campo por um compilador. (Herdado de FieldInfo)
GetRequiredCustomModifiers()	Obtém uma matriz de tipos que identificam os modificadores personalizados requeridos da propriedade. (Herdado de FieldInfo)
GetType()	Descobre os atributos de um campo de classe e fornece acesso a metadados de campo. (Herdado de FieldInfo)
GetValue(Object)	Recupera o valor do campo com suporte no objeto especificado.
GetValueDirect(TypedReference)	Retorna o valor de um campo com suporte no objeto especificado. (Herdado de FieldInfo)
HasSameMetadataDefinitionAs(MemberInfo)	Define e representa um campo. Essa classe não pode ser herdada. (Herdado de MemberInfo)
IsDefined(Type, Boolean)	Indica se um atributo contendo o tipo especificado é definido em um campo.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SetConstant(Object)	Define o novo valor padrão desse campo.
SetConstantCore(Object)	Quando substituído em uma classe derivada, define o valor padrão desse campo.
SetCustomAttribute(ConstructorInfo, Byte[])	Define um atributo personalizado usando um blob de atributo personalizado especificado.
SetCustomAttribute(CustomAttributeBuilder)	Define um atributo personalizado usando um construtor de atributos personalizados.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	Quando substituído em uma classe derivada, define um atributo personalizado neste assembly.
SetOffset(Int32)	Especifica o layout do campo.
SetOffsetCore(Int32)	Quando substituído em uma classe derivada, especifica o layout do campo.
SetValue(Object, Object)	Define o valor do campo com suporte no objeto especificado. (Herdado de FieldInfo)
SetValue(Object, Object, BindingFlags, Binder, CultureInfo)	Define o valor do campo com suporte no objeto especificado.
SetValueDirect(TypedReference, Object)	Define o valor do campo com suporte no objeto especificado. (Herdado de FieldInfo)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão

GetCustomAttribute(MemberInfo, Type)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado.
GetCustomAttribute(MemberInfo, Type, Boolean)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttribute<T>(MemberInfo)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado.
GetCustomAttribute<T>(MemberInfo, Boolean)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes(MemberInfo)	Recupera uma coleção de atributos personalizados que são aplicados a um membro especificado.
GetCustomAttributes(MemberInfo, Boolean)	Recupera uma coleção de atributos personalizados aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes(MemberInfo, Type)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um membro especificado.
GetCustomAttributes(MemberInfo, Type, Boolean)	Recupera uma coleção de atributos personalizados de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes<T>(MemberInfo)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um membro especificado.
GetCustomAttributes<T>(MemberInfo, Boolean)	Recupera uma coleção de atributos personalizados de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
IsDefined(MemberInfo, Type)	Indica se os atributos personalizados de um tipo especificados são aplicados a um membro especificado.
IsDefined(MemberInfo, Type, Boolean)	Indica se os atributos personalizados de um tipo especificado são aplicados a um membro especificado e, opcionalmente, aplicados a seus ancestrais.
GetMetadataToken(MemberInfo)	Obtém um token de metadados para o membro fornecido, se disponível.
HasMetadataToken(MemberInfo)	Retorna um valor que indica se um token de metadados está disponível para o membro especificado.