AssemblyBuilder.DefineUnmanagedResource

.NET Framework クラス ライブラリ リファレンス

AssemblyBuilder.DefineUnmanagedResource メソッド (String)

リソース ファイル名を指定して、このアセンブリのアンマネージ リソース ファイルを定義します。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub DefineUnmanagedResource ( _
    resourceFileName As String _
)

Visual Basic (使用法)

Dim instance As AssemblyBuilder
Dim resourceFileName As String

instance.DefineUnmanagedResource(resourceFileName)

C#

public void DefineUnmanagedResource (
    string resourceFileName
)

C++

public:
void DefineUnmanagedResource (
    String^ resourceFileName
)

J#

public void DefineUnmanagedResource (
    String resourceFileName
)

JScript

public function DefineUnmanagedResource (
    resourceFileName : String
)

パラメータ

resourceFileName

リソース ファイルの名前。

例外

例外の種類	条件
ArgumentException	アンマネージ リソースが既に定義されています。 または ファイル resourceFileName が読み取り可能ではありません。 または resourceFileName が空の文字列 ("") です。
ArgumentNullException	resourceFileName が null 参照 (Visual Basic では Nothing) です。
FileNotFoundException	resourceFileName が見つかりません。 または resourceFileName がディレクトリです。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

アセンブリは、1 つのアンマネージ リソースとしか関連付けることができません。DefineVersionInfoResource または DefineUnmanagedResource を呼び出した後で、再びいずれかのメソッドを呼び出すと、System.ArgumentException がスローされます。複数のアンマネージ リソースは、Microsoft ResMerge ユーティリティなどのツールでマージする必要があります。このツールは、共通言語ランタイムには含まれていません。

使用例

次の例は、DefineUnmanagedResource を呼び出して外部リソース ファイルを渡す方法を示しています。

Visual Basic

Friend Shared Sub Main()
   Dim myAssembly As AssemblyBuilder = _
       CreateAssembly("MyEmitTestAssembly")
   
   ' Defines a standalone managed resource for this assembly.
   Dim myResourceWriter As IResourceWriter
 = _
      myAssembly.DefineResource("myResourceFile",
 _
         "A sample Resource File", "MyAssemblyResource.resources",
 _
         ResourceAttributes.Private)

   myResourceWriter.AddResource("AddResource Test",
 "Testing for the added resource")

   myAssembly.Save(myAssembly.GetName().Name & ".dll")
   
   ' Defines an unmanaged resource file for this assembly.
   myAssembly.DefineUnmanagedResource("MyAssemblyResource.resources")

End Sub 

Private Shared Function
 CreateAssembly(ByVal name As String)
 As AssemblyBuilder

   Dim aName As New AssemblyName(name)

   Dim myAssembly As AssemblyBuilder = _
      AppDomain.CurrentDomain.DefineDynamicAssembly(aName, _
         AssemblyBuilderAccess.Save)
   
   ' Define a dynamic module.
   Dim myModule As ModuleBuilder = _
      myAssembly.DefineDynamicModule(aName.Name, aName.Name & ".dll")

   ' Define a public class named "EmitClass" in the assembly.
   Dim myEmitClass As TypeBuilder = _
      myModule.DefineType("EmitClass", TypeAttributes.Public)
   
   ' Define the Display method.
   Dim myMethod As MethodBuilder = _
      myEmitClass.DefineMethod("Display", MethodAttributes.Public,
 _
                                             GetType(String),
 Nothing)
   
   ' Generate IL for Display method.
   Dim methodIL As ILGenerator = myMethod.GetILGenerator()
   methodIL.Emit(OpCodes.Ldstr, "Display method get called.")
   methodIL.Emit(OpCodes.Ret)
   
   myEmitClass.CreateType()

   Return myAssembly

End Function 

