ModuleBuilder.DefineResource メソッド

定義

名前空間:: System.Reflection.Emit

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このモジュールに格納するマネージド埋め込みリソースを定義します。

オーバーロード

名前	説明
DefineResource(String, String)	このモジュールに格納する名前付きマネージド埋め込みリソースを定義します。
DefineResource(String, String, ResourceAttributes)	このモジュールに格納する特定の属性を使用して、名前付きマネージド埋め込みリソースを定義します。

DefineResource(String, String)

このモジュールに格納する名前付きマネージド埋め込みリソースを定義します。

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

パラメーター

name: String

リソースの名前。 name 埋め込み null を含めることはできません。

description: String

リソースの説明。

返品

IResourceWriter

定義されたリソースのリソースライター。

例外

ArgumentException

nameの長さは 0 です。

ArgumentNullException

name が null です。

InvalidOperationException

このモジュールは一時的なものです。

-または-

包含アセンブリは永続化できません。

例

次の例は、 DefineResource を使用して現在の 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

注釈

動的アセンブリがディスクに書き込まれるときに、これらのメソッドはModuleBuilder.Saveによって呼び出されるため、呼び出し元はResourceWriter.Generate()メソッドとResourceWriter.Close() メソッドを呼び出してはなりません。

マネージドリソースを埋め込むには、このメソッドを使用します。マニフェストリソース BLOB を埋め込むには、 DefineManifestResource メソッドを使用します。マネージドリソースとマニフェストリソース BLOB の埋め込みとリンクの概要については、 DefineManifestResource メソッドを参照してください。

こちらもご覧ください

DefineManifestResource(String, Stream, ResourceAttributes)

適用対象

DefineResource(String, String, ResourceAttributes)

このモジュールに格納する特定の属性を使用して、名前付きマネージド埋め込みリソースを定義します。

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