AssemblyBuilder.DefineResource Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Reflection.Emit

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce una risorsa gestita autonoma per questo assembly.

Overload

DefineResource(String, String, String)	Definisce una risorsa gestita autonoma per questo assembly con l'attributo di risorsa pubblica predefinito.
DefineResource(String, String, String, ResourceAttributes)	Definisce una risorsa gestita autonoma per questo assembly. È possibile specificare gli attributi per la risorsa gestita.

DefineResource(String, String, String)

Definisce una risorsa gestita autonoma per questo assembly con l'attributo di risorsa pubblica predefinito.

public:
 System::Resources::IResourceWriter ^ DefineResource(System::String ^ name, System::String ^ description, System::String ^ fileName);

public System.Resources.IResourceWriter DefineResource (string name, string description, string fileName);

member this.DefineResource : string * string * string -> System.Resources.IResourceWriter

Public Function DefineResource (name As String, description As String, fileName As String) As IResourceWriter

Parametri

name: String

Nome logico della risorsa.

description: String

Descrizione testuale della risorsa.

fileName: String

Nome fisico del file (file con estensione resources) a cui è mappato il nome logico. Non deve includere un percorso.

Restituisce

IResourceWriter

Oggetto ResourceWriter per la risorsa specificata.

Eccezioni

ArgumentException

L'oggetto name è stato definito in precedenza.

-oppure-

C'è un altro file nell'assembly denominato fileName.

-oppure-

La lunghezza di name è zero.

-oppure-

La lunghezza di fileName è zero.

-oppure-

fileName include un percorso.

ArgumentNullException

name o fileName è null.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio seguente viene usato il DefineResource metodo per ottenere un writer di risorse. Nell'esempio viene usato il writer di risorse per aggiungere tre stringhe di risorse.

using namespace System;
using namespace System::Threading;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
using namespace System::Resources;

/*
   The following program demonstrates the 'DefineResource' and 'DefineVersionInfoResource' 
   methods of 'AssemblyBuilder' class. It builds an assembly and a resource file at runtime.
   The unmanaged version information like product, product version, Company, Copyright, 
   trademark are defined with 'DefineVersionInfoResource' method.
*/
static Type^ CreateAssembly( AppDomain^ appDomain );

int main()
{
   AssemblyBuilder^ myAssembly;
   IResourceWriter^ myResourceWriter;
   myAssembly = safe_cast<AssemblyBuilder^>(CreateAssembly( Thread::GetDomain() )->Assembly);
   myResourceWriter = myAssembly->DefineResource( "myResourceFile", "A sample Resource File", "MyEmitAssembly.MyResource.resources" );
   myResourceWriter->AddResource( "AddResource 1", "First added resource" );
   myResourceWriter->AddResource( "AddResource 2", "Second added resource" );
   myResourceWriter->AddResource( "AddResource 3", "Third added resource" );
   myAssembly->DefineVersionInfoResource( "AssemblySample",  "2:0:0:1", "Microsoft Corporation", "@Copyright Microsoft Corp. 1990-2001", ".NET is a trademark of Microsoft Corporation" );
   myAssembly->Save( "MyEmitAssembly.dll" );
}

// Create the callee transient dynamic assembly.
static Type^ CreateAssembly( AppDomain^ appDomain )
{
   AssemblyName^ myAssemblyName = gcnew AssemblyName;
   myAssemblyName->Name = "MyEmitAssembly";
   AssemblyBuilder^ myAssembly = appDomain->DefineDynamicAssembly( myAssemblyName, AssemblyBuilderAccess::Save );
   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::typeid, nullptr );

   // 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());
}

public static void Main()
{
   AssemblyBuilder myAssembly;
   IResourceWriter myResourceWriter;
   myAssembly = (AssemblyBuilder)CreateAssembly(Thread.GetDomain()).Assembly;

   myResourceWriter = myAssembly.DefineResource("myResourceFile",
      "A sample Resource File", "MyEmitAssembly.MyResource.resources");
   myResourceWriter.AddResource("AddResource 1", "First added resource");
   myResourceWriter.AddResource("AddResource 2", "Second added resource");
   myResourceWriter.AddResource("AddResource 3", "Third added resource");

   myAssembly.DefineVersionInfoResource("AssemblySample", "2:0:0:1",
      "Microsoft Corporation", "@Copyright Microsoft Corp. 1990-2001",
      ".NET is a trademark of Microsoft Corporation");
   myAssembly.Save("MyEmitAssembly.dll");
}

// Create the callee transient dynamic assembly.
private static Type CreateAssembly(AppDomain appDomain)
{
   AssemblyName myAssemblyName = new AssemblyName();
   myAssemblyName.Name = "MyEmitAssembly";
   AssemblyBuilder myAssembly = appDomain.DefineDynamicAssembly(myAssemblyName,
      AssemblyBuilderAccess.Save);
   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, typeof(String), 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());
}

