PEReader Konstruktory

Definicja

Przestrzeń nazw:

System.Reflection.PortableExecutable

Zestaw:

System.Reflection.Metadata.dll

Przeciążenia

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 na obrazIE PE przechowywanym 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 wykonywalny dla obrazu 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

peImage to null.

Uwagi

Zawartość obrazu nie jest odczytywana podczas budowy obrazu 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

peStream to null.

Uwagi

Własność strumienia jest przekazywana do PEReader obiektu po pomyślnej weryfikacji argumentów konstruktora. Obiekt i PEReader obiekt 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 do początku obrazu PE.

size

Int32

Rozmiar obrazu PE.

Wyjątki

ArgumentNullException

peImage to 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 utrzymanie pamięci przy życiu i niezmodyfikowanych przez cały okres istnienia obiektu PEReader.

Zawartość obrazu nie jest odczytywana podczas budowy obrazu PEReader

PEReader(Stream, PEStreamOptions)

Źródło:

PEReader.cs

Tworzy przenośny czytnik plików wykonywalnych na obrazIE PE przechowywanym 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

peStream to null.

ArgumentOutOfRangeException

options ma nieprawidłową wartość.

IOException

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

BadImageFormatException

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

Uwagi

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

O ile PEStreamOptions.PrefetchMetadata nie określono lub PEStreamOptions.PrefetchEntireImage nie określono, żadne dane nie są odczytywane ze strumienia podczas budowy obiektu PEReader. 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 jest pewien, ż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 do początku 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

peImage to Zero.

ArgumentOutOfRangeException

size jest ujemna.

Uwagi

Pamięć jest własnością elementu wywołującego i nie jest zwalniana, gdy obiekt PEReader zostanie usunięty. Obiekt wywołujący jest odpowiedzialny za utrzymanie pamięci przy życiu i niezmodyfikowanych przez cały okres istnienia obiektu PEReader.

Zawartość obrazu nie jest odczytywana podczas budowy obrazu PEReader

PEReader(Stream, PEStreamOptions, Int32)

Źródło:

PEReader.cs

Tworzy przenośny czytnik wykonywalny dla obrazu 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 rozciąga się poza koniec strumienia.

IOException

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

BadImageFormatException

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

Uwagi

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

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

Jeśli options parametr zawiera PEStreamOptions.PrefetchMetadata wartości 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 jest pewien, że nie będzie manipulowany przez po budowie PEReader .