Assembly.GetManifestResourceStream Metoda

Definicja

Przestrzeń nazw:

System.Reflection

Zestaw:

System.Runtime.dll

Ładuje określony zasób manifestu z tego zestawu.

Przeciążenia

GetManifestResourceStream(Type, String)	Ładuje określony zasób manifestu, o zakresie według przestrzeni nazw określonego typu, z tego zestawu.
GetManifestResourceStream(String)	Ładuje określony zasób manifestu z tego zestawu.

GetManifestResourceStream(Type, String)

Źródło:

Assembly.cs

Ładuje określony zasób manifestu, o zakresie według przestrzeni nazw określonego typu, z tego zestawu.

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

Public Overridable Function GetManifestResourceStream (type As Type, name As String) As Stream

Parametry

type

Type

Typ, którego przestrzeń nazw jest używana do określania zakresu nazwy zasobu manifestu.

name

String

Nazwa żądanego zasobu manifestu uwzględniana w wielkości liter.

Zwraca

Stream

Zasób manifestu; lub null jeśli podczas kompilacji nie określono żadnych zasobów lub jeśli zasób nie jest widoczny dla wywołującego.

Wyjątki

ArgumentNullException

Parametr name ma wartość null.

ArgumentException

Parametr name jest pustym ciągiem ("").

FileLoadException

Nie można załadować pliku, który został znaleziony.

FileNotFoundException

name nie można odnaleźć.

BadImageFormatException

name nie jest prawidłowym zestawem.

NotImplementedException

Długość zasobu jest większa niż Int64.MaxValue.

Uwagi

Jeśli na przykład pełna nazwa określona dla type parametru to "MyNameSpace.MyClasses" i name ma wartość "Net", ta metoda przeciąża wyszukiwanie zasobu o nazwie "MyNameSpace.Net".

Zasób manifestu to zasób (taki jak plik obrazu), który jest osadzony w zestawie w czasie kompilacji. Aby uzyskać więcej informacji na temat zasobów manifestu, zobacz Microsoft .NET Framework Resource Basics (Podstawy zasobów firmy Microsoft).

Informacje o zasobie są zwracane tylko wtedy, gdy zasób jest widoczny dla wywołującego lub obiekt wywołujący ma wartość ReflectionPermission.

Uwaga

Ta metoda zwraca null dostęp do zasobu prywatnego w innym zestawie, a obiekt wywołujący nie ma ReflectionPermission flagi ReflectionPermissionFlag.MemberAccess .

Jeśli manifest zestawu wyświetla plik zasobu, zwraca Stream obiekt, GetManifestResourceStream nawet jeśli nie można odnaleźć pliku zasobu na dysku w tym czasie. Jeśli plik zasobu nie zostanie znaleziony, przekazanie wynikowego Stream obiektu do konstruktora ResourceReader powoduje wystąpienie .ArgumentException

Zobacz też

• GetManifestResourceNames()
• Manifest zestawu

GetManifestResourceStream(String)

Źródło:

Assembly.cs

Ładuje określony zasób manifestu z tego zestawu.

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

Parametry

name

String

Nazwa żądanego zasobu manifestu uwzględniana w wielkości liter.

Zwraca

Stream

Zasób manifestu; lub null jeśli podczas kompilacji nie określono żadnych zasobów lub jeśli zasób nie jest widoczny dla wywołującego.

Wyjątki

ArgumentNullException

Parametr name ma wartość null.

ArgumentException

Parametr name jest pustym ciągiem ("").

FileLoadException

Nie można załadować pliku, który został znaleziony.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub biblioteki klas przenośnych przechwyć wyjątek klasy bazowej , IOExceptionzamiast tego.

FileNotFoundException

name nie można odnaleźć.

BadImageFormatException

name nie jest prawidłowym zestawem.

NotImplementedException

Długość zasobu jest większa niż Int64.MaxValue.

Uwagi

Zasób manifestu to zasób (taki jak plik obrazu), który jest osadzony w zestawie w czasie kompilacji. Aby uzyskać więcej informacji na temat zasobów manifestu, zobacz Microsoft .NET Framework Resource Basics (Podstawy zasobów firmy Microsoft).

Informacje o zasobie są zwracane tylko wtedy, gdy zasób jest widoczny dla wywołującego lub obiekt wywołujący ma wartość ReflectionPermission.

Uwaga

Ta metoda zwraca null dostęp do zasobu prywatnego w innym zestawie, a obiekt wywołujący nie ma ReflectionPermission flagi ReflectionPermissionFlag.MemberAccess .

Jeśli manifest zestawu wyświetla plik zasobu, zwraca Stream obiekt, GetManifestResourceStream nawet jeśli nie można odnaleźć pliku zasobu na dysku w tym czasie. Jeśli plik zasobu nie zostanie znaleziony, przekazanie wynikowego Stream obiektu do konstruktora ResourceReader powoduje wystąpienie .ArgumentException

Zobacz też

• GetManifestResourceNames()
• Manifest zestawu