AssemblyBuilder.DefineVersionInfoResource Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define un recurso de información de versión no administrado para este ensamblado.
Sobrecargas
| DefineVersionInfoResource() |
Define un recurso de información de versión sin administrar mediante la información especificada en el objeto AssemblyName del ensamblado y los atributos personalizados del ensamblado. |
| DefineVersionInfoResource(String, String, String, String, String) |
Define un recurso de información de versión no administrado para este ensamblado con las especificaciones dadas. |
DefineVersionInfoResource()
Define un recurso de información de versión sin administrar mediante la información especificada en el objeto AssemblyName del ensamblado y los atributos personalizados del ensamblado.
public:
void DefineVersionInfoResource();public void DefineVersionInfoResource ();member this.DefineVersionInfoResource : unit -> unitPublic Sub DefineVersionInfoResource ()Excepciones
Se ha definido previamente un recurso de información de versión no administrado.
o bien
La información de versión sin administrar es demasiado grande para que se pueda almacenar.
El llamador no dispone del permiso requerido.
Ejemplos
En el ejemplo siguiente se muestra el uso de 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
Comentarios
Un ensamblado solo se puede asociar a un recurso no administrado. Esto significa que llamar a DefineVersionInfoResource o DefineUnmanagedResource después de llamar a uno de los métodos anteriormente producirá system.ArgumentException. Es necesario combinar varios recursos no administrados con una herramienta como la utilidad Microsoft ResMerge (no proporcionada con el SDK de Common Language Runtime).
Las cadenas de argumento vacías se escriben como un solo espacio. Los espacios se sustituyen por caracteres NULL en las cadenas de argumentos.
La información se deduce del AssemblyName objeto utilizado para definir este ensamblado dinámico. Los atributos personalizados de este ensamblado invalidan la información especificada en el AssemblyName objeto .
Nota:
A partir de .NET Framework 2.0 Service Pack 1, este miembro ya no requiere ReflectionPermission con la ReflectionPermissionFlag.ReflectionEmit marca . (Consulte Problemas de seguridad en la emisión de reflexión). Para usar esta funcionalidad, la aplicación debe tener como destino .NET Framework 3.5 o posterior.
Se aplica a
DefineVersionInfoResource(String, String, String, String, String)
Define un recurso de información de versión no administrado para este ensamblado con las especificaciones dadas.
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 -> unitPublic Sub DefineVersionInfoResource (product As String, productVersion As String, company As String, copyright As String, trademark As String)Parámetros
- product
- String
El nombre del producto con el que se distribuye este ensamblado.
- productVersion
- String
La versión del producto con el que se distribuye este ensamblado.
- company
- String
El nombre de la compañía que produjo este ensamblado.
- copyright
- String
Describe todos los avisos de propiedad intelectual, marcas comerciales y marcas registradas que se aplican a este ensamblado. Esto debe incluir el texto completo de todos los avisos, símbolos legales, fechas de copyright, números de marcas comerciales, etc. En inglés, esta cadena debe tener el formato "Copyright Microsoft Corp. 1990-2001".
- trademark
- String
Describe todas las marcas comerciales y marcas comerciales registradas que se aplican a este ensamblado. Esto debe incluir el texto completo de todos los avisos, símbolos legales, números de marcas comerciales, etc. En inglés, esta cadena debe tener el formato "Windows es una marca comercial de Microsoft Corporation".
Excepciones
Se ha definido previamente un recurso de información de versión no administrado.
o bien
La información de versión sin administrar es demasiado grande para que se pueda almacenar.
El llamador no dispone del permiso requerido.
Ejemplos
En el ejemplo siguiente se muestra el uso de 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
Comentarios
Un ensamblado solo se puede asociar a un recurso no administrado. Esto significa que llamar a DefineVersionInfoResource o DefineUnmanagedResource después de llamar a uno de los métodos anteriormente producirá system.ArgumentException. Es necesario combinar varios recursos no administrados con una herramienta como la utilidad de Microsoft ResMerge (no proporcionada con el SDK de Common Language Runtime).
Las cadenas de argumento vacías se escriben como un solo espacio. Los espacios se sustituyen por caracteres NULL en las cadenas de argumentos.
La estructura del recurso de versión incluye datos que identifican la versión, el idioma y la distribución del archivo. Los programas de instalación usan las funciones de la biblioteca de instalación de archivos (VER.DLL) para recuperar el recurso de información de versión de un archivo y extraer los bloques de información de versión del recurso.
Nota:
A partir de .NET Framework 2.0 Service Pack 1, este miembro ya no requiere ReflectionPermission con la ReflectionPermissionFlag.ReflectionEmit marca . (Consulte Problemas de seguridad en la emisión de reflexión). Para usar esta funcionalidad, la aplicación debe tener como destino .NET Framework 3.5 o posterior.
Se aplica a
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de