ModuleBuilder.DefineUnmanagedResource Method

Definition

Namespace:

System.Reflection.Emit

Assembly:

mscorlib.dll

Defines an unmanaged resource in this module. The binary large object (BLOB) must have the right format for a Win32 resource.

Overloads

DefineUnmanagedResource(Byte[])	Defines an unmanaged embedded resource given an opaque binary large object (BLOB) of bytes.
DefineUnmanagedResource(String)	Defines an unmanaged resource given the name of Win32 resource file.

DefineUnmanagedResource(Byte[])

Defines an unmanaged embedded resource given an opaque binary large object (BLOB) of bytes.

public:
 void DefineUnmanagedResource(cli::array <System::Byte> ^ resource);

public void DefineUnmanagedResource (byte[] resource);

member this.DefineUnmanagedResource : byte[] -> unit

Public Sub DefineUnmanagedResource (resource As Byte())

Parameters

resource

Byte[]

An opaque BLOB that represents an unmanaged resource.

Exceptions

ArgumentException

An unmanaged resource has already been defined in the module's assembly.

ArgumentNullException

resource is null.

Remarks

An assembly can be associated with only one unmanaged resource. This means that calling DefineVersionInfoResource or DefineUnmanagedResource after either one of the methods was called previously throws ArgumentException. Multiple unmanaged resources need to be merged with a tool such as the Microsoft ResMerge utility (not supplied with the common language runtime).

Note

Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag. (See Security Issues in Reflection Emit.) To use this functionality, your application should target the .NET Framework 3.5 or later.

DefineUnmanagedResource(String)

Defines an unmanaged resource given the name of Win32 resource file.

public:
 void DefineUnmanagedResource(System::String ^ resourceFileName);

public void DefineUnmanagedResource (string resourceFileName);

member this.DefineUnmanagedResource : string -> unit

Public Sub DefineUnmanagedResource (resourceFileName As String)

Parameters

resourceFileName

String

The name of the unmanaged resource file.

Exceptions

ArgumentException

An unmanaged resource has already been defined in the module's assembly.

-or-

resourceFileName is the empty string ("").

ArgumentNullException

resourceFileName is null.

FileNotFoundException

resourceFileName is not found.

-or-

resourceFileName is a directory.

Remarks

An assembly can be associated with only one unmanaged resource. This means that calling DefineVersionInfoResource or DefineUnmanagedResource after either one of the methods was called previously throws ArgumentException. Multiple unmanaged resources need to be merged with a tool such as the Microsoft ResMerge utility (not supplied with the common language runtime).

Note

Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag. (See Security Issues in Reflection Emit.) To use this functionality, your application should target the .NET Framework 3.5 or later.