ModuleBuilder.DefineResource Método

Definição

Espaço de Nomes:: System.Reflection.Emit

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Define um recurso embedded gerido a ser armazenado neste módulo.

Sobrecargas

Name	Description
DefineResource(String, String)	Define o recurso embebido gerido nomeado a ser armazenado neste módulo.
DefineResource(String, String, ResourceAttributes)	Define o recurso embutido gerido nomeado com os atributos dados que deve ser armazenado neste módulo.

DefineResource(String, String)

Define o recurso embebido gerido nomeado a ser armazenado neste módulo.

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

Parâmetros

name: String

O nome do recurso. name não pode conter nulos embutidos.

description: String

A descrição do recurso.

Devoluções

IResourceWriter

Um escritor de recursos para o recurso definido.

Exceções

ArgumentException

O comprimento de name é zero.

ArgumentNullException

name é null.

InvalidOperationException

Este módulo é transitório.

-ou-

O conjunto que contém não é persistente.

Exemplos

O exemplo seguinte ilustra a utilização de DefineResource para adicionar um recurso externo à corrente 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

Observações

O chamador não deve chamar os ResourceWriter.Generate() métodos e, ResourceWriter.Close() porque estes métodos são chamados por ModuleBuilder.Save quando o conjunto dinâmico é escrito no disco.

Use este método para incorporar um recurso gerido. Para incorporar um blob de recurso manifesto, use o DefineManifestResource método. Para um resumo da incorporação e ligação de recursos geridos e blobs de recursos manifestos, consulte o DefineManifestResource método.

Ver também

DefineManifestResource(String, Stream, ResourceAttributes)

Aplica-se a

DefineResource(String, String, ResourceAttributes)

Define o recurso embutido gerido nomeado com os atributos dados que deve ser armazenado neste módulo.

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