Assembly::GetManifestResourceStream Method (String^)

.NET Framework (current version)

Loads the specified manifest resource from this assembly.

Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
virtual Stream^ GetManifestResourceStream(
	String^ name
)

Parameters

name: Type: System::String^
The case-sensitive name of the manifest resource being requested.

Return Value

Type: System.IO::Stream^

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

Implements

_Assembly::GetManifestResourceStream(String^)

Exceptions

Exception

Condition

ArgumentNullException

The name parameter is null.

ArgumentException

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

FileLoadException

Note
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.

FileNotFoundException

name was not found.

BadImageFormatException

name is not a valid assembly.

NotImplementedException

Resource length is greater than Int64::MaxValue.

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

to access a private resource. Associated enumeration: ReflectionPermissionFlag::MemberAccess

ReflectionPermission

when invoked late-bound through mechanisms such as Type::InvokeMember. Associated enumeration: ReflectionPermissionFlag::MemberAccess

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1