Assembly.GetManifestResourceStream Method (String)

Loads the specified manifest resource from this assembly.

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

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)

ExceptionCondition
ArgumentNullException

The name parameter is null.

ArgumentException

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

FileLoadException
NoteNote

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.

NoteNote

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.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft