Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Assembly.GetManifestResourceStream Method (String)

Loads the specified manifest resource from this assembly.

Namespace:  System.Reflection
Assemblies:   mscorlib (in mscorlib.dll)
  System.Reflection (in System.Reflection.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.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

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

Portable Class Library

Supported in: Portable Class Library

Show:
© 2015 Microsoft