AssemblyBuilder

AssemblyBuilder

---

System.Reflection.Emit (mscorlib.dll)

sealed class

This class represents a dynamic assembly. A dynamic assembly is the root container for all the builder objects in the System.Reflection.Emit namespace. You can create an AssemblyBuilder object by using the DefineDynamicAssembly( ) method of the System.AppDomain class. When you create a dynamic assembly, specify a name and the access mode, using the AssemblyBuilderAccess enumeration. If you plan to save the assembly to disk using the the Save( ) method, be sure to specify AssemblyBuilderAccess.Save or AssemblyBuilderAccess.RunAndSave .

A dynamic assembly can contain one or more modules, which are defined by ModuleBuilder objects. Use the DefineDynamicModule( ) method to define, create, and return a ModuleBuilder object, as in ModuleBuilder myModB = myAssemblyB.DefineDynamicModule("ModuleName"); . By default, this is a transient module that cannot be saved, regardless of the AssemblyBuilderAccess specified. To create a module that can be saved to disk, use a version of the overloaded DefineDynamicModule( ) that requires a fileName argument. You can also use other methods to add an attribute to the assembly, add or create managed and unmanaged resources, and retrieve a System.IO.FileStream object for any of the files in the assembly.

When you are finished creating an assembly and all its members , you can use the Save( ) method. This method takes a simple filename as a parameter, which can't include directory or drive information. To use a different directory or drive, you must specify the path when you create the dynamic assembly by using the appropriate constructor. When you save a dynamic assembly, all nontransient modules are saved using the filename specified when you created them. By default, the assembly is saved as a DLL file (as if you had used the /target:library command-line compiler switch). To change this, use the SetEntryPoint( ) method to specify the assembly's startup method and to specify PEFileKinds .

 public sealed class  AssemblyBuilder  : System.Reflection.Assembly {  // Public Instance Properties  public override string  CodeBase  {get; }  // overrides System.Reflection.Assembly  public override MethodInfo  EntryPoint  {get; }  // overrides System.Reflection.Assembly  public override string  ImageRuntimeVersion  {get; }  // overrides System.Reflection.Assembly  public override string  Location  {get; }  // overrides System.Reflection.Assembly   // Public Instance Methods  public void  AddResourceFile  (string   name   , string   fileName   );    public void  AddResourceFile  (string   name   , string   fileName   , System.Reflection.ResourceAttributes   attribute   );    public ModuleBuilder  DefineDynamicModule  (string   name   );    public ModuleBuilder  DefineDynamicModule  (string   name   , bool   emitSymbolInfo   );    public ModuleBuilder  DefineDynamicModule  (string   name   , string   fileName   );    public ModuleBuilder  DefineDynamicModule  (string   name   , string   fileName   , bool   emitSymbolInfo   );    public IResourceWriter  DefineResource  (string   name   , string   description   , string   fileName   );    public IResourceWriter  DefineResource  (string   name   , string   description   , string   fileName   ,        System.Reflection.ResourceAttributes   attribute   );    public void  DefineUnmanagedResource  (byte[ ]   resource   );    public void  DefineUnmanagedResource  (string   resourceFileName   );    public void  DefineVersionInfoResource  ( );    public void  DefineVersionInfoResource  (string   product   , string   productVersion   , string   company   ,        string   copyright   , string   trademark   );    public ModuleBuilder  GetDynamicModule  (string   name   );    public override Type[ ]  GetExportedTypes  ( );  // overrides System.Reflection.Assembly  public override FileStream  GetFile  (string   name   );  // overrides System.Reflection.Assembly  public override FileStream[ ]  GetFiles  (bool   getResourceModules   )  // overrides System.Reflection.Assembly  public override ManifestResourceInfo  GetManifestResourceInfo  (string   resourceName   )  // overrides System.Reflection.Assembly  public override string[ ]  GetManifestResourceNames  ( );  // overrides System.Reflection.Assembly  public override Stream  GetManifestResourceStream  (string   name   )  // overrides System.Reflection.Assembly  public override Stream  GetManifestResourceStream  (Type   type   , string   name   );  // overrides System.Reflection.Assembly  public void  Save  (string   assemblyFileName   );    public void  SetCustomAttribute  (System.Reflection.ConstructorInfo   con   , byte[ ]   binaryAttribute   );    public void  SetCustomAttribute  (CustomAttributeBuilder   customBuilder   );    public void  SetEntryPoint  (System.Reflection.MethodInfo   entryMethod   );    public void  SetEntryPoint  (System.Reflection.MethodInfo   entryMethod   , PEFileKinds   fileKind   ); } 

Hierarchy

System.Object System.Reflection.Assembly(System.Security.IEvidenceFactory , System.Reflection.ICustomAttributeProvider , System.Runtime.Serialization.ISerializable) AssemblyBuilder

Returned By

System.AppDomain.DefineDynamicAssembly( )