PropertyBuilder Kelas

Definisi

Ruang nama:

System.Reflection.Emit

Rakitan:

netstandard.dll, System.Reflection.Emit.dll

Sumber:

PropertyBuilder.cs

Menentukan properti untuk jenis.

public ref class PropertyBuilder abstract : System::Reflection::PropertyInfo

public abstract class PropertyBuilder : System.Reflection.PropertyInfo

type PropertyBuilder = class
    inherit PropertyInfo

Public MustInherit Class PropertyBuilder
Inherits PropertyInfo

Warisan

Object

MemberInfo

PropertyInfo

PropertyBuilder

Contoh

Sampel kode berikut menunjukkan cara menerapkan properti dalam jenis dinamis menggunakan yang PropertyBuilder diperoleh melalui TypeBuilder.DefineProperty untuk membuat kerangka kerja properti dan terkait MethodBuilder untuk menerapkan logika IL dalam properti.

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

class PropertyBuilderDemo
{
   public static Type BuildDynamicTypeWithProperties()
   {
        AppDomain myDomain = Thread.GetDomain();
        AssemblyName myAsmName = new AssemblyName();
        myAsmName.Name = "MyDynamicAssembly";

        // To generate a persistable assembly, specify AssemblyBuilderAccess.RunAndSave.
        AssemblyBuilder myAsmBuilder = myDomain.DefineDynamicAssembly(myAsmName,
                                                        AssemblyBuilderAccess.RunAndSave);
        // Generate a persistable single-module assembly.
        ModuleBuilder myModBuilder =
            myAsmBuilder.DefineDynamicModule(myAsmName.Name, myAsmName.Name + ".dll");

        TypeBuilder myTypeBuilder = myModBuilder.DefineType("CustomerData",
                                                        TypeAttributes.Public);

        FieldBuilder customerNameBldr = myTypeBuilder.DefineField("customerName",
                                                        typeof(string),
                                                        FieldAttributes.Private);

        // The last argument of DefineProperty is null, because the
        // property has no parameters. (If you don't specify null, you must
        // specify an array of Type objects. For a parameterless property,
        // use an array with no elements: new Type[] {})
        PropertyBuilder custNamePropBldr = myTypeBuilder.DefineProperty("CustomerName",
                                                         PropertyAttributes.HasDefault,
                                                         typeof(string),
                                                         null);

        // The property set and property get methods require a special
        // set of attributes.
        MethodAttributes getSetAttr =
            MethodAttributes.Public | MethodAttributes.SpecialName |
                MethodAttributes.HideBySig;

        // Define the "get" accessor method for CustomerName.
        MethodBuilder custNameGetPropMthdBldr =
            myTypeBuilder.DefineMethod("get_CustomerName",
                                       getSetAttr,
                                       typeof(string),
                                       Type.EmptyTypes);

        ILGenerator custNameGetIL = custNameGetPropMthdBldr.GetILGenerator();

        custNameGetIL.Emit(OpCodes.Ldarg_0);
        custNameGetIL.Emit(OpCodes.Ldfld, customerNameBldr);
        custNameGetIL.Emit(OpCodes.Ret);

        // Define the "set" accessor method for CustomerName.
        MethodBuilder custNameSetPropMthdBldr =
            myTypeBuilder.DefineMethod("set_CustomerName",
                                       getSetAttr,
                                       null,
                                       new Type[] { typeof(string) });

        ILGenerator custNameSetIL = custNameSetPropMthdBldr.GetILGenerator();

        custNameSetIL.Emit(OpCodes.Ldarg_0);
        custNameSetIL.Emit(OpCodes.Ldarg_1);
        custNameSetIL.Emit(OpCodes.Stfld, customerNameBldr);
        custNameSetIL.Emit(OpCodes.Ret);

        // Last, we must map the two methods created above to our PropertyBuilder to
        // their corresponding behaviors, "get" and "set" respectively.
        custNamePropBldr.SetGetMethod(custNameGetPropMthdBldr);
        custNamePropBldr.SetSetMethod(custNameSetPropMthdBldr);

        Type retval = myTypeBuilder.CreateType();

        // Save the assembly so it can be examined with Ildasm.exe,
        // or referenced by a test program.
        myAsmBuilder.Save(myAsmName.Name + ".dll");
        return retval;
   }