Public Shared Sub Main()
   Dim myAssembly As AssemblyBuilder
   Dim myResourceWriter As IResourceWriter
   myAssembly = CType(CreateAssembly(Thread.GetDomain()).Assembly, AssemblyBuilder)
   
   myResourceWriter = myAssembly.DefineResource("myResourceFile", "A sample Resource File", _
                                                      "MyEmitAssembly.MyResource.resources")
   myResourceWriter.AddResource("AddResource 1", "First added resource")
   myResourceWriter.AddResource("AddResource 2", "Second added resource")
   myResourceWriter.AddResource("AddResource 3", "Third added resource")
   
   myAssembly.DefineVersionInfoResource("AssemblySample", "2:0:0:1", "Microsoft Corporation", _
         "@Copyright Microsoft Corp. 1990-2001", ".NET is a trademark of Microsoft Corporation")
   myAssembly.Save("MyEmitAssembly.dll")
End Sub

' Create the callee transient dynamic assembly.
Private Shared Function CreateAssembly(myAppDomain As AppDomain) As Type
   Dim myAssemblyName As New AssemblyName()
   myAssemblyName.Name = "MyEmitAssembly"
   Dim myAssembly As AssemblyBuilder = myAppDomain.DefineDynamicAssembly(myAssemblyName, _
                                                            AssemblyBuilderAccess.Save)
   Dim myModule As ModuleBuilder = myAssembly.DefineDynamicModule("EmittedModule", _
                                                            "EmittedModule.mod")
   
   ' Define a public class named "HelloWorld" in the assembly.
   Dim helloWorldClass As TypeBuilder = myModule.DefineType("HelloWorld", TypeAttributes.Public)
   ' Define the Display method.
   Dim myMethod As MethodBuilder = helloWorldClass.DefineMethod("Display", _
                                 MethodAttributes.Public, GetType(String), Nothing)
   
   ' Generate IL for GetGreeting.
   Dim methodIL As ILGenerator = myMethod.GetILGenerator()
   methodIL.Emit(OpCodes.Ldstr, "Display method get called.")
   methodIL.Emit(OpCodes.Ret)
   ' Returns the type HelloWorld.
   Return helloWorldClass.CreateType()
End Function 'CreateAssembly

Commenti

È possibile aggiungere risorse granulari con l'oggetto restituito ResourceWriter chiamando AddResource.

fileName non deve corrispondere a quello di qualsiasi altro modulo persistente, risorsa gestita autonoma o file manifesto autonomo.

Il runtime chiama il Close metodo quando viene salvato l'assembly dinamico.

Nota

A partire da .NET Framework 2.0 Service Pack 1, questo membro non richiede ReflectionPermission più con il ReflectionPermissionFlag.ReflectionEmit flag . Vedere Problemi di sicurezza in Reflection Emit. Per usare questa funzionalità, l'applicazione deve avere come destinazione .NET Framework 3.5 o versione successiva.

Si applica a

DefineResource(String, String, String, ResourceAttributes)

Definisce una risorsa gestita autonoma per questo assembly. È possibile specificare gli attributi per la risorsa gestita.

public:
 System::Resources::IResourceWriter ^ DefineResource(System::String ^ name, System::String ^ description, System::String ^ fileName, System::Reflection::ResourceAttributes attribute);

public System.Resources.IResourceWriter DefineResource (string name, string description, string fileName, System.Reflection.ResourceAttributes attribute);

member this.DefineResource : string * string * string * System.Reflection.ResourceAttributes -> System.Resources.IResourceWriter

Public Function DefineResource (name As String, description As String, fileName As String, attribute As ResourceAttributes) As IResourceWriter

Parametri

name: String

Nome logico della risorsa.

description: String

Descrizione testuale della risorsa.

fileName: String

Nome fisico del file (file con estensione resources) a cui è mappato il nome logico. Non deve includere un percorso.

attribute: ResourceAttributes

Attributi della risorsa.

Restituisce

IResourceWriter

Oggetto ResourceWriter per la risorsa specificata.

Eccezioni

ArgumentException

name è stato definito in precedenza o nell'assembly è contenuto un altro file denominato fileName.

-oppure-

La lunghezza di name è zero.

-oppure-

La lunghezza di fileName è zero.

-oppure-

fileName include un percorso.

ArgumentNullException

name o fileName è null.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

È possibile aggiungere risorse con granularità fine con l'oggetto restituito ResourceWriter chiamando AddResource.

fileName non deve corrispondere a quello di qualsiasi altro modulo persistente, risorsa gestita autonoma o file manifesto autonomo.

Il runtime chiama il Close metodo quando viene salvato l'assembly dinamico.

Nota

Si applica a

Condividi tramite

AssemblyBuilder.DefineResource Metodo

Definizione

Overload

DefineResource(String, String, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

DefineResource(String, String, String, ResourceAttributes)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Risorse aggiuntive