PEReader Konstruktory

Definicja

Przestrzeń nazw:

System.Reflection.PortableExecutable

Zestaw:

System.Reflection.Metadata.dll

Pakiet:

System.Reflection.Metadata v11.0.0-preview.5.26302.115

Przeciążenia

Nazwa	Opis
PEReader(ImmutableArray<Byte>)	Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w tablicy bajtów.
PEReader(Stream)	Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w strumieniu.
PEReader(Byte*, Int32)	Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w pamięci.
PEReader(Stream, PEStreamOptions)	Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w strumieniu rozpoczynającym się od bieżącej pozycji i kończącym się na końcu strumienia.
PEReader(Byte*, Int32, Boolean)	Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w pamięci. Flaga wskazuje, czy obraz został już załadowany do pamięci.
PEReader(Stream, PEStreamOptions, Int32)	Tworzy przenośny czytnik plików wykonywalnych na obraz PE o danym rozmiarze rozpoczynającym się od bieżącej pozycji strumienia.

PEReader(ImmutableArray<Byte>)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w tablicy bajtów.

public:
 PEReader(System::Collections::Immutable::ImmutableArray<System::Byte> peImage);

public PEReader(System.Collections.Immutable.ImmutableArray<byte> peImage);

new System.Reflection.PortableExecutable.PEReader : System.Collections.Immutable.ImmutableArray<byte> -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peImage As ImmutableArray(Of Byte))

Parametry

peImage

ImmutableArray<Byte>

Niezmienna tablica bajtów reprezentująca obraz PE.

Wyjątki

ArgumentNullException

Parametr peImage ma wartość null.

Uwagi

Zawartość obrazu nie jest odczytywana podczas budowy PEReader

PEReader(Stream)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w strumieniu.

public:
 PEReader(System::IO::Stream ^ peStream);

public PEReader(System.IO.Stream peStream);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream)

Parametry

peStream

Stream

Strumień obrazu PE.

Wyjątki

ArgumentNullException

Parametr peStream ma wartość null.

Uwagi

Własność strumienia jest przekazywana do PEReader elementu po pomyślnej weryfikacji argumentów konstruktora. Obiekt PEReader wywołujący nie może manipulować nim.

PEReader(Byte*, Int32)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w pamięci.

public:
 PEReader(System::Byte* peImage, int size);

public PEReader(byte* peImage, int size);

new System.Reflection.PortableExecutable.PEReader : nativeptr<byte> * int -> System.Reflection.PortableExecutable.PEReader

Parametry

peImage

Byte*

Wskaźnik na początek obrazu PE.

size

Int32

Rozmiar obrazu PE.

Wyjątki

ArgumentNullException

Parametr peImage ma wartość Zero.

ArgumentOutOfRangeException

size jest ujemna.

Uwagi

Pamięć jest własnością obiektu wywołującego i nie jest zwalniana do dyspozycji obiektu PEReader. Obiekt wywołujący jest odpowiedzialny za utrzymywanie pamięci przy życiu i niezmodyfikowanych przez cały okres istnienia obiektu PEReader.

Zawartość obrazu nie jest odczytywana podczas budowy PEReader

PEReader(Stream, PEStreamOptions)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w strumieniu rozpoczynającym się od bieżącej pozycji i kończącym się na końcu strumienia.

public:
 PEReader(System::IO::Stream ^ peStream, System::Reflection::PortableExecutable::PEStreamOptions options);

public PEReader(System.IO.Stream peStream, System.Reflection.PortableExecutable.PEStreamOptions options);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream * System.Reflection.PortableExecutable.PEStreamOptions -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream, options As PEStreamOptions)

Parametry

peStream

Stream

Strumień obrazu PE.

options

PEStreamOptions

Opcje określające sposób odczytywania sekcji obrazu PE ze strumienia.

Wyjątki

ArgumentNullException

Parametr peStream ma wartość null.

ArgumentOutOfRangeException

options ma nieprawidłową wartość.

IOException

Błąd podczas odczytywania ze strumienia (tylko w przypadku wstępnego pobierania danych).

BadImageFormatException

PrefetchMetadata jest określony, a nagłówki PE obrazu są nieprawidłowe.

Uwagi

O ile nie PEStreamOptions.LeaveOpen zostanie określony, własność strumienia zostanie przeniesiona do elementu po pomyślnej PEReader weryfikacji argumentu. Obiekt PEReader wywołujący nie może manipulować nim.

