AssemblyBuilder.DefineUnmanagedResource Metódus

Definíció

Névtér:

System.Reflection.Emit

Szerelvény:

mscorlib.dll

Nem felügyelt erőforrást definiál ehhez a szerelvényhez.

Túlterhelések

Name	Description
DefineUnmanagedResource(String)	Egy nem felügyelt erőforrásfájlt határoz meg ehhez a szerelvényhez az erőforrásfájl neve alapján.
DefineUnmanagedResource(Byte[])	A szerelvényhez nem felügyelt erőforrást definiál átlátszatlan bájtblobként.

DefineUnmanagedResource(String)

Egy nem felügyelt erőforrásfájlt határoz meg ehhez a szerelvényhez az erőforrásfájl neve alapján.

public:
 void DefineUnmanagedResource(System::String ^ resourceFileName);

public void DefineUnmanagedResource(string resourceFileName);

member this.DefineUnmanagedResource : string -> unit

Public Sub DefineUnmanagedResource (resourceFileName As String)

Paraméterek

resourceFileName

String

Az erőforrásfájl neve.

Kivételek

ArgumentException

Korábban definiáltak nem felügyelt erőforrást.

-vagy-

A fájl resourceFileName nem olvasható.

-vagy-

resourceFileName az üres sztring ("").

ArgumentNullException

resourceFileName az null.

FileNotFoundException

resourceFileName nem található.

-vagy-

resourceFileName könyvtár.

SecurityException

A hívó nem rendelkezik a szükséges engedéllyel.

Példák

Az alábbi példa egy külső erőforrásfájl átadására DefineUnmanagedResourceirányuló hívást mutat be.

   internal static void Main()
   {
      AssemblyBuilder myAssembly = CreateAssembly("MyEmitTestAssembly");

      // Defines a standalone managed resource for this assembly.
      IResourceWriter myResourceWriter = myAssembly.DefineResource("myResourceFile",
         "A sample Resource File", "MyAssemblyResource.resources",
         ResourceAttributes.Private);

      myResourceWriter.AddResource("AddResource Test", "Testing for the added resource");

      myAssembly.Save(myAssembly.GetName().Name + ".dll");

      // Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource("MyAssemblyResource.resources");
   }

   private static AssemblyBuilder CreateAssembly(string name)
   {
      AssemblyName aName = new AssemblyName(name);
      AssemblyBuilder myAssembly =
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName,
            AssemblyBuilderAccess.Save);

      // Define a dynamic module.
      ModuleBuilder myModule =
         myAssembly.DefineDynamicModule(aName.Name, aName.Name + ".dll");

      // Define a public class named "EmitClass" in the assembly.
      TypeBuilder myEmitClass = myModule.DefineType("EmitClass", TypeAttributes.Public);

      // Define the Display method.
      MethodBuilder myMethod = myEmitClass.DefineMethod("Display",
         MethodAttributes.Public, typeof(String), null);

      // Generate IL for Display method.
      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.Emit(OpCodes.Ldstr, "Display method gets called.");
      methodIL.Emit(OpCodes.Ret);

      myEmitClass.CreateType();

      return(myAssembly);
   }
}

Friend Shared Sub Main()
   Dim myAssembly As AssemblyBuilder = _
       CreateAssembly("MyEmitTestAssembly")
   
   ' Defines a standalone managed resource for this assembly.
   Dim myResourceWriter As IResourceWriter = _
      myAssembly.DefineResource("myResourceFile", _
         "A sample Resource File", "MyAssemblyResource.resources", _
         ResourceAttributes.Private)

   myResourceWriter.AddResource("AddResource Test", "Testing for the added resource")

   myAssembly.Save(myAssembly.GetName().Name & ".dll")
   
   ' Defines an unmanaged resource file for this assembly.
   myAssembly.DefineUnmanagedResource("MyAssemblyResource.resources")

End Sub 

Private Shared Function CreateAssembly(ByVal name As String) As AssemblyBuilder

   Dim aName As New AssemblyName(name)

   Dim myAssembly As AssemblyBuilder = _
      AppDomain.CurrentDomain.DefineDynamicAssembly(aName, _
         AssemblyBuilderAccess.Save)
   
   ' Define a dynamic module.
   Dim myModule As ModuleBuilder = _
      myAssembly.DefineDynamicModule(aName.Name, aName.Name & ".dll")

   ' Define a public class named "EmitClass" in the assembly.
   Dim myEmitClass As TypeBuilder = _
      myModule.DefineType("EmitClass", TypeAttributes.Public)
   
   ' Define the Display method.
   Dim myMethod As MethodBuilder = _
      myEmitClass.DefineMethod("Display", MethodAttributes.Public, _
                                             GetType(String), Nothing)
   
   ' Generate IL for Display method.
   Dim methodIL As ILGenerator = myMethod.GetILGenerator()
   methodIL.Emit(OpCodes.Ldstr, "Display method get called.")
   methodIL.Emit(OpCodes.Ret)
   
   myEmitClass.CreateType()

   Return myAssembly

End Function

Megjegyzések

