ModuleBuilder.DefineResource Methode

Definitie

Naamruimte:
System.Reflection.Emit
Assembly:
mscorlib.dll

Definieert een beheerde ingesloten resource die in deze module moet worden opgeslagen.

Overloads

Name Description
DefineResource(String, String)

Definieert de benoemde beheerde ingesloten resource die in deze module moet worden opgeslagen.
DefineResource(String, String, ResourceAttributes)

Definieert de benoemde beheerde ingesloten resource met de opgegeven kenmerken die in deze module moeten worden opgeslagen.

DefineResource(String, String)

Definieert de benoemde beheerde ingesloten resource die in deze module moet worden opgeslagen.

public:
 System::Resources::IResourceWriter ^ DefineResource(System::String ^ name, System::String ^ description);
public System.Resources.IResourceWriter DefineResource(string name, string description);
member this.DefineResource : string * string -> System.Resources.IResourceWriter
Public Function DefineResource (name As String, description As String) As IResourceWriter

Parameters

name
String

De naam van de resource. name kan geen ingesloten null-waarden bevatten.

description
String

De beschrijving van de resource.

Retouren

IResourceWriter

Een resourceschrijver voor de gedefinieerde resource.

Uitzonderingen

ArgumentException

De lengte is name nul.

ArgumentNullException

name is nul.

InvalidOperationException

Deze module is tijdelijk.

– of –

De bevatde assembly kan niet worden bewaard.

Voorbeelden

Het volgende voorbeeld illustreert het gebruik van het toevoegen van DefineResource een externe resource aan de huidige ModuleBuilder.

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

   public class CodeGenerator
   {
      public CodeGenerator()
      {
         // Get the current application domain for the current thread.
         AppDomain currentDomain = AppDomain.CurrentDomain;

         AssemblyName myAssemblyName = new AssemblyName();
         myAssemblyName.Name = "TempAssembly";

         // Define 'TempAssembly' assembly in the current application domain.
         AssemblyBuilder myAssemblyBuilder =
            currentDomain.DefineDynamicAssembly
                        (myAssemblyName, AssemblyBuilderAccess.RunAndSave);
         // Define 'TempModule' module in 'TempAssembly' assembly.
         ModuleBuilder myModuleBuilder =
            myAssemblyBuilder.DefineDynamicModule("TempModule",
                                       "TempModule.netmodule",true);
         // Define the managed embedded resource, 'MyResource' in 'TempModule'.
         IResourceWriter myResourceWriter =
               myModuleBuilder.DefineResource("MyResource.resource","Description");
         // Add resources to the resource writer.
         myResourceWriter.AddResource("String 1", "First String");
         myResourceWriter.AddResource("String 2", "Second String");
         myResourceWriter.AddResource("String 3", "Third String");
         myAssemblyBuilder.Save("MyAssembly.dll");
      }
   }

   public class CallerClass
   {
      public static void Main()
      {
         CodeGenerator myGenerator = new CodeGenerator();
         Console.WriteLine("A resource named 'MyResource.resource'"
                +" has been created and can be viewed  in the 'MyAssembly.dll'");
      }
   }

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

Public Class CodeGenerator
   
   Public Sub New()
      ' Get the current application domain for the current thread.
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain

      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "TempAssembly"
      
      ' Define 'TempAssembly' assembly in the current application domain.
      Dim myAssemblyBuilder As AssemblyBuilder = currentDomain.DefineDynamicAssembly _
                                       (myAssemblyName, AssemblyBuilderAccess.RunAndSave)
      ' Define 'TempModule' module in 'TempAssembly' assembly.
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.DefineDynamicModule _
                                             ("TempModule", "TempModule.netmodule", True)
      ' Define the managed embedded resource, 'MyResource' in 'TempModule'.
      Dim myResourceWriter As IResourceWriter = myModuleBuilder.DefineResource _
                                                   ("MyResource.resource", "Description")
      ' Add resources to the resource writer.
      myResourceWriter.AddResource("String 1", "First String")
      myResourceWriter.AddResource("String 2", "Second String")
      myResourceWriter.AddResource("String 3", "Third String")
      myAssemblyBuilder.Save("MyAssembly.dll")

   End Sub
End Class

Public Class CallerClass
   
   Public Shared Sub Main()
      Dim myGenerator As New CodeGenerator()
      Console.WriteLine("A resource named 'MyResource.resource' has been created and can be" + _
                                                               " viewed  in the 'MyAssembly.dll'")
   End Sub
End Class

Opmerkingen

De aanroeper mag de ResourceWriter.Generate() en ResourceWriter.Close() methoden niet aanroepen, omdat deze methoden worden aangeroepen ModuleBuilder.Save wanneer de dynamische assembly naar de schijf wordt geschreven.

Gebruik deze methode om een beheerde resource in te sluiten. Als u een manifestresource-blob wilt insluiten, gebruikt u de DefineManifestResource methode. Zie de DefineManifestResource methode voor een overzicht van het insluiten en koppelen van beheerde resources en manifestresource-blobs.