   public static void Main()
   {
        Type custDataType = BuildDynamicTypeWithProperties();

        PropertyInfo[] custDataPropInfo = custDataType.GetProperties();
        foreach (PropertyInfo pInfo in custDataPropInfo) {
           Console.WriteLine("Property '{0}' created!", pInfo.ToString());
        }

        Console.WriteLine("---");
        // Note that when invoking a property, you need to use the proper BindingFlags -
        // BindingFlags.SetProperty when you invoke the "set" behavior, and
        // BindingFlags.GetProperty when you invoke the "get" behavior. Also note that
        // we invoke them based on the name we gave the property, as expected, and not
        // the name of the methods we bound to the specific property behaviors.

        object custData = Activator.CreateInstance(custDataType);
        custDataType.InvokeMember("CustomerName", BindingFlags.SetProperty,
                                      null, custData, new object[]{ "Joe User" });

        Console.WriteLine("The customerName field of instance custData has been set to '{0}'.",
                           custDataType.InvokeMember("CustomerName", BindingFlags.GetProperty,
                                                      null, custData, new object[]{ }));
   }
}

// --- O U T P U T ---
// The output should be as follows:
// -------------------
// Property 'System.String CustomerName' created!
// ---
// The customerName field of instance custData has been set to 'Joe User'.
// -------------------

Imports System.Threading
Imports System.Reflection
Imports System.Reflection.Emit

