PropertyBuilder 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
定義型別的屬性。
public ref class PropertyBuilder sealed : System::Reflection::PropertyInfopublic ref class PropertyBuilder abstract : System::Reflection::PropertyInfopublic ref class PropertyBuilder sealed : System::Reflection::PropertyInfo, System::Runtime::InteropServices::_PropertyBuilderpublic sealed class PropertyBuilder : System.Reflection.PropertyInfopublic abstract class PropertyBuilder : System.Reflection.PropertyInfo[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public sealed class PropertyBuilder : System.Reflection.PropertyInfo, System.Runtime.InteropServices._PropertyBuilder[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class PropertyBuilder : System.Reflection.PropertyInfo, System.Runtime.InteropServices._PropertyBuildertype PropertyBuilder = class
inherit PropertyInfo[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type PropertyBuilder = class
inherit PropertyInfo
interface _PropertyBuilder[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PropertyBuilder = class
inherit PropertyInfo
interface _PropertyBuilderPublic NotInheritable Class PropertyBuilder
Inherits PropertyInfoPublic MustInherit Class PropertyBuilder
Inherits PropertyInfoPublic NotInheritable Class PropertyBuilder
Inherits PropertyInfo
Implements _PropertyBuilder- 繼承
- 屬性
- 實作
範例
下列程式代碼範例示範如何使用 透過 TypeBuilder.DefineProperty 取得的 ，在動態類型PropertyBuilder中實作屬性，以建立屬性架構和相關聯的 MethodBuilder ，以在屬性內實作 IL 邏輯。
using namespace System;
using namespace System::Threading;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
Type^ BuildDynamicTypeWithProperties()
{
AppDomain^ myDomain = Thread::GetDomain();
AssemblyName^ myAsmName = gcnew 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 );
// Define a private field to hold the property value.
FieldBuilder^ customerNameBldr = myTypeBuilder->DefineField( "customerName", String::typeid, FieldAttributes::Private );
// The last argument of DefineProperty is an empty array of Type
// objects, because the property has no parameters. (Alternatively,
// you can specify a null value.)
PropertyBuilder^ custNamePropBldr =
myTypeBuilder->DefineProperty( "CustomerName", PropertyAttributes::HasDefault, String::typeid, gcnew array<Type^>(0) );
// 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,
String::typeid,
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.
array<Type^>^temp2 = {String::typeid};
MethodBuilder^ custNameSetPropMthdBldr =
myTypeBuilder->DefineMethod( "set_CustomerName",
getSetAttr,
nullptr,
temp2 );
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;
}
int main()
{
Type^ custDataType = BuildDynamicTypeWithProperties();
array<PropertyInfo^>^custDataPropInfo = custDataType->GetProperties();
System::Collections::IEnumerator^ myEnum = custDataPropInfo->GetEnumerator();
while ( myEnum->MoveNext() )
{
PropertyInfo^ pInfo = safe_cast<PropertyInfo^>(myEnum->Current);
Console::WriteLine( "Property '{0}' created!", 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.
Object^ custData = Activator::CreateInstance( custDataType );
array<Object^>^temp3 = {"Joe User"};
custDataType->InvokeMember( "CustomerName", BindingFlags::SetProperty, nullptr, custData, temp3 );
Console::WriteLine( "The customerName field of instance custData has been set to '{0}'.", custDataType->InvokeMember( "CustomerName", BindingFlags::GetProperty, nullptr, custData, gcnew array<Object^>(0) ) );
}
// --- 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'.
// -------------------
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'.
' -------------------
備註
PropertyBuilder一律與TypeBuilder相關聯。
TypeBuilder。
DefineProperty 方法會將新的 PropertyBuilder 傳回給用戶端。
建構函式
| PropertyBuilder() |
初始化 PropertyBuilder 類別的新執行個體。 |
屬性
| Attributes |
取得這個屬性 (Property) 的屬性 (Attribute)。 |
| CanRead |
取得值，指出是否可讀取屬性。 |
| CanWrite |
取得值，指出是否可寫入屬性。 |
| CustomAttributes |
取得包含此成員之自訂屬性的集合。 (繼承來源 MemberInfo) |
| DeclaringType |
取得宣告這個成員的類別。 |
| GetMethod |
取得這個屬性的 |
| IsCollectible |
取得指出此 MemberInfo 物件是否為可回收 AssemblyLoadContext 中保存之組件一部分的值。 (繼承來源 MemberInfo) |
| IsSpecialName |
取得值，指出屬性是否為特殊名稱。 (繼承來源 PropertyInfo) |
| MemberType |
取得 MemberTypes 值，指出這個成員為屬性。 (繼承來源 PropertyInfo) |
| MetadataToken |
取得值，這個值可識別中繼資料項目。 (繼承來源 MemberInfo) |
| Module |
取得用於定義型別的模組，該型別宣告目前的屬性。 |
| Module |
取得用於定義型別的模組，該型別宣告以目前 MemberInfo 表示的成員。 (繼承來源 MemberInfo) |
| Name |
取得這個成員的名稱。 |
| PropertyToken |
擷取這個屬性的語彙基元。 |
| PropertyType |
取得這個屬性的欄位型別。 |
| ReflectedType |
取得類別物件，是用來取得這個 |
| ReflectedType |
取得類別物件，是用來取得這個 |
| SetMethod |
取得這個屬性的 |