C#

   internal static void Main()
   {
      AssemblyBuilder myAssembly = CreateAssembly("MyEmitTestAssembly");

      // Defines a standalone managed resource for this assembly.
      IResourceWriter myResourceWriter = myAssembly.DefineResource("myResourceFile"
,
         "A sample Resource File", "MyAssemblyResource.resources",
 
         ResourceAttributes.Private);

      myResourceWriter.AddResource("AddResource Test", "Testing for
 the added resource");

      myAssembly.Save(myAssembly.GetName().Name + ".dll");

      // Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource("MyAssemblyResource.resources");
   }

   private static AssemblyBuilder CreateAssembly(string
 name)
   {
      AssemblyName aName = new AssemblyName(name);
      AssemblyBuilder myAssembly = 
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName,
            AssemblyBuilderAccess.Save);

      // Define a dynamic module.
      ModuleBuilder myModule = 
         myAssembly.DefineDynamicModule(aName.Name, aName.Name + ".dll");

      // Define a public class named "EmitClass" in the assembly.
      TypeBuilder myEmitClass = myModule.DefineType("EmitClass", TypeAttributes.Public);

      // Define the Display method.
      MethodBuilder myMethod = myEmitClass.DefineMethod("Display",
         MethodAttributes.Public, typeof(String), null);

      // Generate IL for Display method.
      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.Emit(OpCodes.Ldstr, "Display method gets called.");
      methodIL.Emit(OpCodes.Ret);

      myEmitClass.CreateType();

      return(myAssembly);
   }
}

C++