Class PropertyBuilderDemo
   
   Public Shared Function BuildDynamicTypeWithProperties() As Type
      Dim myDomain As AppDomain = Thread.GetDomain()
      Dim myAsmName As New AssemblyName()
      myAsmName.Name = "MyDynamicAssembly"
      
      ' To generate a persistable assembly, specify AssemblyBuilderAccess.RunAndSave.
      Dim myAsmBuilder As AssemblyBuilder = myDomain.DefineDynamicAssembly(myAsmName, _
                                                        AssemblyBuilderAccess.RunAndSave)
      
      ' Generate a persistable, single-module assembly.
      Dim myModBuilder As ModuleBuilder = _
          myAsmBuilder.DefineDynamicModule(myAsmName.Name, myAsmName.Name & ".dll")
      
      Dim myTypeBuilder As TypeBuilder = myModBuilder.DefineType("CustomerData", TypeAttributes.Public)
      
      ' Define a private field to hold the property value.
      Dim customerNameBldr As FieldBuilder = myTypeBuilder.DefineField("customerName", _
                                             GetType(String), FieldAttributes.Private)
      
      ' The last argument of DefineProperty is Nothing, because the
      ' property has no parameters. (If you don't specify Nothing, you must
      ' specify an array of Type objects. For a parameterless property,
      ' use an array with no elements: New Type() {})
      Dim custNamePropBldr As PropertyBuilder = _
          myTypeBuilder.DefineProperty("CustomerName", _
                                       PropertyAttributes.HasDefault, _
                                       GetType(String), _
                                       Nothing)
      
      ' The property set and property get methods require a special
      ' set of attributes.
      Dim getSetAttr As MethodAttributes = _
          MethodAttributes.Public Or MethodAttributes.SpecialName _
              Or MethodAttributes.HideBySig

      ' Define the "get" accessor method for CustomerName.
      Dim custNameGetPropMthdBldr As MethodBuilder = _
          myTypeBuilder.DefineMethod("GetCustomerName", _
                                     getSetAttr, _
                                     GetType(String), _
                                     Type.EmptyTypes)
      
      Dim custNameGetIL As ILGenerator = custNameGetPropMthdBldr.GetILGenerator()
      
      custNameGetIL.Emit(OpCodes.Ldarg_0)
      custNameGetIL.Emit(OpCodes.Ldfld, customerNameBldr)
      custNameGetIL.Emit(OpCodes.Ret)
      
      ' Define the "set" accessor method for CustomerName.
      Dim custNameSetPropMthdBldr As MethodBuilder = _
          myTypeBuilder.DefineMethod("get_CustomerName", _
                                     getSetAttr, _
                                     Nothing, _
                                     New Type() {GetType(String)})
      
      Dim custNameSetIL As ILGenerator = custNameSetPropMthdBldr.GetILGenerator()
      
      custNameSetIL.Emit(OpCodes.Ldarg_0)
      custNameSetIL.Emit(OpCodes.Ldarg_1)
      custNameSetIL.Emit(OpCodes.Stfld, customerNameBldr)
      custNameSetIL.Emit(OpCodes.Ret)
      
      ' Last, we must map the two methods created above to our PropertyBuilder to 
      ' their corresponding behaviors, "get" and "set" respectively. 
      custNamePropBldr.SetGetMethod(custNameGetPropMthdBldr)
      custNamePropBldr.SetSetMethod(custNameSetPropMthdBldr)
            
      Dim retval As Type = myTypeBuilder.CreateType()

      ' Save the assembly so it can be examined with Ildasm.exe,
      ' or referenced by a test program.
      myAsmBuilder.Save(myAsmName.Name & ".dll")
      return retval
   End Function 'BuildDynamicTypeWithProperties
    
   
   Public Shared Sub Main()
      Dim custDataType As Type = BuildDynamicTypeWithProperties()
      
      Dim custDataPropInfo As PropertyInfo() = custDataType.GetProperties()
      Dim pInfo As PropertyInfo
      For Each pInfo In  custDataPropInfo
         Console.WriteLine("Property '{0}' created!", pInfo.ToString())
      Next pInfo
      
      Console.WriteLine("---")
      ' Note that when invoking a property, you need to use the proper BindingFlags -
      ' BindingFlags.SetProperty when you invoke the "set" behavior, and 
      ' BindingFlags.GetProperty when you invoke the "get" behavior. Also note that
      ' we invoke them based on the name we gave the property, as expected, and not
      ' the name of the methods we bound to the specific property behaviors.
      Dim custData As Object = Activator.CreateInstance(custDataType)
      custDataType.InvokeMember("CustomerName", BindingFlags.SetProperty, Nothing, _
                                custData, New Object() {"Joe User"})
      
      Console.WriteLine("The customerName field of instance custData has been set to '{0}'.", _
                        custDataType.InvokeMember("CustomerName", BindingFlags.GetProperty, _
                        Nothing, custData, New Object() {}))
   End Sub
End Class


' --- O U T P U T ---
' The output should be as follows:
' -------------------
' Property 'System.String CustomerName' created!
' ---
' The customerName field of instance custData has been set to 'Joe User'.
' -------------------

Keterangan

A PropertyBuilder selalu dikaitkan dengan TypeBuilder. TypeBuilder. DefineProperty metode akan mengembalikan baru PropertyBuilder ke klien.

Konstruktor

Nama	Deskripsi
PropertyBuilder()	Menginisialisasi instans baru dari kelas PropertyBuilder.

Properti

