FieldBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit et représente un champ. Cette classe ne peut pas être héritée.
public ref class FieldBuilder sealed : System::Reflection::FieldInfo, System::Runtime::InteropServices::_FieldBuilder
public ref class FieldBuilder sealed : System::Reflection::FieldInfo
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public sealed class FieldBuilder : 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
public sealed class FieldBuilder : System.Reflection.FieldInfo
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type FieldBuilder = class
inherit FieldInfo
interface _FieldBuilder
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FieldBuilder = class
inherit FieldInfo
interface _FieldBuilder
type FieldBuilder = class
inherit FieldInfo
Public NotInheritable Class FieldBuilder
Inherits FieldInfo
Implements _FieldBuilder
Public NotInheritable Class FieldBuilder
Inherits FieldInfo
- Héritage
- Attributs
- Implémente
Exemples
L’exemple suivant illustre l’utilisation de la 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
Remarques
Obtenir une instance de l’appel FieldBuilderDefineField, DefineInitializedDataou DefineUninitializedData.
Note
La SetValue méthode n’est actuellement pas prise en charge. Pour contourner ce problème, récupérez la FieldInfo valeur en reflétant le type terminé et l’appel SetValue pour définir la valeur du champ.
Propriétés
| Nom | Description |
|---|---|
| Attributes |
Indique les attributs de ce champ. Cette propriété est en lecture seule. |
| CustomAttributes |
Obtient une collection qui contient les attributs personnalisés de ce membre. (Hérité de MemberInfo) |
| DeclaringType |
Indique une référence à l’objet pour le Type type qui déclare ce champ. Cette propriété est en lecture seule. |
| FieldHandle |
Indique le handle de métadonnées interne pour ce champ. Cette propriété est en lecture seule. |
| FieldType |
Indique l’objet Type qui représente le type de ce champ. Cette propriété est en lecture seule. |
| IsAssembly |
Obtient une valeur indiquant si la visibilité potentielle de ce champ est décrite par Assembly; autrement dit, le champ est visible au maximum par d’autres types dans le même assembly et n’est pas visible par les types dérivés en dehors de l’assembly. (Hérité de FieldInfo) |
| IsFamily |
Obtient une valeur indiquant si la visibilité de ce champ est décrite par Family; autrement dit, le champ est visible uniquement dans sa classe et ses classes dérivées. (Hérité de FieldInfo) |
| IsFamilyAndAssembly |
Obtient une valeur indiquant si la visibilité de ce champ est décrite par FamANDAssem; autrement dit, le champ est accessible à partir de classes dérivées, mais uniquement s’ils se trouvent dans le même assembly. (Hérité de FieldInfo) |
| IsFamilyOrAssembly |
Obtient une valeur indiquant si la visibilité potentielle de ce champ est décrite par FamORAssem; autrement dit, le champ est accessible par des classes dérivées où qu’elles soient, et par des classes dans le même assembly. (Hérité de FieldInfo) |
| IsInitOnly |
Obtient une valeur indiquant si le champ ne peut être défini que dans le corps du constructeur. (Hérité de FieldInfo) |
| IsLiteral |
Obtient une valeur indiquant si la valeur est écrite au moment de la compilation et ne peut pas être modifiée. (Hérité de FieldInfo) |
| IsNotSerialized |
Obtient une valeur indiquant si ce champ a l’attribut |
| IsPinvokeImpl |
Obtient une valeur indiquant si l’attribut correspondant |
| IsPrivate |
Obtient une valeur indiquant si le champ est privé. (Hérité de FieldInfo) |
| IsPublic |
Obtient une valeur indiquant si le champ est public. (Hérité de FieldInfo) |
| IsSecurityCritical |
Obtient une valeur qui indique si le champ actuel est critique pour la sécurité ou la sécurité critique au niveau de confiance actuel. (Hérité de FieldInfo) |
| IsSecuritySafeCritical |
Obtient une valeur qui indique si le champ actuel est critique pour la sécurité au niveau de confiance actuel. (Hérité de FieldInfo) |
| IsSecurityTransparent |
Obtient une valeur qui indique si le champ actuel est transparent au niveau de confiance actuel. (Hérité de FieldInfo) |
| IsSpecialName |
Obtient une valeur indiquant si l’attribut correspondant |
| IsStatic |
Obtient une valeur indiquant si le champ est statique. (Hérité de FieldInfo) |
| MemberType |
Obtient une MemberTypes valeur indiquant que ce membre est un champ. (Hérité de FieldInfo) |
| MetadataToken |
Obtient une valeur qui identifie un élément de métadonnées. (Hérité de MemberInfo) |
| Module |
Obtient le module dans lequel le type qui contient ce champ est défini. |
| Module |
Obtient le module dans lequel le type qui déclare le membre représenté par le courant MemberInfo est défini. (Hérité de MemberInfo) |
| Name |
Indique le nom de ce champ. Cette propriété est en lecture seule. |
| ReflectedType |
Indique la référence à l’objet Type à partir duquel cet objet a été obtenu. Cette propriété est en lecture seule. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de FieldInfo) |
| GetCustomAttributes(Boolean) |
Retourne tous les attributs personnalisés définis pour ce champ. |
| GetCustomAttributes(Type, Boolean) |
Retourne tous les attributs personnalisés définis pour ce champ identifié par le type donné. |
| GetCustomAttributesData() |
Retourne une liste d’objets CustomAttributeData représentant des données sur les attributs qui ont été appliqués au membre cible. (Hérité de MemberInfo) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de FieldInfo) |
| GetOptionalCustomModifiers() |
Obtient un tableau de types qui identifient les modificateurs personnalisés facultatifs du champ. (Hérité de FieldInfo) |
| GetRawConstantValue() |
Retourne une valeur littérale associée au champ par un compilateur. (Hérité de FieldInfo) |
| GetRequiredCustomModifiers() |
Obtient un tableau de types qui identifient les modificateurs personnalisés requis de la propriété. (Hérité de FieldInfo) |
| GetToken() |
Retourne le jeton représentant ce champ. |
| GetType() |
Découvre les attributs d’un champ de classe et fournit l’accès aux métadonnées de champ. (Hérité de FieldInfo) |
| GetValue(Object) |
Récupère la valeur du champ pris en charge par l’objet donné. |
| GetValueDirect(TypedReference) |
Retourne la valeur d’un champ pris en charge par un objet donné. (Hérité de FieldInfo) |
| HasSameMetadataDefinitionAs(MemberInfo) |
Définit et représente un champ. Cette classe ne peut pas être héritée. (Hérité de MemberInfo) |
| IsDefined(Type, Boolean) |
Indique si un attribut ayant le type spécifié est défini sur un champ. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| SetConstant(Object) |
Définit la valeur par défaut de ce champ. |
| SetCustomAttribute(ConstructorInfo, Byte[]) |
Définit un attribut personnalisé à l’aide d’un objet blob d’attributs personnalisé spécifié. |
| SetCustomAttribute(CustomAttributeBuilder) |
Définit un attribut personnalisé à l’aide d’un générateur d’attributs personnalisé. |
| SetMarshal(UnmanagedMarshal) |
Obsolète.
Décrit le marshaling natif du champ. |
| SetOffset(Int32) |
Spécifie la disposition du champ. |
| SetValue(Object, Object, BindingFlags, Binder, CultureInfo) |
Définit la valeur du champ pris en charge par l’objet donné. |
| SetValue(Object, Object) |
Définit la valeur du champ pris en charge par l’objet donné. (Hérité de FieldInfo) |
| SetValueDirect(TypedReference, Object) |
Définit la valeur du champ pris en charge par l’objet donné. (Hérité de FieldInfo) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _FieldBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. |
| _FieldBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface. |
| _FieldBuilder.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). |
| _FieldBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. |
| _FieldInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de FieldInfo) |
| _FieldInfo.GetType() |
Obtient un Type objet représentant le FieldInfo type. (Hérité de FieldInfo) |
| _FieldInfo.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface. (Hérité de FieldInfo) |
| _FieldInfo.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de FieldInfo) |
| _FieldInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de FieldInfo) |
| _MemberInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de MemberInfo) |
| _MemberInfo.GetType() |
Obtient un Type objet représentant la MemberInfo classe. (Hérité de MemberInfo) |
| _MemberInfo.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface. (Hérité de MemberInfo) |
| _MemberInfo.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de MemberInfo) |
| _MemberInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de MemberInfo) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetCustomAttribute(MemberInfo, Type, Boolean) |
Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié et inspecte éventuellement les ancêtres de ce membre. |
| GetCustomAttribute(MemberInfo, Type) |
Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié. |
| GetCustomAttribute<T>(MemberInfo, Boolean) |
Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié et inspecte éventuellement les ancêtres de ce membre. |
| GetCustomAttribute<T>(MemberInfo) |
Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié. |
| GetCustomAttributes(MemberInfo, Boolean) |
Récupère une collection d’attributs personnalisés appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre. |
| GetCustomAttributes(MemberInfo, Type, Boolean) |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre. |
| GetCustomAttributes(MemberInfo, Type) |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié. |
| GetCustomAttributes(MemberInfo) |
Récupère une collection d’attributs personnalisés appliqués à un membre spécifié. |
| GetCustomAttributes<T>(MemberInfo, Boolean) |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre. |
| GetCustomAttributes<T>(MemberInfo) |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié. |
| IsDefined(MemberInfo, Type, Boolean) |
Indique si les attributs personnalisés d’un type spécifié sont appliqués à un membre spécifié et, éventuellement, appliqués à ses ancêtres. |
| IsDefined(MemberInfo, Type) |
Indique si les attributs personnalisés d’un type spécifié sont appliqués à un membre spécifié. |