AssemblyTitleAttribute Class
.NET Framework 2.0
Defines an assembly title custom attribute for an assembly manifest.
Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)
Assembly: mscorlib (in mscorlib.dll)
'Declaration <ComVisibleAttribute(True)> _ <AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False)> _ Public NotInheritable Class AssemblyTitleAttribute Inherits Attribute 'Usage Dim instance As AssemblyTitleAttribute
/** @attribute ComVisibleAttribute(true) */ /** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false) */ public final class AssemblyTitleAttribute extends Attribute
ComVisibleAttribute(true) AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false) public final class AssemblyTitleAttribute extends Attribute
Imports System 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
import System.*;
import System.Threading.*;
import System.Reflection.*;
import System.Reflection.Emit.*;
import System.Resources.*;
public class MyEmitTest
{
public static void main(String[] args)
{
AssemblyBuilder myAssembly = (AssemblyBuilder)(CreateAssembly(
System.Threading.Thread.GetDomain()).get_Assembly());
IResourceWriter myResourceWriter =
myAssembly.DefineResource("myResourceFile",
"A sample Resource File", "MyResourceFile.resources");
myResourceWriter.AddResource("AddResource test", "Test resource added");
// Define unmanaged version information resources.
myAssembly.DefineVersionInfoResource();
myAssembly.Save("MyEmittedAssembly.dll");
} //main
// Create the callee transient dynamic assembly.
private static Type CreateAssembly(AppDomain myDomain)
{
AssemblyName myAssemblyName = new AssemblyName();
myAssemblyName.set_Name("MyEmittedAssembly");
AssemblyBuilder myAssembly = myDomain.DefineDynamicAssembly(
myAssemblyName, AssemblyBuilderAccess.Save);
// Set Company Attribute to the assembly.
Type companyAttribute = AssemblyCompanyAttribute.class.ToType();
ConstructorInfo myConstructorInfo1 = companyAttribute.GetConstructor(
new Type[]{String.class.ToType()});
CustomAttributeBuilder attributeBuilder1 =
new CustomAttributeBuilder(myConstructorInfo1,
new Object[]{"Microsoft Corporation"});
myAssembly.SetCustomAttribute(attributeBuilder1);
// Set Copyright Attribute to the assembly.
Type copyrightAttribute = AssemblyCopyrightAttribute.class.ToType();
ConstructorInfo myConstructorInfo2 = copyrightAttribute.GetConstructor(
new Type[]{String.class.ToType()});
CustomAttributeBuilder attributeBuilder2 =
new CustomAttributeBuilder(myConstructorInfo2,
new Object[]{"@Copyright Microsoft Corp. 1990-2001"});
myAssembly.SetCustomAttribute(attributeBuilder2);
ModuleBuilder myModule = myAssembly.DefineDynamicModule("EmittedModule",
"EmittedModule.mod");
// Define a public class named "HelloWorld" in the assembly.
TypeBuilder helloWorldClass = myModule.DefineType("HelloWorld",
TypeAttributes.Public);
// Define the Display method.
MethodBuilder myMethod = helloWorldClass.DefineMethod("Display",
MethodAttributes.Public, String.class.ToType(), null);
// 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();
} //CreateAssembly
} //MyEmitTest
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Community Additions
ADD
Show: