Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 4
System.Reflection
Assembly Class
Assembly Methods
 GetManifestResourceStream Method (S...
Collapse All/Expand All Collapse All
This page is specific to
Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:
.NET Framework Class Library
Assembly..::.GetManifestResourceStream Method (String)

Loads the specified manifest resource from this assembly.

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)
Visual Basic
Public Overridable Function GetManifestResourceStream ( _
    name As String _
) As Stream
C#
public virtual Stream GetManifestResourceStream(
    string name
)
Visual C++
public:
virtual Stream^ GetManifestResourceStream(
    String^ name
)
F#
abstract GetManifestResourceStream : 
        name:string -> Stream 
override GetManifestResourceStream : 
        name:string -> Stream 

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 nullNothingnullptra null reference (Nothing in Visual Basic) 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 nullNothingnullptra null reference (Nothing in Visual Basic).

ArgumentException

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

FileLoadException

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 nullNothingnullptra null reference (Nothing in Visual Basic) 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, 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

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
gmaran23 - why did you have to duplicate the other comment?      alexbk66   |   Edit   |   Show History
@gmaran23 - why did you have to duplicate the other comment, especially changing "Build Action" (right) to "Built Type" (wrong)?
Tags What's this?: Add a tag
Flag as ContentBug
To Add an Icon file      gmaran23   |   Edit   |   Show History
If you add a .ico file to your project and you are using GetManifestResourceStream, as the previous commenter has mentioned --->

Go tp the properties window of that icon (from Solution exlorer), and then Change the Built Type to Embed Resource.
Tags What's this?: Add a tag
Flag as ContentBug
Build Action for icon resources needs to be set to Embedded Resource      fernando.machado.piriz ... Paulustrious   |   Edit   |   Show History
When you add an icon to assembly resources, Build Action for that resource needs to be set to Embedded Resource. If not then the resulting stream will be null. Select the icon resource in Project Explorer, go to Properties Window, and change Build Action to Embedded Resource.
Tags What's this?: Add a tag
Flag as ContentBug
Processing
© 2012 Microsoft. All rights reserved. Terms of Use | Trademarks | Privacy Statement
Page view tracker