PEReader Konstruktoren

Definition

Namespace:

System.Reflection.PortableExecutable

Assembly:

System.Reflection.Metadata.dll

Paket:

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

Überlädt

Name	Beschreibung
PEReader(ImmutableArray<Byte>)	Erstellt einen portablen ausführbaren Reader über ein PE-Image, das in einem Bytearray gespeichert ist.
PEReader(Stream)	Erstellt einen portablen ausführbaren Reader über ein PE-Image, das in einem Datenstrom gespeichert ist.
PEReader(Byte*, Int32)	Erstellt einen portablen ausführbaren Reader über ein PE-Image, das im Arbeitsspeicher gespeichert ist.
PEReader(Stream, PEStreamOptions)	Erstellt einen portablen ausführbaren Reader über ein PE-Bild, das an seiner aktuellen Position und am Ende des Datenstroms in einem Datenstrom gespeichert ist.
PEReader(Byte*, Int32, Boolean)	Erstellt einen portablen ausführbaren Reader über ein PE-Image, das im Arbeitsspeicher gespeichert ist. Ein Kennzeichen gibt an, ob das Bild bereits in den Arbeitsspeicher geladen wurde.
PEReader(Stream, PEStreamOptions, Int32)	Erstellt einen portablen ausführbaren Reader über ein PE-Bild der angegebenen Größe beginnend an der aktuellen Position des Datenstroms.

PEReader(ImmutableArray<Byte>)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Image, das in einem Bytearray gespeichert ist.

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))

Parameter

peImage

ImmutableArray<Byte>

Ein unveränderliches Bytearray, das das PE-Bild darstellt.

Ausnahmen

ArgumentNullException

peImage ist null.

Hinweise

Der Inhalt des Bilds wird während der Konstruktion des Bilds nicht gelesen. PEReader

PEReader(Stream)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Image, das in einem Datenstrom gespeichert ist.

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)

Parameter

peStream

Stream

PE-Bildstream.

Ausnahmen

ArgumentNullException

peStream ist null.

Hinweise

Der Besitz des Datenstroms wird auf die PEReader erfolgreiche Überprüfung von Konstruktorargumenten übertragen. Sie wird vom PEReader Aufrufer gelöscht, und der Aufrufer darf ihn nicht bearbeiten.

PEReader(Byte*, Int32)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Image, das im Arbeitsspeicher gespeichert ist.

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

Parameter

peImage

Byte*

Ein Zeiger zum Anfang des PE-Bilds.

size

Int32

Die Größe des PE-Bilds.

Ausnahmen

ArgumentNullException

peImage ist Zero.

ArgumentOutOfRangeException

size ist negativ.

Hinweise

Der Speicher gehört dem Anrufer und wird nicht zur Verfügung PEReadergestellt. Der Anrufer ist dafür verantwortlich, den Speicher während der gesamten Lebensdauer des PEReaderSpeichers lebendig und unverändert zu halten.

Der Inhalt des Bilds wird während der Konstruktion des Bilds nicht gelesen. PEReader

PEReader(Stream, PEStreamOptions)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Bild, das an seiner aktuellen Position und am Ende des Datenstroms in einem Datenstrom gespeichert ist.

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)

Parameter

peStream

Stream

Ein PE-Bildstream.

options

PEStreamOptions

Optionen, die angeben, wie Abschnitte des PE-Bilds aus dem Datenstrom gelesen werden.

Ausnahmen

ArgumentNullException

peStream ist null.

ArgumentOutOfRangeException

options hat einen ungültigen Wert.

IOException

Fehler beim Lesen aus dem Datenstrom (nur beim Vorabrufen von Daten).

BadImageFormatException

PrefetchMetadata wird angegeben, und die PE-Kopfzeilen des Bilds sind ungültig.

Hinweise

Sofern nicht PEStreamOptions.LeaveOpen angegeben, wird der Besitz des Datenstroms auf die PEReader erfolgreiche Argumentüberprüfung übertragen. Sie wird vom PEReader Aufrufer gelöscht, und der Aufrufer darf ihn nicht bearbeiten.