Nama	Deskripsi
Attributes	Mendapatkan atribut untuk properti ini.
CanRead	Mendapatkan nilai yang menunjukkan apakah properti dapat dibaca.
CanWrite	Mendapatkan nilai yang menunjukkan apakah properti dapat ditulis.
CustomAttributes	Mendapatkan koleksi yang berisi atribut kustom anggota ini. (Diperoleh dari MemberInfo)
DeclaringType	Mendapatkan kelas yang mendeklarasikan anggota ini.
GetMethod	get Mendapatkan aksesor untuk properti ini. (Diperoleh dari PropertyInfo)
IsCollectible	Mendapatkan nilai yang menunjukkan apakah objek ini MemberInfo mereferensikan satu atau beberapa rakitan yang disimpan dalam koleksi AssemblyLoadContext. (Diperoleh dari MemberInfo)
IsSpecialName	Mendapatkan nilai yang menunjukkan apakah properti adalah nama khusus. (Diperoleh dari PropertyInfo)
MemberType	Mendapatkan nilai yang MemberTypes menunjukkan bahwa anggota ini adalah properti. (Diperoleh dari PropertyInfo)
MetadataToken	Mendapatkan nilai yang mengidentifikasi elemen metadata. (Diperoleh dari MemberInfo)
Module	Mendapatkan modul di mana jenis yang menyatakan properti saat ini sedang ditentukan.
Name	Mendapatkan nama anggota ini.
PropertyType	Mendapatkan tipe bidang properti ini.
ReflectedType	Mendapatkan objek kelas yang digunakan untuk mendapatkan instans MemberInfoini.
SetMethod	set Mendapatkan aksesor untuk properti ini. (Diperoleh dari PropertyInfo)

Metode

Nama	Deskripsi
AddOtherMethod(MethodBuilder)	Menambahkan salah satu metode lain yang terkait dengan properti ini.
AddOtherMethodCore(MethodBuilder)	Ketika ditimpa dalam kelas turunan, menambahkan salah satu metode lain yang terkait dengan properti ini.
Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari PropertyInfo)
GetAccessors()	Mengembalikan array yang elemennya mencerminkan publik get dan set aksesor properti yang tercermin oleh instans saat ini. (Diperoleh dari PropertyInfo)
GetAccessors(Boolean)	Mengembalikan array publik dan non-publik get dan set aksesor pada properti ini.
GetConstantValue()	Mengembalikan nilai harfiah yang terkait dengan properti oleh pengkompilasi. (Diperoleh dari PropertyInfo)
GetCustomAttributes(Boolean)	Mengembalikan array dari semua atribut kustom untuk properti ini.
GetCustomAttributes(Type, Boolean)	Mengembalikan array atribut kustom yang diidentifikasi oleh Type.
GetCustomAttributesData()	Mengembalikan daftar objek CustomAttributeData yang mewakili data tentang atribut yang telah diterapkan ke anggota target. (Diperoleh dari MemberInfo)
GetGetMethod()	Mengembalikan aksesor publik get untuk properti ini. (Diperoleh dari PropertyInfo)
GetGetMethod(Boolean)	Mengembalikan aksesor get publik dan non-publik untuk properti ini.
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari PropertyInfo)
GetIndexParameters()	Mengembalikan array dari semua parameter indeks untuk properti .
GetModifiedPropertyType()	Mendapatkan tipe objek properti ini yang dimodifikasi. (Diperoleh dari PropertyInfo)
GetOptionalCustomModifiers()	Mengembalikan array jenis yang mewakili pengubah kustom opsional properti. (Diperoleh dari PropertyInfo)
GetRawConstantValue()	Mengembalikan nilai harfiah yang terkait dengan properti oleh pengkompilasi. (Diperoleh dari PropertyInfo)
GetRequiredCustomModifiers()	Mengembalikan array jenis yang mewakili pengubah kustom properti yang diperlukan. (Diperoleh dari PropertyInfo)
GetSetMethod()	Mengembalikan aksesor publik set untuk properti ini. (Diperoleh dari PropertyInfo)
GetSetMethod(Boolean)	Mengembalikan aksesor yang ditetapkan untuk properti ini.
GetValue(Object, BindingFlags, Binder, Object[], CultureInfo)	Mendapatkan nilai properti yang memiliki pengikatan, indeks, dan CultureInfo.
GetValue(Object, Object[])	Mendapatkan nilai properti terindeks dengan memanggil metode getter properti.
GetValue(Object)	Mengembalikan nilai properti dari objek tertentu. (Diperoleh dari PropertyInfo)
HasSameMetadataDefinitionAs(MemberInfo)	Menentukan properti untuk jenis. (Diperoleh dari MemberInfo)
IsDefined(Type, Boolean)	Menunjukkan apakah satu atau beberapa attributeType instans ditentukan pada properti ini.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SetConstant(Object)	Mengatur nilai default properti ini.
SetConstantCore(Object)	Saat ditimpa dalam kelas turunan, mengatur nilai default properti ini.
SetCustomAttribute(ConstructorInfo, Byte[])	Atur atribut kustom menggunakan blob atribut kustom tertentu.
SetCustomAttribute(CustomAttributeBuilder)	Atur atribut kustom menggunakan pembangun atribut kustom.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	Saat ditimpa di kelas turunan, atur atribut kustom pada rakitan ini.
SetGetMethod(MethodBuilder)	Mengatur metode yang mendapatkan nilai properti.
SetGetMethodCore(MethodBuilder)	Saat ditimpa dalam kelas turunan, mengatur metode yang mendapatkan nilai properti.
SetSetMethod(MethodBuilder)	Mengatur metode yang mengatur nilai properti.
SetSetMethodCore(MethodBuilder)	Saat ditimpa dalam kelas turunan, mengatur metode yang mengatur nilai properti.
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	Mengatur nilai properti untuk objek yang diberikan ke nilai yang diberikan.
SetValue(Object, Object, Object[])	Mengatur nilai properti dengan nilai indeks opsional untuk properti indeks.
SetValue(Object, Object)	Mengatur nilai properti objek tertentu. (Diperoleh dari PropertyInfo)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