O ile PEStreamOptions.PrefetchMetadata nie określono ani PEStreamOptions.PrefetchEntireImage nie określono, żadne dane nie są odczytywane ze strumienia PEReaderpodczas budowy obiektu . Ponadto strumień nie może być manipulowany przez obiekt wywołujący, gdy PEReader obiekt jest żywy i niedysponowany.

Jeśli options element zawiera PEStreamOptions.PrefetchMetadata lub PEStreamOptions.PrefetchEntireImage, PEReader będzie odczytywał wszystkie dane wymagane podczas budowy. W związku z tym, jeśli PEStreamOptions.LeaveOpen zostanie również określony, obiekt wywołujący zachowuje pełną własność strumienia i zapewnia, że nie będzie manipulowany przez po budowie PEReader .

PEReader(Byte*, Int32, Boolean)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych za pośrednictwem obrazu PE przechowywanego w pamięci. Flaga wskazuje, czy obraz został już załadowany do pamięci.

public:
 PEReader(System::Byte* peImage, int size, bool isLoadedImage);

public PEReader(byte* peImage, int size, bool isLoadedImage);

new System.Reflection.PortableExecutable.PEReader : nativeptr<byte> * int * bool -> System.Reflection.PortableExecutable.PEReader

Parametry

peImage

Byte*

Wskaźnik na początek obrazu PE.

size

Int32

Rozmiar obrazu PE.

isLoadedImage

Boolean

true jeśli obraz PE został załadowany do pamięci przez moduł ładujący systemu operacyjnego; w przeciwnym razie, false.

Wyjątki

ArgumentNullException

Parametr peImage ma wartość Zero.

ArgumentOutOfRangeException

size jest ujemna.

Uwagi

Pamięć jest własnością elementu wywołującego i nie jest zwalniana po usunięciu PEReader . Obiekt wywołujący jest odpowiedzialny za utrzymywanie pamięci przy życiu i niezmodyfikowanych przez cały okres istnienia obiektu PEReader.

Zawartość obrazu nie jest odczytywana podczas budowy PEReader

PEReader(Stream, PEStreamOptions, Int32)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych na obraz PE o danym rozmiarze rozpoczynającym się od bieżącej pozycji strumienia.

public:
 PEReader(System::IO::Stream ^ peStream, System::Reflection::PortableExecutable::PEStreamOptions options, int size);

public PEReader(System.IO.Stream peStream, System.Reflection.PortableExecutable.PEStreamOptions options, int size);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream * System.Reflection.PortableExecutable.PEStreamOptions * int -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream, options As PEStreamOptions, size As Integer)

Parametry

peStream

Stream

Strumień obrazu PE.

options

PEStreamOptions

Opcje określające sposób odczytywania sekcji obrazu PE ze strumienia.

size

Int32

Rozmiar obrazu PE.

Wyjątki

ArgumentOutOfRangeException

size jest ujemny lub rozszerza koniec strumienia.

IOException

Błąd podczas odczytywania ze strumienia (tylko w przypadku wstępnego pobierania danych).

BadImageFormatException

PrefetchMetadata jest określony, a nagłówki PE obrazu są nieprawidłowe.

Uwagi

O ile nie PEStreamOptions.LeaveOpen zostanie określony, własność strumienia zostanie przeniesiona do elementu po pomyślnej PEReader weryfikacji argumentu. Zostanie on usunięty przez PEReaderobiekt , a obiekt wywołujący nie może manipulować nim.

O ile PEStreamOptions.PrefetchMetadata nie określono ani PEStreamOptions.PrefetchEntireImage nie określono, żadne dane nie są odczytywane ze strumienia PEReaderpodczas budowy obiektu . Ponadto strumień nie może być manipulowany przez obiekt wywołujący, gdy PEReader obiekt jest żywy i niedysponowany.

W przypadku options instalowania PEStreamOptions.PrefetchMetadata wartości PEStreamOptions.PrefetchEntireImage lub PEReader wszystkie dane żądane podczas budowy będą odczytywane. W związku z tym, jeśli PEStreamOptions.LeaveOpen zostanie również określony, obiekt wywołujący zachowuje pełną własność strumienia i zapewnia, że nie będzie manipulowany przez po budowie PEReader .