Assembly.GetManifestResourceStream Method

Definition

Loads the specified manifest resource from this assembly.

Overloads

GetManifestResourceStream(Type, String)

Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.

GetManifestResourceStream(String)

Loads the specified manifest resource from this assembly.

GetManifestResourceStream(Type, String)

Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.

public:
 virtual System::IO::Stream ^ GetManifestResourceStream(Type ^ type, System::String ^ name);
public virtual System.IO.Stream GetManifestResourceStream (Type type, string name);
abstract member GetManifestResourceStream : Type * string -> System.IO.Stream
override this.GetManifestResourceStream : Type * string -> System.IO.Stream

Parameters

type
Type

The type whose namespace is used to scope the manifest resource name.

name
String

The case-sensitive name of the manifest resource being requested.

Returns

The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.

Implements

Exceptions

The name parameter is null.

The name parameter is an empty string ("").

A file that was found could not be loaded.

name was not found.

name is not a valid assembly.

Resource length is greater than MaxValue.

Remarks

For example, if the full name specified for type is "MyNameSpace.MyClasses" and name is "Net", this method overload searches for a resource named "MyNameSpace.Net".

A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. For more information about manifest resources, see Microsoft .NET Framework Resource Basics in the MSDN Library.

Resource information is returned only if the resource is visible to the caller, or the caller has ReflectionPermission.

Note

This method returns null if a private resource in another assembly is accessed and the caller does not have ReflectionPermission with the ReflectionPermissionFlag.MemberAccess flag.

If the assembly manifest lists a resource file, GetManifestResourceStream returns a Stream object even if the resource file cannot be found on disk at the time. If the resource file is not found, passing the resulting Stream object to the ResourceReader constructor causes an ArgumentException.

Security

ReflectionPermission
when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Associated enumeration: MemberAccess

See also

GetManifestResourceStream(String)

Loads the specified manifest resource from this assembly.

public:
 virtual System::IO::Stream ^ GetManifestResourceStream(System::String ^ name);
public virtual System.IO.Stream GetManifestResourceStream (string name);
abstract member GetManifestResourceStream : string -> System.IO.Stream
override this.GetManifestResourceStream : string -> System.IO.Stream
Public Overridable Function GetManifestResourceStream (name As String) As Stream

Parameters

name
String

The case-sensitive name of the manifest resource being requested.

Returns

The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.

Implements

Exceptions

The name parameter is null.

The name parameter is an empty string ("").

In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

A file that was found could not be loaded.

name was not found.

name is not a valid assembly.

Resource length is greater than MaxValue.

Remarks

A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. For more information about manifest resources, see Microsoft .NET Framework Resource Basics in the MSDN Library.

Resource information is returned only if the resource is visible to the caller, or the caller has ReflectionPermission.

Note

This method returns null if a private resource in another assembly is accessed and the caller does not have ReflectionPermission with the ReflectionPermissionFlag.MemberAccess flag.

If the assembly manifest lists a resource file, GetManifestResourceStream returns a Stream object even if the resource file cannot be found on disk at the time. If the resource file is not found, passing the resulting Stream object to the ResourceReader constructor causes an ArgumentException.

Security

ReflectionPermission
when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Associated enumeration: MemberAccess

See also

Applies to