Zie ook

Van toepassing op

DefineResource(String, String, ResourceAttributes)

Definieert de benoemde beheerde ingesloten resource met de opgegeven kenmerken die in deze module moeten worden opgeslagen.

public:
 System::Resources::IResourceWriter ^ DefineResource(System::String ^ name, System::String ^ description, System::Reflection::ResourceAttributes attribute);
public System.Resources.IResourceWriter DefineResource(string name, string description, System.Reflection.ResourceAttributes attribute);
member this.DefineResource : string * string * System.Reflection.ResourceAttributes -> System.Resources.IResourceWriter
Public Function DefineResource (name As String, description As String, attribute As ResourceAttributes) As IResourceWriter

Parameters

name
String

De naam van de resource. name kan geen ingesloten null-waarden bevatten.

description
String

De beschrijving van de resource.

attribute
ResourceAttributes

De resourcekenmerken.

Retouren

IResourceWriter

Een resourceschrijver voor de gedefinieerde resource.

Uitzonderingen

ArgumentException

De lengte is name nul.

ArgumentNullException

name is nul.

InvalidOperationException

Deze module is tijdelijk.

– of –

De bevatde assembly kan niet worden bewaard.

Voorbeelden

In het volgende voorbeeld ziet u het gebruik van DefineResource om een externe resource toe te voegen aan de huidige ModuleBuilder.

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

   public class CodeGenerator
   {
      public CodeGenerator()
      {
         // Get the current application domain for the current thread.
         AppDomain currentDomain = AppDomain.CurrentDomain;

         AssemblyName myAssemblyName = new AssemblyName();
         myAssemblyName.Name = "TempAssembly";

         // Define 'TempAssembly' assembly in the current application domain.
         AssemblyBuilder myAssemblyBuilder =
            currentDomain.DefineDynamicAssembly
                        (myAssemblyName, AssemblyBuilderAccess.RunAndSave);
         // Define 'TempModule' module in 'TempAssembly' assembly.
         ModuleBuilder myModuleBuilder =
            myAssemblyBuilder.DefineDynamicModule("TempModule",
                                              "TempModule.netmodule",true);
         // Define the managed embedded resource, 'MyResource' in 'TempModule'
         // with the specified attribute.
         IResourceWriter writer =
               myModuleBuilder.DefineResource("MyResource.resource",
                            "Description",ResourceAttributes.Public);
         // Add resources to the resource writer.
         writer.AddResource("String 1", "First String");
         writer.AddResource("String 2", "Second String");
         writer.AddResource("String 3", "Third String");
         myAssemblyBuilder.Save("MyAssembly.dll");
      }
   }

   public class CallerClass
   {
      public static void Main()
      {
         CodeGenerator myGenerator = new CodeGenerator();
         Console.WriteLine("A resource named 'MyResource.resource'"
                +" has been created and can be viewed  in the 'MyAssembly.dll'");
      }
   }

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

Public Class CodeGenerator
   
   Public Sub New()
      ' Get the current application domain for the current thread.
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain

      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "TempAssembly"
      
      ' Define 'TempAssembly' assembly in the current application domain.
      Dim myAssemblyBuilder As AssemblyBuilder = currentDomain.DefineDynamicAssembly _
                                          (myAssemblyName, AssemblyBuilderAccess.RunAndSave)
      ' Define 'TempModule' module in 'TempAssembly' assembly.
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.DefineDynamicModule _
                                                ("TempModule", "TempModule.netmodule", True)
      ' Define the managed embedded resource, 'MyResource' in 'TempModule'
      ' with the specified attribute.
      Dim writer As IResourceWriter = myModuleBuilder.DefineResource _
                              ("MyResource.resource", "Description", ResourceAttributes.Public)
      ' Add resources to the resource writer.
      writer.AddResource("String 1", "First String")
      writer.AddResource("String 2", "Second String")
      writer.AddResource("String 3", "Third String")
      myAssemblyBuilder.Save("MyAssembly.dll")

   End Sub
End Class

Public Class CallerClass
   
   Public Shared Sub Main()
      Dim myGenerator As New CodeGenerator()
      Console.WriteLine("A resource named 'MyResource.resource' has been created and can be " + _
                                                         "viewed  in the 'MyAssembly.dll'")
   End Sub
End Class

Opmerkingen

De aanroeper mag de ResourceWriter.Generate() en ResourceWriter.Close() methoden niet aanroepen, omdat deze methoden worden aangeroepen ModuleBuilder.Save wanneer de dynamische assembly naar de schijf wordt geschreven.

Gebruik deze methode om een beheerde resource in te sluiten. Als u een manifestresource-blob wilt insluiten, gebruikt u de DefineManifestResource methode. Zie de DefineManifestResource methode voor een overzicht van het insluiten en koppelen van beheerde resources en manifestresource-blobs.

Zie ook

Van toepassing op