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);
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
Public Overridable Function GetManifestResourceStream (type As Type, name As String) As 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 Int64.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.

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.

See also

Applies to

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);
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 ("").

A file that was found could not be loaded.

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

name was not found.

name is not a valid assembly.

Resource length is greater than Int64.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.

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.

See also

Applies to