Egy szerelvény csak egy nem felügyelt erőforráshoz társítható. Ez azt jelenti, hogy a korábban meghívott metódusok egyikének meghívása DefineVersionInfoResource vagy DefineUnmanagedResource után a System.ArgumentException lesz a cél. Több nem felügyelt erőforrást kell egyesíteni egy olyan eszközzel, mint például a Microsoft ResMerge segédprogram (a közös nyelvi futtatókörnyezet nem érhető el).

DefineUnmanagedResource(Byte[])

A szerelvényhez nem felügyelt erőforrást definiál átlátszatlan bájtblobként.

public:
 void DefineUnmanagedResource(cli::array <System::Byte> ^ resource);

public void DefineUnmanagedResource(byte[] resource);

member this.DefineUnmanagedResource : byte[] -> unit

Public Sub DefineUnmanagedResource (resource As Byte())

Paraméterek

resource

Byte[]

A nem felügyelt erőforrást képviselő átlátszatlan bájtblob.

Kivételek

ArgumentException

Korábban definiáltak nem felügyelt erőforrást.

ArgumentNullException

resource az null.

SecurityException

A hívó nem rendelkezik a szükséges engedéllyel.

Példák

Az alábbi kódminta létrehoz és csatol egy nem felügyelt erőforrást képviselő bájttömböt egy dinamikus szerelvényhez a használatával DefineUnmanagedResource.

using System;
using System.Threading;
using System.Reflection;
using System.Reflection.Emit;
using System.Resources;

public class MyAssemblyResource
{
   internal static void Main()
   {
      AssemblyBuilder myAssembly = CreateAssembly("MyEmitTestAssembly");

      // Defines a standalone managed resource for this assembly.
      IResourceWriter myResourceWriter = myAssembly.DefineResource("myResourceFile",
         "A sample Resource File", "MyAssemblyResource.resources",
         ResourceAttributes.Private);

      myResourceWriter.AddResource("AddResource Test", "Testing for the added resource");

      myAssembly.Save(myAssembly.GetName().Name + ".dll");

      // Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource(new byte[]{01, 00, 01});
   }

   private static AssemblyBuilder CreateAssembly(string name)
   {
      AssemblyName aName = new AssemblyName(name);
      AssemblyBuilder myAssembly =
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName,
            AssemblyBuilderAccess.Save);

      // Define a dynamic module.
      ModuleBuilder myModule =
         myAssembly.DefineDynamicModule(aName.Name, aName.Name + ".dll");

      // Define a public class named "EmitClass" in the assembly.
      TypeBuilder myEmitClass = myModule.DefineType("EmitClass", TypeAttributes.Public);

      // Define the Display method.
      MethodBuilder myMethod = myEmitClass.DefineMethod("Display",
         MethodAttributes.Public, typeof(String), null);

      // Generate IL for Display method.
      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.Emit(OpCodes.Ldstr, "Display method gets called.");
      methodIL.Emit(OpCodes.Ret);

      myEmitClass.CreateType();

      return(myAssembly);
   }
}

Imports System.Threading
Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Resources

Public Class MyAssemblyResource
   
   Friend Shared Sub Main()
      Dim myAssembly As AssemblyBuilder = _
          CreateAssembly("MyEmitTestAssembly")
      
      ' Defines a standalone managed resource for this assembly.
      Dim myResourceWriter As IResourceWriter = _
         myAssembly.DefineResource("myResourceFile", _
            "A sample Resource File", "MyAssemblyResource.resources", _
            ResourceAttributes.Private)

      myResourceWriter.AddResource("AddResource Test", "Testing for the added resource")

      myAssembly.Save(myAssembly.GetName().Name & ".dll")
      
      ' Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource(New Byte() {1, 0, 1})

   End Sub 
   
   Private Shared Function CreateAssembly(ByVal name As String) As AssemblyBuilder

      Dim aName As New AssemblyName(name)

      Dim myAssembly As AssemblyBuilder = _
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName, _
            AssemblyBuilderAccess.Save)
      
      ' Define a dynamic module.
      Dim myModule As ModuleBuilder = _
         myAssembly.DefineDynamicModule(aName.Name, aName.Name & ".dll")

      ' Define a public class named "EmitClass" in the assembly.
      Dim myEmitClass As TypeBuilder = _
         myModule.DefineType("EmitClass", TypeAttributes.Public)
      
      ' Define the Display method.
      Dim myMethod As MethodBuilder = _
         myEmitClass.DefineMethod("Display", MethodAttributes.Public, _
                                                GetType(String), Nothing)
      
      ' Generate IL for Display method.
      Dim methodIL As ILGenerator = myMethod.GetILGenerator()
      methodIL.Emit(OpCodes.Ldstr, "Display method get called.")
      methodIL.Emit(OpCodes.Ret)
      
      myEmitClass.CreateType()

      Return myAssembly

   End Function 
End Class

Megjegyzések

Egy szerelvény csak egy nem felügyelt erőforráshoz társítható. Ez azt jelenti, hogy a korábban meghívott metódusok egyikének meghívása DefineVersionInfoResource vagy DefineUnmanagedResource után a System.ArgumentException dobása történik. Több nem felügyelt erőforrást kell egyesíteni egy olyan eszközzel, mint például a Microsoft ResMerge segédprogram (a közös nyelvi futtatókörnyezet nem érhető el).