void main()
{
   AssemblyBuilder^ myAssembly = CreateAssembly("MyEmitTestAssembly");
   
   // Defines a standalone managed resource for this assembly.
   IResourceWriter^ myResourceWriter = 
      myAssembly->DefineResource( "myResourceFile", "A sample Resource
 File", 
         "MyAssemblyResource.resources", ResourceAttributes::Private );

   myResourceWriter->AddResource( "AddResource Test", "Testing
 for the added resource" );

   myAssembly->Save(myAssembly->GetName()->Name + ".dll" );
   
   // Defines an unmanaged resource file for this assembly.
   myAssembly->DefineUnmanagedResource(  "MyAssemblyResource.resources"
 );
};

J#

public static void main(String[]
 args)
{
    AssemblyBuilder myAssembly = (AssemblyBuilder)(CreateAssembly(
        System.Threading.Thread.GetDomain()).get_Assembly());

    // Defines a standalone managed resource for this assembly.
    IResourceWriter myResourceWriter = myAssembly.DefineResource(
        "myResourceFile", "A sample Resource File", 
        "MyAssemblyResource.resources", ResourceAttributes.Private);
    myResourceWriter.AddResource("AddResource Test", 
        "Testing for the added resource");
    myAssembly.Save("MyEmitTestAssembly.dll");

    // Defines an unmanaged resource file for this assembly.
    myAssembly.DefineUnmanagedResource("MyAssemblyResource.resources");
} //main

private static Type CreateAssembly(AppDomain
 myDomain)
{
    AssemblyName myAssemblyName = new AssemblyName();
    myAssemblyName.set_Name("MyEmitTestAssembly");
    AssemblyBuilder myAssembly = myDomain.DefineDynamicAssembly(
        myAssemblyName, AssemblyBuilderAccess.Save);

    // Define a dynamic module.
    ModuleBuilder myModule = myAssembly.DefineDynamicModule(
        "MyEmittedModule", "MyEmittedModule.mod");

    // Define a public class named "EmitClass" in the assembly.
    TypeBuilder myEmitClass = myModule.DefineType("EmitClass", 
        TypeAttributes.Public);

    // Define the Display method.
    MethodBuilder myMethod = myEmitClass.DefineMethod("Display", 
        MethodAttributes.Public, String.class.ToType(), null);

    // Generate IL for Display method.
    ILGenerator methodIL = myMethod.GetILGenerator();
    methodIL.Emit(OpCodes.Ldstr, "Display method get called.");
    methodIL.Emit(OpCodes.Ret);

    // Returns the type of EmitClass.
    return myEmitClass.CreateType();
} //CreateAssembly

.NET Framework のセキュリティ

• ReflectionPermission  SecurityAction.Demand, ReflectionEmit=true
• ReflectionPermission  (Type.InvokeMember などの機構を通じて遅延バインディングが呼び出されるときに必要なアクセス許可)ReflectionPermissionFlag.MemberAccess (関連する列挙体)
• FileIOPermission  リソース ファイル resourceFileName にアクセスするには、FileIOPermissionAccess.Read アクセス許可が必要です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
AssemblyBuilder クラス
AssemblyBuilder メンバ
System.Reflection.Emit 名前空間

AssemblyBuilder.DefineUnmanagedResource メソッド (Byte[])

このアセンブリのアンマネージ リソースをバイトの非透過 BLOB として定義します。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub DefineUnmanagedResource ( _
    resource As Byte() _
)

Visual Basic (使用法)

Dim instance As AssemblyBuilder
Dim resource As Byte()

instance.DefineUnmanagedResource(resource)

C#

public void DefineUnmanagedResource (
    byte[] resource
)

C++

public:
void DefineUnmanagedResource (
    array<unsigned char>^ resource
)

J#

public void DefineUnmanagedResource (
    byte[] resource
)

JScript

public function DefineUnmanagedResource (
    resource : byte[]
)

パラメータ

resource

アンマネージ リソースを表すバイトの非透過 BLOB。

例外

例外の種類	条件
ArgumentException	アンマネージ リソースが既に定義されています。
ArgumentNullException	resource が null 参照 (Visual Basic では Nothing) です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

アセンブリは、1 つのアンマネージ リソースとしか関連付けることができません。DefineVersionInfoResource または DefineUnmanagedResource を呼び出した後で、再びいずれかのメソッドを呼び出すと、System.ArgumentException がスローされます。複数のアンマネージ リソースは、Microsoft ResMerge ユーティリティなどのツールでマージする必要があります。このツールは、共通言語ランタイムには含まれていません。

使用例

次のコード例は、DefineUnmanagedResource を使用してアンマネージ リソースを表すバイト配列を作成し、それを動的アセンブリに追加しています。

Visual Basic

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

Public Class MyAssemblyResource
   
   Friend Shared Sub Main()
      Dim myAssembly As AssemblyBuilder = _
          CreateAssembly("MyEmitTestAssembly")
      
      ' Defines a standalone managed resource for this assembly.
      Dim myResourceWriter As IResourceWriter
 = _
         myAssembly.DefineResource("myResourceFile",
 _
            "A sample Resource File", "MyAssemblyResource.resources",
 _
            ResourceAttributes.Private)

      myResourceWriter.AddResource("AddResource Test",
 "Testing for the added resource")

      myAssembly.Save(myAssembly.GetName().Name & ".dll")
      
      ' Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource(New Byte()
 {1, 0, 1})

   End Sub 
   
   Private Shared Function
 CreateAssembly(ByVal name As String)
 As AssemblyBuilder

      Dim aName As New AssemblyName(name)

      Dim myAssembly As AssemblyBuilder = _
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName, _
            AssemblyBuilderAccess.Save)
      
      ' Define a dynamic module.
      Dim myModule As ModuleBuilder = _
         myAssembly.DefineDynamicModule(aName.Name, aName.Name & ".dll")

      ' Define a public class named "EmitClass" in the assembly.
      Dim myEmitClass As TypeBuilder = _
         myModule.DefineType("EmitClass", TypeAttributes.Public)
      
      ' Define the Display method.
      Dim myMethod As MethodBuilder = _
         myEmitClass.DefineMethod("Display", MethodAttributes.Public,
 _
                                                GetType(String),
 Nothing)
      
      ' Generate IL for Display method.
      Dim methodIL As ILGenerator = myMethod.GetILGenerator()
      methodIL.Emit(OpCodes.Ldstr, "Display method get called.")
      methodIL.Emit(OpCodes.Ret)
      
      myEmitClass.CreateType()

      Return myAssembly

   End Function 
End Class 

C#

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

