AssemblyBuilder.DefineVersionInfoResource Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bu derleme için yönetilmeyen bir sürüm bilgisi kaynağı tanımlar.
Aşırı Yüklemeler
DefineVersionInfoResource() |
Derlemenin AssemblyName nesnesinde ve derlemenin özel özniteliklerinde belirtilen bilgileri kullanarak yönetilmeyen sürüm bilgisi kaynağını tanımlar. |
DefineVersionInfoResource(String, String, String, String, String) |
Bu derleme için belirli belirtimlere sahip yönetilmeyen bir sürüm bilgisi kaynağı tanımlar. |
DefineVersionInfoResource()
Derlemenin AssemblyName nesnesinde ve derlemenin özel özniteliklerinde belirtilen bilgileri kullanarak yönetilmeyen sürüm bilgisi kaynağını tanımlar.
public:
void DefineVersionInfoResource();
public void DefineVersionInfoResource ();
member this.DefineVersionInfoResource : unit -> unit
Public Sub DefineVersionInfoResource ()
Özel durumlar
Yönetilmeyen bir sürüm bilgisi kaynağı önceden tanımlanmıştı.
-veya-
Yönetilmeyen sürüm bilgileri kalıcı olamayacak kadar büyük.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki örnekte kullanımı gösterilmektedir DefineVersionInfoResource
.
using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
/*
// Create the callee transient dynamic assembly.
static Type^ CreateAssembly( AppDomain^ myDomain )
{
AssemblyName^ myAssemblyName = gcnew AssemblyName;
myAssemblyName->Name = "MyEmittedAssembly";
AssemblyBuilder^ myAssembly = myDomain->DefineDynamicAssembly( myAssemblyName, AssemblyBuilderAccess::Save );
// Set Company Attribute to the assembly.
Type^ companyAttribute = AssemblyCompanyAttribute::typeid;
array<Type^>^types1 = {String::typeid};
ConstructorInfo^ myConstructorInfo1 = companyAttribute->GetConstructor( types1 );
array<Object^>^obj1 = {"Microsoft Corporation"};
CustomAttributeBuilder^ attributeBuilder1 = gcnew CustomAttributeBuilder( myConstructorInfo1,obj1 );
myAssembly->SetCustomAttribute( attributeBuilder1 );
// Set Copyright Attribute to the assembly.
Type^ copyrightAttribute = AssemblyCopyrightAttribute::typeid;
array<Type^>^types2 = {String::typeid};
ConstructorInfo^ myConstructorInfo2 = copyrightAttribute->GetConstructor( types2 );
array<Object^>^obj2 = {"@Copyright Microsoft Corp. 1990-2001"};
CustomAttributeBuilder^ attributeBuilder2 = gcnew CustomAttributeBuilder( myConstructorInfo2,obj2 );
myAssembly->SetCustomAttribute( attributeBuilder2 );
ModuleBuilder^ myModule = myAssembly->DefineDynamicModule( "EmittedModule", "EmittedModule.mod" );
// Define a public class named S"HelloWorld" in the assembly.
TypeBuilder^ helloWorldClass = myModule->DefineType( "HelloWorld", TypeAttributes::Public );
// Define the Display method.
MethodBuilder^ myMethod = helloWorldClass->DefineMethod( "Display", MethodAttributes::Public, String::typeid, nullptr );
// Generate IL for GetGreeting.
ILGenerator^ methodIL = myMethod->GetILGenerator();
methodIL->Emit( OpCodes::Ldstr, "Display method get called." );
methodIL->Emit( OpCodes::Ret );
// Returns the type HelloWorld.
return (helloWorldClass->CreateType());
}
*/
int main()
{
AssemblyName^ assemName = gcnew AssemblyName();
assemName->Name = "EmittedAssembly";
// Create a dynamic assembly in the current application domain,
// specifying that the assembly is to be saved.
//
AssemblyBuilder^ myAssembly =
AppDomain::CurrentDomain->DefineDynamicAssembly(assemName,
AssemblyBuilderAccess::Save);
// To apply an attribute to a dynamic assembly, first get the
// attribute type. The AssemblyFileVersionAttribute sets the
// File Version field on the Version tab of the Windows file
// properties dialog.
//
Type^ attributeType = AssemblyFileVersionAttribute::typeid;
// To identify the constructor, use an array of types representing
// the constructor's parameter types. This ctor takes a string.
//
array<Type^>^ ctorParameters = { String::typeid };
// Get the constructor for the attribute.
//
ConstructorInfo^ ctor = attributeType->GetConstructor(ctorParameters);
// Pass the constructor and an array of arguments (in this case,
// an array containing a single string) to the
// CustomAttributeBuilder constructor.
//
array<Object^>^ ctorArgs = { "2.0.3033.0" };
CustomAttributeBuilder^ attribute =
gcnew CustomAttributeBuilder(ctor, ctorArgs);
// Finally, apply the attribute to the assembly.
//
myAssembly->SetCustomAttribute(attribute);
// The pattern described above is used to create and apply
// several more attributes. As it happens, all these attributes
// have a constructor that takes a string, so the same ctorArgs
// variable works for all of them.
// The AssemblyTitleAttribute sets the Description field on
// the General tab and the Version tab of the Windows file
// properties dialog.
//
attributeType = AssemblyTitleAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
ctorArgs = gcnew array<Object^> { "The Application Title" };
attribute = gcnew CustomAttributeBuilder(ctor, ctorArgs);
myAssembly->SetCustomAttribute(attribute);
// The AssemblyCopyrightAttribute sets the Copyright field on
// the Version tab.
//
attributeType = AssemblyCopyrightAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
ctorArgs = gcnew array<Object^> { "� My Example Company 1991-2005" };
attribute = gcnew CustomAttributeBuilder(ctor, ctorArgs);
myAssembly->SetCustomAttribute(attribute);
// The AssemblyDescriptionAttribute sets the Comment item.
//
attributeType = AssemblyDescriptionAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "This is a comment." });
myAssembly->SetCustomAttribute(attribute);
// The AssemblyCompanyAttribute sets the Company item.
//
attributeType = AssemblyCompanyAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "My Example Company" });
myAssembly->SetCustomAttribute(attribute);
// The AssemblyProductAttribute sets the Product Name item.
//
attributeType = AssemblyProductAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "My Product Name" });
myAssembly->SetCustomAttribute(attribute);
// Define the assembly's only module. For a single-file assembly,
// the module name is the assembly name.
//
ModuleBuilder^ myModule =
myAssembly->DefineDynamicModule(assemName->Name,
assemName->Name + ".exe");
// No types or methods are created for this example.
// Define the unmanaged version information resource, which
// contains the attribute informaion applied earlier, and save
// the assembly. Use the Windows Explorer to examine the properties
// of the .exe file.
//
myAssembly->DefineVersionInfoResource();
myAssembly->Save(assemName->Name + ".exe");
}
using System;
using System.Reflection;
using System.Reflection.Emit;
class Example
{
public static void Main()
{
AssemblyName assemName = new AssemblyName();
assemName.Name = "EmittedAssembly";
// Create a dynamic assembly in the current application domain,
// specifying that the assembly is to be saved.
//
AssemblyBuilder myAssembly =
AppDomain.CurrentDomain.DefineDynamicAssembly(assemName,
AssemblyBuilderAccess.Save);
// To apply an attribute to a dynamic assembly, first get the
// attribute type. The AssemblyFileVersionAttribute sets the
// File Version field on the Version tab of the Windows file
// properties dialog.
//
Type attributeType = typeof(AssemblyFileVersionAttribute);
// To identify the constructor, use an array of types representing
// the constructor's parameter types. This ctor takes a string.
//
Type[] ctorParameters = { typeof(string) };
// Get the constructor for the attribute.
//
ConstructorInfo ctor = attributeType.GetConstructor(ctorParameters);
// Pass the constructor and an array of arguments (in this case,
// an array containing a single string) to the
// CustomAttributeBuilder constructor.
//
object[] ctorArgs = { "2.0.3033.0" };
CustomAttributeBuilder attribute =
new CustomAttributeBuilder(ctor, ctorArgs);
// Finally, apply the attribute to the assembly.
//
myAssembly.SetCustomAttribute(attribute);
// The pattern described above is used to create and apply
// several more attributes. As it happens, all these attributes
// have a constructor that takes a string, so the same ctorArgs
// variable works for all of them.
// The AssemblyTitleAttribute sets the Description field on
// the General tab and the Version tab of the Windows file
// properties dialog.
//
attributeType = typeof(AssemblyTitleAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
ctorArgs = new object[] { "The Application Title" };
attribute = new CustomAttributeBuilder(ctor, ctorArgs);
myAssembly.SetCustomAttribute(attribute);
// The AssemblyCopyrightAttribute sets the Copyright field on
// the Version tab.
//
attributeType = typeof(AssemblyCopyrightAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
ctorArgs = new object[] { "© My Example Company 1991-2005" };
attribute = new CustomAttributeBuilder(ctor, ctorArgs);
myAssembly.SetCustomAttribute(attribute);
// The AssemblyDescriptionAttribute sets the Comment item.
//
attributeType = typeof(AssemblyDescriptionAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "This is a comment." });
myAssembly.SetCustomAttribute(attribute);
// The AssemblyCompanyAttribute sets the Company item.
//
attributeType = typeof(AssemblyCompanyAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "My Example Company" });
myAssembly.SetCustomAttribute(attribute);
// The AssemblyProductAttribute sets the Product Name item.
//
attributeType = typeof(AssemblyProductAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "My Product Name" });
myAssembly.SetCustomAttribute(attribute);
// Define the assembly's only module. For a single-file assembly,
// the module name is the assembly name.
//
ModuleBuilder myModule =
myAssembly.DefineDynamicModule(assemName.Name,
assemName.Name + ".exe");
// No types or methods are created for this example.
// Define the unmanaged version information resource, which
// contains the attribute informaion applied earlier, and save
// the assembly. Use the Windows Explorer to examine the properties
// of the .exe file.
//
myAssembly.DefineVersionInfoResource();
myAssembly.Save(assemName.Name + ".exe");
}
}
Imports System.Reflection
Imports System.Reflection.Emit
Module Example
Sub Main()
Dim assemName As New AssemblyName()
assemName.Name = "EmittedAssembly"
' Create a dynamic assembly in the current application domain,
' specifying that the assembly is to be saved.
'
Dim myAssembly As AssemblyBuilder = _
AppDomain.CurrentDomain.DefineDynamicAssembly(assemName, _
AssemblyBuilderAccess.Save)
' To apply an attribute to a dynamic assembly, first get the
' attribute type. The AssemblyFileVersionAttribute sets the
' File Version field on the Version tab of the Windows file
' properties dialog.
'
Dim attributeType As Type = GetType(AssemblyFileVersionAttribute)
' To identify the constructor, use an array of types representing
' the constructor's parameter types. This ctor takes a string.
'
Dim ctorParameters() As Type = { GetType(String) }
' Get the constructor for the attribute.
'
Dim ctor As ConstructorInfo = _
attributeType.GetConstructor(ctorParameters)
' Pass the constructor and an array of arguments (in this case,
' an array containing a single string) to the
' CustomAttributeBuilder constructor.
'
Dim ctorArgs() As Object = { "2.0.3033.0" }
Dim attribute As New CustomAttributeBuilder(ctor, ctorArgs)
' Finally, apply the attribute to the assembly.
'
myAssembly.SetCustomAttribute(attribute)
' The pattern described above is used to create and apply
' several more attributes. As it happens, all these attributes
' have a constructor that takes a string, so the same ctorArgs
' variable works for all of them.
' The AssemblyTitleAttribute sets the Description field on
' the General tab and the Version tab of the Windows file
' properties dialog.
'
attributeType = GetType(AssemblyTitleAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
ctorArgs = New Object() { "The Application Title" }
attribute = New CustomAttributeBuilder(ctor, ctorArgs)
myAssembly.SetCustomAttribute(attribute)
' The AssemblyCopyrightAttribute sets the Copyright field on
' the Version tab.
'
attributeType = GetType(AssemblyCopyrightAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
ctorArgs = New Object() { "© My Example Company 1991-2005" }
attribute = New CustomAttributeBuilder(ctor, ctorArgs)
myAssembly.SetCustomAttribute(attribute)
' The AssemblyDescriptionAttribute sets the Comment item.
'
attributeType = GetType(AssemblyDescriptionAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "This is a comment." })
myAssembly.SetCustomAttribute(attribute)
' The AssemblyCompanyAttribute sets the Company item.
'
attributeType = GetType(AssemblyCompanyAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "My Example Company" })
myAssembly.SetCustomAttribute(attribute)
' The AssemblyProductAttribute sets the Product Name item.
'
attributeType = GetType(AssemblyProductAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "My Product Name" })
myAssembly.SetCustomAttribute(attribute)
' Define the assembly's only module. For a single-file assembly,
' the module name is the assembly name.
'
Dim myModule As ModuleBuilder = _
myAssembly.DefineDynamicModule(assemName.Name, _
assemName.Name & ".exe")
' No types or methods are created for this example.
' Define the unmanaged version information resource, which
' contains the attribute informaion applied earlier, and save
' the assembly. Use the Windows Explorer to examine the properties
' of the .exe file.
'
myAssembly.DefineVersionInfoResource()
myAssembly.Save(assemName.Name & ".exe")
End Sub
End Module
Açıklamalar
Bir derleme yalnızca bir yönetilmeyen kaynakla ilişkilendirilebilir. Başka bir DefineVersionInfoResource deyişle, yöntemlerden biri daha önce çağrıldıktan veya DefineUnmanagedResource çağrıldıktan sonra System.ArgumentException'ı oluşturur. Microsoft ResMerge yardımcı programı (ortak dil çalışma zamanı SDK'sı ile sağlanmaz) gibi bir araçla birden çok yönetilmeyen kaynağın birleştirilmesi gerekir.
Boş bağımsız değişken dizeleri tek bir boşluk olarak yazılır. Boşluklar, bağımsız değişken dizelerindeki null karakterlerle değiştirilir.
Bilgiler, bu dinamik derlemeyi AssemblyName
tanımlamak için kullanılan nesneden çıkarılır. Bu derlemenin özel öznitelikleri nesnesinde AssemblyName
belirtilen bilgileri geçersiz kılar.
Not
.NET Framework 2.0 Service Pack 1'den başlayarak, bu üye artık bayrağını ReflectionPermissionFlag.ReflectionEmit gerektirmezReflectionPermission. (Bkz. Yansıma Yaymadaki Güvenlik Sorunları.) Bu işlevselliği kullanmak için uygulamanızın .NET Framework 3.5 veya sonraki bir sürümü hedeflemesi gerekir.
Şunlara uygulanır
DefineVersionInfoResource(String, String, String, String, String)
Bu derleme için belirli belirtimlere sahip yönetilmeyen bir sürüm bilgisi kaynağı tanımlar.
public:
void DefineVersionInfoResource(System::String ^ product, System::String ^ productVersion, System::String ^ company, System::String ^ copyright, System::String ^ trademark);
public void DefineVersionInfoResource (string product, string productVersion, string company, string copyright, string trademark);
member this.DefineVersionInfoResource : string * string * string * string * string -> unit
Public Sub DefineVersionInfoResource (product As String, productVersion As String, company As String, copyright As String, trademark As String)
Parametreler
- product
- String
Bu derlemenin dağıtıldığı ürünün adı.
- productVersion
- String
Bu derlemenin dağıtıldığı ürünün sürümü.
- company
- String
Bu derlemeyi üreten şirketin adı.
- copyright
- String
Bu derleme için geçerli olan tüm telif hakkı bildirimlerini, ticari markaları ve kayıtlı ticari markaları açıklar. Bu, tüm bildirimlerin, yasal simgelerin, telif hakkı tarihlerinin, ticari marka numaralarının vb. tam metnini içermelidir. İngilizce olarak, bu dize "Telif Hakkı Microsoft Corp. 1990-2001" biçiminde olmalıdır.
- trademark
- String
Bu derleme için geçerli olan tüm ticari markaları ve kayıtlı ticari markaları açıklar. Bu, tüm bildirimlerin, yasal simgelerin, ticari marka numaralarının vb. tam metnini içermelidir. İngilizce olarak, bu dize "Windows, Microsoft Corporation'ın ticari markasıdır" biçiminde olmalıdır.
Özel durumlar
Yönetilmeyen bir sürüm bilgisi kaynağı önceden tanımlanmıştı.
-veya-
Yönetilmeyen sürüm bilgileri kalıcı olamayacak kadar büyük.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki örnekte kullanımı gösterilmektedir DefineVersionInfoResource
.
using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
/*
// Create the callee transient dynamic assembly.
static Type^ CreateAssembly( AppDomain^ myDomain )
{
AssemblyName^ myAssemblyName = gcnew AssemblyName;
myAssemblyName->Name = "MyEmittedAssembly";
AssemblyBuilder^ myAssembly = myDomain->DefineDynamicAssembly( myAssemblyName, AssemblyBuilderAccess::Save );
// Set Company Attribute to the assembly.
Type^ companyAttribute = AssemblyCompanyAttribute::typeid;
array<Type^>^types1 = {String::typeid};
ConstructorInfo^ myConstructorInfo1 = companyAttribute->GetConstructor( types1 );
array<Object^>^obj1 = {"Microsoft Corporation"};
CustomAttributeBuilder^ attributeBuilder1 = gcnew CustomAttributeBuilder( myConstructorInfo1,obj1 );
myAssembly->SetCustomAttribute( attributeBuilder1 );
// Set Copyright Attribute to the assembly.
Type^ copyrightAttribute = AssemblyCopyrightAttribute::typeid;
array<Type^>^types2 = {String::typeid};
ConstructorInfo^ myConstructorInfo2 = copyrightAttribute->GetConstructor( types2 );
array<Object^>^obj2 = {"@Copyright Microsoft Corp. 1990-2001"};
CustomAttributeBuilder^ attributeBuilder2 = gcnew CustomAttributeBuilder( myConstructorInfo2,obj2 );
myAssembly->SetCustomAttribute( attributeBuilder2 );
ModuleBuilder^ myModule = myAssembly->DefineDynamicModule( "EmittedModule", "EmittedModule.mod" );
// Define a public class named S"HelloWorld" in the assembly.
TypeBuilder^ helloWorldClass = myModule->DefineType( "HelloWorld", TypeAttributes::Public );
// Define the Display method.
MethodBuilder^ myMethod = helloWorldClass->DefineMethod( "Display", MethodAttributes::Public, String::typeid, nullptr );
// Generate IL for GetGreeting.
ILGenerator^ methodIL = myMethod->GetILGenerator();
methodIL->Emit( OpCodes::Ldstr, "Display method get called." );
methodIL->Emit( OpCodes::Ret );
// Returns the type HelloWorld.
return (helloWorldClass->CreateType());
}
*/
int main()
{
AssemblyName^ assemName = gcnew AssemblyName();
assemName->Name = "EmittedAssembly";
// Create a dynamic assembly in the current application domain,
// specifying that the assembly is to be saved.
//
AssemblyBuilder^ myAssembly =
AppDomain::CurrentDomain->DefineDynamicAssembly(assemName,
AssemblyBuilderAccess::Save);
// To apply an attribute to a dynamic assembly, first get the
// attribute type. The AssemblyFileVersionAttribute sets the
// File Version field on the Version tab of the Windows file
// properties dialog.
//
Type^ attributeType = AssemblyFileVersionAttribute::typeid;
// To identify the constructor, use an array of types representing
// the constructor's parameter types. This ctor takes a string.
//
array<Type^>^ ctorParameters = { String::typeid };
// Get the constructor for the attribute.
//
ConstructorInfo^ ctor = attributeType->GetConstructor(ctorParameters);
// Pass the constructor and an array of arguments (in this case,
// an array containing a single string) to the
// CustomAttributeBuilder constructor.
//
array<Object^>^ ctorArgs = { "2.0.3033.0" };
CustomAttributeBuilder^ attribute =
gcnew CustomAttributeBuilder(ctor, ctorArgs);
// Finally, apply the attribute to the assembly.
//
myAssembly->SetCustomAttribute(attribute);
// The pattern described above is used to create and apply
// several more attributes. As it happens, all these attributes
// have a constructor that takes a string, so the same ctorArgs
// variable works for all of them.
// The AssemblyTitleAttribute sets the Description field on
// the General tab and the Version tab of the Windows file
// properties dialog.
//
attributeType = AssemblyTitleAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
ctorArgs = gcnew array<Object^> { "The Application Title" };
attribute = gcnew CustomAttributeBuilder(ctor, ctorArgs);
myAssembly->SetCustomAttribute(attribute);
// The AssemblyCopyrightAttribute sets the Copyright field on
// the Version tab.
//
attributeType = AssemblyCopyrightAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
ctorArgs = gcnew array<Object^> { "� My Example Company 1991-2005" };
attribute = gcnew CustomAttributeBuilder(ctor, ctorArgs);
myAssembly->SetCustomAttribute(attribute);
// The AssemblyDescriptionAttribute sets the Comment item.
//
attributeType = AssemblyDescriptionAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "This is a comment." });
myAssembly->SetCustomAttribute(attribute);
// The AssemblyCompanyAttribute sets the Company item.
//
attributeType = AssemblyCompanyAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "My Example Company" });
myAssembly->SetCustomAttribute(attribute);
// The AssemblyProductAttribute sets the Product Name item.
//
attributeType = AssemblyProductAttribute::typeid;
ctor = attributeType->GetConstructor(ctorParameters);
attribute = gcnew CustomAttributeBuilder(ctor,
gcnew array<Object^> { "My Product Name" });
myAssembly->SetCustomAttribute(attribute);
// Define the assembly's only module. For a single-file assembly,
// the module name is the assembly name.
//
ModuleBuilder^ myModule =
myAssembly->DefineDynamicModule(assemName->Name,
assemName->Name + ".exe");
// No types or methods are created for this example.
// Define the unmanaged version information resource, which
// contains the attribute informaion applied earlier, and save
// the assembly. Use the Windows Explorer to examine the properties
// of the .exe file.
//
myAssembly->DefineVersionInfoResource();
myAssembly->Save(assemName->Name + ".exe");
}
using System;
using System.Reflection;
using System.Reflection.Emit;
class Example
{
public static void Main()
{
AssemblyName assemName = new AssemblyName();
assemName.Name = "EmittedAssembly";
// Create a dynamic assembly in the current application domain,
// specifying that the assembly is to be saved.
//
AssemblyBuilder myAssembly =
AppDomain.CurrentDomain.DefineDynamicAssembly(assemName,
AssemblyBuilderAccess.Save);
// To apply an attribute to a dynamic assembly, first get the
// attribute type. The AssemblyFileVersionAttribute sets the
// File Version field on the Version tab of the Windows file
// properties dialog.
//
Type attributeType = typeof(AssemblyFileVersionAttribute);
// To identify the constructor, use an array of types representing
// the constructor's parameter types. This ctor takes a string.
//
Type[] ctorParameters = { typeof(string) };
// Get the constructor for the attribute.
//
ConstructorInfo ctor = attributeType.GetConstructor(ctorParameters);
// Pass the constructor and an array of arguments (in this case,
// an array containing a single string) to the
// CustomAttributeBuilder constructor.
//
object[] ctorArgs = { "2.0.3033.0" };
CustomAttributeBuilder attribute =
new CustomAttributeBuilder(ctor, ctorArgs);
// Finally, apply the attribute to the assembly.
//
myAssembly.SetCustomAttribute(attribute);
// The pattern described above is used to create and apply
// several more attributes. As it happens, all these attributes
// have a constructor that takes a string, so the same ctorArgs
// variable works for all of them.
// The AssemblyTitleAttribute sets the Description field on
// the General tab and the Version tab of the Windows file
// properties dialog.
//
attributeType = typeof(AssemblyTitleAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
ctorArgs = new object[] { "The Application Title" };
attribute = new CustomAttributeBuilder(ctor, ctorArgs);
myAssembly.SetCustomAttribute(attribute);
// The AssemblyCopyrightAttribute sets the Copyright field on
// the Version tab.
//
attributeType = typeof(AssemblyCopyrightAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
ctorArgs = new object[] { "© My Example Company 1991-2005" };
attribute = new CustomAttributeBuilder(ctor, ctorArgs);
myAssembly.SetCustomAttribute(attribute);
// The AssemblyDescriptionAttribute sets the Comment item.
//
attributeType = typeof(AssemblyDescriptionAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "This is a comment." });
myAssembly.SetCustomAttribute(attribute);
// The AssemblyCompanyAttribute sets the Company item.
//
attributeType = typeof(AssemblyCompanyAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "My Example Company" });
myAssembly.SetCustomAttribute(attribute);
// The AssemblyProductAttribute sets the Product Name item.
//
attributeType = typeof(AssemblyProductAttribute);
ctor = attributeType.GetConstructor(ctorParameters);
attribute = new CustomAttributeBuilder(ctor,
new object[] { "My Product Name" });
myAssembly.SetCustomAttribute(attribute);
// Define the assembly's only module. For a single-file assembly,
// the module name is the assembly name.
//
ModuleBuilder myModule =
myAssembly.DefineDynamicModule(assemName.Name,
assemName.Name + ".exe");
// No types or methods are created for this example.
// Define the unmanaged version information resource, which
// contains the attribute informaion applied earlier, and save
// the assembly. Use the Windows Explorer to examine the properties
// of the .exe file.
//
myAssembly.DefineVersionInfoResource();
myAssembly.Save(assemName.Name + ".exe");
}
}
Imports System.Reflection
Imports System.Reflection.Emit
Module Example
Sub Main()
Dim assemName As New AssemblyName()
assemName.Name = "EmittedAssembly"
' Create a dynamic assembly in the current application domain,
' specifying that the assembly is to be saved.
'
Dim myAssembly As AssemblyBuilder = _
AppDomain.CurrentDomain.DefineDynamicAssembly(assemName, _
AssemblyBuilderAccess.Save)
' To apply an attribute to a dynamic assembly, first get the
' attribute type. The AssemblyFileVersionAttribute sets the
' File Version field on the Version tab of the Windows file
' properties dialog.
'
Dim attributeType As Type = GetType(AssemblyFileVersionAttribute)
' To identify the constructor, use an array of types representing
' the constructor's parameter types. This ctor takes a string.
'
Dim ctorParameters() As Type = { GetType(String) }
' Get the constructor for the attribute.
'
Dim ctor As ConstructorInfo = _
attributeType.GetConstructor(ctorParameters)
' Pass the constructor and an array of arguments (in this case,
' an array containing a single string) to the
' CustomAttributeBuilder constructor.
'
Dim ctorArgs() As Object = { "2.0.3033.0" }
Dim attribute As New CustomAttributeBuilder(ctor, ctorArgs)
' Finally, apply the attribute to the assembly.
'
myAssembly.SetCustomAttribute(attribute)
' The pattern described above is used to create and apply
' several more attributes. As it happens, all these attributes
' have a constructor that takes a string, so the same ctorArgs
' variable works for all of them.
' The AssemblyTitleAttribute sets the Description field on
' the General tab and the Version tab of the Windows file
' properties dialog.
'
attributeType = GetType(AssemblyTitleAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
ctorArgs = New Object() { "The Application Title" }
attribute = New CustomAttributeBuilder(ctor, ctorArgs)
myAssembly.SetCustomAttribute(attribute)
' The AssemblyCopyrightAttribute sets the Copyright field on
' the Version tab.
'
attributeType = GetType(AssemblyCopyrightAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
ctorArgs = New Object() { "© My Example Company 1991-2005" }
attribute = New CustomAttributeBuilder(ctor, ctorArgs)
myAssembly.SetCustomAttribute(attribute)
' The AssemblyDescriptionAttribute sets the Comment item.
'
attributeType = GetType(AssemblyDescriptionAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "This is a comment." })
myAssembly.SetCustomAttribute(attribute)
' The AssemblyCompanyAttribute sets the Company item.
'
attributeType = GetType(AssemblyCompanyAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "My Example Company" })
myAssembly.SetCustomAttribute(attribute)
' The AssemblyProductAttribute sets the Product Name item.
'
attributeType = GetType(AssemblyProductAttribute)
ctor = attributeType.GetConstructor(ctorParameters)
attribute = New CustomAttributeBuilder(ctor, _
New Object() { "My Product Name" })
myAssembly.SetCustomAttribute(attribute)
' Define the assembly's only module. For a single-file assembly,
' the module name is the assembly name.
'
Dim myModule As ModuleBuilder = _
myAssembly.DefineDynamicModule(assemName.Name, _
assemName.Name & ".exe")
' No types or methods are created for this example.
' Define the unmanaged version information resource, which
' contains the attribute informaion applied earlier, and save
' the assembly. Use the Windows Explorer to examine the properties
' of the .exe file.
'
myAssembly.DefineVersionInfoResource()
myAssembly.Save(assemName.Name & ".exe")
End Sub
End Module
Açıklamalar
Bir derleme yalnızca bir yönetilmeyen kaynakla ilişkilendirilebilir. Başka bir DefineVersionInfoResource deyişle, yöntemlerden biri daha önce çağrıldıktan veya DefineUnmanagedResource çağrıldıktan sonra System.ArgumentException'ı oluşturur. Yönetilmeyen birden çok kaynağın Microsoft ResMerge
yardımcı programı (ortak dil çalışma zamanı SDK'sı ile sağlanmaz) gibi bir araçla birleştirilmesi gerekir.
Boş bağımsız değişken dizeleri tek bir boşluk olarak yazılır. Boşluklar, bağımsız değişken dizelerindeki null karakterlerle değiştirilir.
Sürüm kaynağının yapısı, dosyanın sürümünü, dilini ve dağıtımını tanımlayan verileri içerir. Yükleme programları, dosyadan sürüm bilgileri kaynağını almak ve kaynaktan sürüm bilgisi bloklarını ayıklamak için dosya yükleme kitaplığındaki (VER.DLL) işlevleri kullanır.
Not
.NET Framework 2.0 Service Pack 1'den başlayarak, bu üye artık bayrağını ReflectionPermissionFlag.ReflectionEmit gerektirmezReflectionPermission. (Bkz. Yansıma Yaymadaki Güvenlik Sorunları.) Bu işlevselliği kullanmak için uygulamanızın .NET Framework 3.5 veya sonraki bir sürümü hedeflemesi gerekir.