Nama	Deskripsi
GetAccessors(PropertyInfo, Boolean)	Menentukan properti untuk jenis.
GetAccessors(PropertyInfo)	Menentukan properti untuk jenis.
GetCustomAttribute(MemberInfo, Type, Boolean)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu, dan secara opsional memeriksa leluhur anggota tersebut.
GetCustomAttribute(MemberInfo, Type)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu.
GetCustomAttribute<T>(MemberInfo, Boolean)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu, dan secara opsional memeriksa leluhur anggota tersebut.
GetCustomAttribute<T>(MemberInfo)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu.
GetCustomAttributes(MemberInfo, Boolean)	Mengambil kumpulan atribut kustom yang diterapkan ke anggota tertentu, dan secara opsional memeriksa leluhur anggota tersebut.
GetCustomAttributes(MemberInfo, Type, Boolean)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu, dan secara opsional memeriksa leluhur anggota tersebut.
GetCustomAttributes(MemberInfo, Type)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu.
GetCustomAttributes(MemberInfo)	Mengambil kumpulan atribut kustom yang diterapkan ke anggota tertentu.
GetCustomAttributes<T>(MemberInfo, Boolean)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu, dan secara opsional memeriksa leluhur anggota tersebut.
GetCustomAttributes<T>(MemberInfo)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke anggota tertentu.
GetGetMethod(PropertyInfo, Boolean)	Menentukan properti untuk jenis.
GetGetMethod(PropertyInfo)	Menentukan properti untuk jenis.
GetMetadataToken(MemberInfo)	Mendapatkan token metadata untuk anggota tertentu, jika tersedia.
GetSetMethod(PropertyInfo, Boolean)	Menentukan properti untuk jenis.
GetSetMethod(PropertyInfo)	Menentukan properti untuk jenis.
HasMetadataToken(MemberInfo)	Mengembalikan nilai yang menunjukkan apakah token metadata tersedia untuk anggota yang ditentukan.
IsDefined(MemberInfo, Type, Boolean)	Menunjukkan apakah atribut kustom dari jenis tertentu diterapkan ke anggota tertentu, dan, secara opsional, diterapkan ke leluhurnya.
IsDefined(MemberInfo, Type)	Menunjukkan apakah atribut kustom dari jenis tertentu diterapkan ke anggota tertentu.