public class MyAssemblyResource
{
   internal static void Main()
   {
      AssemblyBuilder myAssembly = CreateAssembly("MyEmitTestAssembly");

      // Defines a standalone managed resource for this assembly.
      IResourceWriter myResourceWriter = myAssembly.DefineResource("myResourceFile"
,
         "A sample Resource File", "MyAssemblyResource.resources",
 
         ResourceAttributes.Private);

      myResourceWriter.AddResource("AddResource Test", "Testing for
 the added resource");

      myAssembly.Save(myAssembly.GetName().Name + ".dll");

      // Defines an unmanaged resource file for this assembly.
      myAssembly.DefineUnmanagedResource(new byte[]{01, 00, 01});
   }

   private static AssemblyBuilder CreateAssembly(string
 name)
   {
      AssemblyName aName = new AssemblyName(name);
      AssemblyBuilder myAssembly = 
         AppDomain.CurrentDomain.DefineDynamicAssembly(aName,
            AssemblyBuilderAccess.Save);

      // Define a dynamic module.
      ModuleBuilder myModule = 
         myAssembly.DefineDynamicModule(aName.Name, aName.Name + ".dll");

      // Define a public class named "EmitClass" in the assembly.
      TypeBuilder myEmitClass = myModule.DefineType("EmitClass", TypeAttributes.Public);

      // Define the Display method.
      MethodBuilder myMethod = myEmitClass.DefineMethod("Display",
         MethodAttributes.Public, typeof(String), null);

      // Generate IL for Display method.
      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.Emit(OpCodes.Ldstr, "Display method gets called.");
      methodIL.Emit(OpCodes.Ret);

      myEmitClass.CreateType();

      return(myAssembly);
   }
}

C++

/*
   The following program demonstrates the 'DefineResource' and 'DefineUnmanagedResource'
   methods of 'AssemblyBuilder' class. It builds an assembly and
 a resource file at runtime.
   An unmanaged resource file is also defined for the same resource
 file. The EmittedTest2.cpp file
   calls the methods of "MyEmitAssembly.dll" assembly and the message is
 displayed to console.
*/
using namespace System;
using namespace System::Threading;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
using namespace System::Resources;

   static AssemblyBuilder^ CreateAssembly( String^ name )
   {
      AssemblyName^ aName = gcnew AssemblyName(name);
      AssemblyBuilder^ myAssembly = 
         AppDomain::CurrentDomain->DefineDynamicAssembly( aName, 
            AssemblyBuilderAccess::Save );
      
      // Define a dynamic module.
      ModuleBuilder^ myModule = 
         myAssembly->DefineDynamicModule( aName->Name, aName->Name + ".dll"
 );
      
      // Define a public class named "EmitClass" in the assembly.
      TypeBuilder^ myEmitClass = 
         myModule->DefineType( "EmitClass", TypeAttributes::Public );
      
      // Define the Display method.
      MethodBuilder^ myMethod = 
         myEmitClass->DefineMethod( "Display", MethodAttributes::Public,
 
            String::typeid, nullptr );
      
      // Generate IL for Display method.
      ILGenerator^ methodIL = myMethod->GetILGenerator();
      methodIL->Emit( OpCodes::Ldstr, "Display method gets called."
 );
      methodIL->Emit( OpCodes::Ret );
      
      myEmitClass->CreateType();

      return (myAssembly);
   };

   void main()
   {
      AssemblyBuilder^ myAssembly = CreateAssembly("MyEmitTestAssembly");
      
      // Defines a standalone managed resource for this assembly.
      IResourceWriter^ myResourceWriter = 
         myAssembly->DefineResource( "myResourceFile", "A sample
 Resource File", 
            "MyAssemblyResource.resources", ResourceAttributes::Private
 );

      myResourceWriter->AddResource( "AddResource Test", "Testing
 for the added resource" );

      myAssembly->Save(myAssembly->GetName()->Name + ".dll" );
      
      // Defines an unmanaged resource file for this assembly.
      myAssembly->DefineUnmanagedResource( gcnew array<Byte>{01, 00, 01}
 );
   };

.NET Framework のセキュリティ

• ReflectionPermission  SecurityAction.Demand, ReflectionEmit=true
• ReflectionPermission  (Type.InvokeMember などの機構を通じて遅延バインディングが呼び出されるときに必要なアクセス許可)ReflectionPermissionFlag.MemberAccess (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
AssemblyBuilder クラス
AssemblyBuilder メンバ
System.Reflection.Emit 名前空間

AssemblyBuilder.DefineUnmanagedResource メソッド

このアセンブリのアンマネージ リソースを定義します。
オーバーロードの一覧

名前	説明
AssemblyBuilder.DefineUnmanagedResource (Byte[])	このアセンブリのアンマネージ リソースをバイトの非透過 BLOB として定義します。
AssemblyBuilder.DefineUnmanagedResource (String)	リソース ファイル名を指定して、このアセンブリのアンマネージ リソース ファイルを定義します。

参照

関連項目

AssemblyBuilder クラス
AssemblyBuilder メンバ
System.Reflection.Emit 名前空間