AssemblyBuilder.DefineResourceとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

AssemblyBuilder.DefineResource メソッド (String, String, String)

既定のパブリックリソース属性を使用して、このアセンブリのスタンドアロンマネージリソースを定義します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As AssemblyBuilder
Dim name As String
Dim description As String
Dim fileName As String
Dim returnValue As IResourceWriter

returnValue = instance.DefineResource(name, description, fileName)

public IResourceWriter DefineResource (
    string name,
    string description,
    string fileName
)

C++

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

public IResourceWriter DefineResource (
    String name, 
    String description, 
    String fileName
)

JScript

public function DefineResource (
    name : String, 
    description : String, 
    fileName : String
) : IResourceWriter

パラメータ

name: リソースの論理名。

description: 文章によるリソースの説明。

fileName: 論理名を割り当てる対象の物理ファイル名 (.resources ファイル)。パスを含めないでください。

戻り値
指定したリソースの ResourceWriter オブジェクト。

例外

例外の種類	条件
ArgumentException	name が既に定義されています。またはアセンブリ内に fileName という名前のファイルがもう 1 つあります。または name の長さが 0 です。または fileName の長さが 0 です。または fileName にパスが含まれています。
ArgumentNullException	name または fileName が null 参照 (Visual Basic では Nothing) です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

例外の種類

条件

ArgumentException

name が既に定義されています。

または

アセンブリ内に fileName という名前のファイルがもう 1 つあります。

または

name の長さが 0 です。

または

fileName の長さが 0 です。

または

fileName にパスが含まれています。

ArgumentNullException

name または fileName が null 参照 (Visual Basic では Nothing) です。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

解説

AddResource を呼び出して、返された ResourceWriter に、細かく細分化されたリソースを追加できます。

fileName は、それ以外の持続可能モジュール、スタンドアロンマネージリソース、またはスタンドアロンマニフェストファイルのいずれとも同じにしないでください。

動的アセンブリを保存するときに、Runtime は Close メソッドを呼び出します。

使用例

Visual Basic

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 'Main

' 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

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

C++

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(String[]
 args)
{
    AssemblyBuilder myAssembly;
    IResourceWriter myResourceWriter;

    myAssembly = (AssemblyBuilder)
        CreateAssembly(System.Threading.Thread.GetDomain()).get_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");
} //main

// Create the callee transient dynamic assembly.
private static Type CreateAssembly(AppDomain
 appDomain)
{
    AssemblyName myAssemblyName = new AssemblyName();
    myAssemblyName.set_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.class.ToType(), 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();
} //CreateAssembly

.NET Framework のセキュリティ

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

プラットフォーム

バージョン情報

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

参照

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

AssemblyBuilder.DefineResource メソッド (String, String, String, ResourceAttributes)

このアセンブリのスタンドアロンマネージリソースを定義します。マネージリソースには属性を指定できます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As AssemblyBuilder
Dim name As String
Dim description As String
Dim fileName As String
Dim attribute As ResourceAttributes
Dim returnValue As IResourceWriter

returnValue = instance.DefineResource(name, description, fileName, attribute)

public IResourceWriter DefineResource (
    string name,
    string description,
    string fileName,
    ResourceAttributes attribute
)

C++

public:
IResourceWriter^ DefineResource (
    String^ name, 
    String^ description, 
    String^ fileName, 
    ResourceAttributes attribute
)

public IResourceWriter DefineResource (
    String name, 
    String description, 
    String fileName, 
    ResourceAttributes attribute
)

JScript

public function DefineResource (
    name : String, 
    description : String, 
    fileName : String, 
    attribute : ResourceAttributes
) : IResourceWriter

パラメータ

name: リソースの論理名。

description: 文章によるリソースの説明。

fileName: 論理名を割り当てる対象の物理ファイル名 (.resources ファイル)。パスを含めないでください。

attribute: リソース属性。

戻り値
指定したリソースの ResourceWriter オブジェクト。

例外

例外の種類	条件
ArgumentException	name が既に定義されています。または、同じ fileName のアセンブリが別のファイルにあります。または name の長さが 0 です。または fileName の長さが 0 です。または fileName にパスが含まれています。
ArgumentNullException	name または fileName が null 参照 (Visual Basic では Nothing) です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

例外の種類

条件

ArgumentException

name が既に定義されています。または、同じ fileName のアセンブリが別のファイルにあります。

または

name の長さが 0 です。

または

fileName の長さが 0 です。

または

fileName にパスが含まれています。

ArgumentNullException

name または fileName が null 参照 (Visual Basic では Nothing) です。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

解説

AddResource を呼び出して、返された ResourceWriter に、細かく細分化されたリソースを追加できます。

fileName は、他の永続可能モジュール、スタンドアロンマネージリソース、またはスタンドアロンマニフェストファイルの名前と同じにしないでください。

動的アセンブリを保存するときに、Runtime は Close メソッドを呼び出します。

.NET Framework のセキュリティ

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

プラットフォーム

バージョン情報

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

参照

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

AssemblyBuilder.DefineResource メソッド

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

名前	説明
AssemblyBuilder.DefineResource (String, String, String)	既定のパブリックリソース属性を使用して、このアセンブリのスタンドアロンマネージリソースを定義します。
AssemblyBuilder.DefineResource (String, String, String, ResourceAttributes)	このアセンブリのスタンドアロンマネージリソースを定義します。マネージリソースには属性を指定できます。

参照

AssemblyBuilder.DefineResourceとは？わかりやすく解説

AssemblyBuilder.DefineResource メソッド (String, String, String)

AssemblyBuilder.DefineResource メソッド (String, String, String, ResourceAttributes)

AssemblyBuilder.DefineResource メソッド

関連項目

「AssemblyBuilder.DefineResource」の関連用語


	© 2025 Microsoft.All rights reserved.

AssemblyBuilder.DefineResourceとは？ わかりやすく解説

AssemblyBuilder.DefineResource メソッド (String, String, String)

AssemblyBuilder.DefineResource メソッド (String, String, String, ResourceAttributes)

AssemblyBuilder.DefineResource メソッド

関連項目

急上昇のことば

「AssemblyBuilder.DefineResource」の関連用語

AssemblyBuilder.DefineResourceとは？わかりやすく解説