Sofern nicht PEStreamOptions.PrefetchMetadata angegeben oder PEStreamOptions.PrefetchEntireImage angegeben, werden während der Konstruktion des PEReaderDatenstroms keine Daten aus dem Datenstrom gelesen. Darüber hinaus darf der Datenstrom nicht vom Aufrufer bearbeitet werden, während der PEReader Datenstrom aktiv ist und nicht verwendet wird.

Falls options eingeschlossen PEStreamOptions.PrefetchMetadata oder PEStreamOptions.PrefetchEntireImage, PEReader werden alle während der Konstruktion angeforderten Daten gelesen. Falls auch angegeben, PEStreamOptions.LeaveOpen behält der Aufrufer den vollständigen Besitz des Datenstroms bei und ist sicher, dass er nach dem PEReader Bau nicht bearbeitet wird.

PEReader(Byte*, Int32, Boolean)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Image, das im Arbeitsspeicher gespeichert ist. Ein Kennzeichen gibt an, ob das Bild bereits in den Arbeitsspeicher geladen wurde.

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

Parameter

peImage

Byte*

Ein Zeiger zum Anfang des PE-Bilds.

size

Int32

Die Größe des PE-Bilds.

isLoadedImage

Boolean

truewenn das PE-Image vom Betriebssystemladeprogramm in den Arbeitsspeicher geladen wurde; andernfalls . false

Ausnahmen

ArgumentNullException

peImage ist Zero.

ArgumentOutOfRangeException

size ist negativ.

Hinweise

Der Speicher gehört dem Aufrufer und wird nicht freigegeben, wenn der PEReader Speicher verworfen wird. Der Anrufer ist dafür verantwortlich, den Speicher während der gesamten Lebensdauer des PEReaderSpeichers lebendig und unverändert zu halten.

Der Inhalt des Bilds wird während der Konstruktion des Bilds nicht gelesen. PEReader

PEReader(Stream, PEStreamOptions, Int32)

Quelle:

PEReader.cs

Erstellt einen portablen ausführbaren Reader über ein PE-Bild der angegebenen Größe beginnend an der aktuellen Position des Datenstroms.

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)

Parameter

peStream

Stream

Ein PE-Bildstream.

options

PEStreamOptions

Optionen, die angeben, wie Abschnitte des PE-Bilds aus dem Datenstrom gelesen werden.

size

Int32

Die Größe des PE-Bilds.

Ausnahmen

ArgumentOutOfRangeException

size ist negativ oder erstreckt sich über das Ende des Datenstroms.

IOException

Fehler beim Lesen aus dem Datenstrom (nur beim Vorabrufen von Daten).

BadImageFormatException

PrefetchMetadata wird angegeben, und die PE-Kopfzeilen des Bilds sind ungültig.

Hinweise

Sofern nicht PEStreamOptions.LeaveOpen angegeben, wird der Besitz des Datenstroms auf die PEReader erfolgreiche Argumentüberprüfung übertragen. Sie wird vom PEReaderAufrufer gelöscht, und der Aufrufer darf ihn nicht bearbeiten.

Sofern nicht PEStreamOptions.PrefetchMetadata angegeben oder PEStreamOptions.PrefetchEntireImage angegeben, werden während der Konstruktion des PEReaderDatenstroms keine Daten aus dem Datenstrom gelesen. Darüber hinaus darf der Datenstrom nicht vom Aufrufer bearbeitet werden, während der PEReader Aufrufer aktiv ist und nicht mehr verwendet wird.

Wenn options die PEStreamOptions.PrefetchMetadata Werte enthalten sind PEStreamOptions.PrefetchEntireImage , PEReader werden alle während der Konstruktion angeforderten Daten gelesen. Falls auch angegeben, PEStreamOptions.LeaveOpen behält der Aufrufer den vollständigen Besitz des Datenstroms bei und ist sicher, dass er nach dem PEReader Bau nicht bearbeitet wird.