Assembly.GetManifestResourceStream Assembly.GetManifestResourceStream Assembly.GetManifestResourceStream Assembly.GetManifestResourceStream Method

Definição

Carrega o recurso de manifesto especificado desse assembly.Loads the specified manifest resource from this assembly.

Sobrecargas

GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String)

Carrega o recurso de manifesto especificado, o escopo pelo namespace do tipo especificado, desse assembly.Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.

GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String)

Carrega o recurso de manifesto especificado desse assembly.Loads the specified manifest resource from this assembly.

GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String)

Carrega o recurso de manifesto especificado, o escopo pelo namespace do tipo especificado, desse assembly.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);
abstract member GetManifestResourceStream : Type * string -> System.IO.Stream
override this.GetManifestResourceStream : Type * string -> System.IO.Stream

Parâmetros

type
Type Type Type Type

O tipo cujo namespace é usado para definir o escopo do nome de recurso de manifesto.The type whose namespace is used to scope the manifest resource name.

name
String String String String

O nome que diferencia maiúsculas de minúsculas do recurso de manifesto solicitado.The case-sensitive name of the manifest resource being requested.

Retornos

O recurso de manifesto; ou null se nenhum recurso foi especificado durante a compilação ou se o recurso não é visível para o chamador.The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.

Implementações

Exceções

O parâmetro name é null.The name parameter is null.

O parâmetro name é uma cadeia de caracteres vazia ("").The name parameter is an empty string ("").

Não foi possível carregar um arquivo que foi encontrado.A file that was found could not be loaded.

name não é um assembly válido.name is not a valid assembly.

O tamanho do recurso é maior que MaxValue.Resource length is greater than MaxValue.

Comentários

Por exemplo, se o nome completo especificado para type for "MyNamespace. MyClasses" e name for "net", essa sobrecarga de método pesquisará um recurso chamado "MyNamespace.net".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".

Um recurso de manifesto é um recurso (como um arquivo de imagem) que é inserido no assembly em tempo de compilação.A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. Para obter mais informações sobre recursos de manifesto, consulte noções básicas de recursos do Microsoft .NET Framework na biblioteca do MSDN.For more information about manifest resources, see Microsoft .NET Framework Resource Basics in the MSDN Library.

As informações de recurso só serão retornadas se o recurso estiver visível para o chamador ou se ReflectionPermissiono chamador tiver.Resource information is returned only if the resource is visible to the caller, or the caller has ReflectionPermission.

Observação

Esse método retorna null se um recurso particular em outro assembly for acessado e o chamador não ReflectionPermission tiver com ReflectionPermissionFlag.MemberAccess o sinalizador.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.

Se o manifesto do assembly listar um arquivo GetManifestResourceStream de recurso Stream , o retornará um objeto mesmo se o arquivo de recurso não puder ser encontrado no disco no momento.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. Se o arquivo de recurso não for encontrado, a passagem Stream do objeto resultante ResourceReader para o construtor ArgumentExceptioncausará um.If the resource file is not found, passing the resulting Stream object to the ResourceReader constructor causes an ArgumentException.

Segurança

ReflectionPermission
quando invocado com associação tardia por meio de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeração associada: MemberAccessAssociated enumeration: MemberAccess

Veja também

GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String)

Carrega o recurso de manifesto especificado desse assembly.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);
abstract member GetManifestResourceStream : string -> System.IO.Stream
override this.GetManifestResourceStream : string -> System.IO.Stream
Public Overridable Function GetManifestResourceStream (name As String) As Stream

Parâmetros

name
String String String String

O nome que diferencia maiúsculas de minúsculas do recurso de manifesto solicitado.The case-sensitive name of the manifest resource being requested.

Retornos

O recurso de manifesto; ou null se nenhum recurso foi especificado durante a compilação ou se o recurso não é visível para o chamador.The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.

Implementações

Exceções

O parâmetro name é null.The name parameter is null.

O parâmetro name é uma cadeia de caracteres vazia ("").The name parameter is an empty string ("").

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

Não foi possível carregar um arquivo que foi encontrado.A file that was found could not be loaded.

name não é um assembly válido.name is not a valid assembly.

O tamanho do recurso é maior que MaxValue.Resource length is greater than MaxValue.

Comentários

Um recurso de manifesto é um recurso (como um arquivo de imagem) que é inserido no assembly em tempo de compilação.A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. Para obter mais informações sobre recursos de manifesto, consulte noções básicas de recursos do Microsoft .NET Framework na biblioteca do MSDN.For more information about manifest resources, see Microsoft .NET Framework Resource Basics in the MSDN Library.

As informações de recurso só serão retornadas se o recurso estiver visível para o chamador ou se ReflectionPermissiono chamador tiver.Resource information is returned only if the resource is visible to the caller, or the caller has ReflectionPermission.

Observação

Esse método retorna null se um recurso particular em outro assembly for acessado e o chamador não ReflectionPermission tiver com ReflectionPermissionFlag.MemberAccess o sinalizador.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.

Se o manifesto do assembly listar um arquivo GetManifestResourceStream de recurso Stream , o retornará um objeto mesmo se o arquivo de recurso não puder ser encontrado no disco no momento.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. Se o arquivo de recurso não for encontrado, a passagem Stream do objeto resultante ResourceReader para o construtor ArgumentExceptioncausará um.If the resource file is not found, passing the resulting Stream object to the ResourceReader constructor causes an ArgumentException.

Segurança

ReflectionPermission
quando invocado com associação tardia por meio de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeração associada: MemberAccessAssociated enumeration: MemberAccess

Veja também

Aplica-se a