AssemblyBuilder.DefineResource Metodo
Definizione
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
| Nome | Descrizione |
|---|---|
| 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. Gli attributi possono essere specificati 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 file fisico (file con estensione resources) a cui viene eseguito il mapping del nome logico. Questo non deve includere un percorso.
Valori restituiti
Oggetto ResourceWriter per la risorsa specificata.
Eccezioni
name è stato definito in precedenza.
oppure
Nell'assembly è presente un altro file denominato fileName.
oppure
La lunghezza di name è zero.
oppure
La lunghezza di fileName è zero.
oppure
fileName include un percorso.
name o fileName è null.
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.
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.
Si applica a
DefineResource(String, String, String, ResourceAttributes)
Definisce una risorsa gestita autonoma per questo assembly. Gli attributi possono essere specificati 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 file fisico (file con estensione resources) a cui viene eseguito il mapping del nome logico. Questo non deve includere un percorso.
- attribute
- ResourceAttributes
Attributi della risorsa.
Valori restituiti
Oggetto ResourceWriter per la risorsa specificata.
Eccezioni
name è stato definito in precedenza o se nell'assembly è presente un altro file denominato fileName.
oppure
La lunghezza di name è zero.
oppure
La lunghezza di fileName è zero.
oppure
fileName include un percorso.
name o fileName è null.
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.