PEReader Costruttori

Definizione

Spazio dei nomi:

System.Reflection.PortableExecutable

Assembly:

System.Reflection.Metadata.dll

Overload

PEReader(ImmutableArray<Byte>)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in una matrice di byte.
PEReader(Stream)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in un flusso.
PEReader(Byte*, Int32)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in memoria.
PEReader(Stream, PEStreamOptions)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in un flusso che inizia dalla posizione corrente e termina alla fine del flusso.
PEReader(Byte*, Int32, Boolean)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in memoria. Un flag indica se l'immagine è già stata caricata in memoria.
PEReader(Stream, PEStreamOptions, Int32)	Crea un lettore per i file eseguibili di tipo PE su un'immagine PE delle dimensioni specificate che inizia dalla posizione corrente del flusso.

PEReader(ImmutableArray<Byte>)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in una matrice di byte.

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

Parametri

peImage

ImmutableArray<Byte>

Matrice di byte non modificabile che rappresenta l'immagine PE.

Eccezioni

ArgumentNullException

peImage è null.

Commenti

Il contenuto dell'immagine non viene letto durante la costruzione di PEReader

PEReader(Stream)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in un flusso.

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)

Parametri

peStream

Stream

Flusso dell'immagine PE.

Eccezioni

ArgumentNullException

peStream è null.

Commenti

La proprietà del flusso viene trasferita all'oggetto PEReader al momento della convalida corretta degli argomenti del costruttore. Verrà eliminato dal PEReader chiamante e il chiamante non deve modificarlo.

PEReader(Byte*, Int32)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in memoria.

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

Parametri

peImage

Byte*

Puntatore all'inizio dell'immagine PE.

size

Int32

Dimensioni dell'immagine PE.

Eccezioni

ArgumentNullException

peImage è Zero.

ArgumentOutOfRangeException

size è negativo.

Commenti

La memoria è di proprietà del chiamante e non rilasciata sullo smaltimento di PEReader. Il chiamante è responsabile della conservazione della memoria attiva e non modificata durante la durata dell'oggetto PEReader.

Il contenuto dell'immagine non viene letto durante la costruzione di PEReader

PEReader(Stream, PEStreamOptions)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in un flusso che inizia dalla posizione corrente e termina alla fine del flusso.

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)

Parametri

peStream

Stream

Flusso dell'immagine PE.

options

PEStreamOptions

Opzioni che specificano la modalità di lettura delle sezioni dell'immagine PE dal flusso.

Eccezioni

ArgumentNullException

peStream è null.

ArgumentOutOfRangeException

Il valore di optionsnon è valido.

IOException

Errore durante la lettura dal flusso (solo in caso di prelettura dei dati).

BadImageFormatException

PrefetchMetadata viene specificato e le intestazioni PE dell'immagine non sono valide.

Commenti

A meno che PEStreamOptions.LeaveOpen non sia specificato, la proprietà del flusso viene trasferita all'oggetto dopo la convalida dell'argomento PEReader riuscita. Verrà eliminato dal PEReader chiamante e il chiamante non deve modificarlo.

A meno che PEStreamOptions.PrefetchMetadata non sia specificato o PEStreamOptions.PrefetchEntireImage specificato, nessun dato viene letto dal flusso durante la costruzione di PEReader. Inoltre, il flusso non deve essere manipolato dal chiamante mentre l'oggetto PEReader è vivo e non èdisposo.

Se options include PEStreamOptions.PrefetchMetadata o PEStreamOptions.PrefetchEntireImage, l'oggetto PEReader avrà letto tutti i dati richiesti durante la costruzione. Di conseguenza, se PEStreamOptions.LeaveOpen è specificato anche, il chiamante mantiene la proprietà completa del flusso e viene assicurato che non verrà manipolato dalla costruzione dopo la PEReader costruzione.

PEReader(Byte*, Int32, Boolean)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE archiviata in memoria. Un flag indica se l'immagine è già stata caricata in memoria.

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

Parametri

peImage

Byte*

Puntatore all'inizio dell'immagine PE.

size

Int32

Dimensioni dell'immagine PE.

isLoadedImage

Boolean

true se l'immagine PE è stata caricata in memoria dal caricatore del sistema operativo; in caso contrario, false.

Eccezioni

ArgumentNullException

peImage è Zero.

ArgumentOutOfRangeException

size è negativo.

Commenti

La memoria è di proprietà del chiamante e non viene rilasciata quando l'oggetto PEReader viene eliminato. Il chiamante è responsabile della conservazione della memoria attiva e non modificata durante la durata dell'oggetto PEReader.

Il contenuto dell'immagine non viene letto durante la costruzione di PEReader

PEReader(Stream, PEStreamOptions, Int32)

Source:

PEReader.cs

Crea un lettore per i file eseguibili di tipo PE su un'immagine PE delle dimensioni specificate che inizia dalla posizione corrente del flusso.

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)

Parametri

peStream

Stream

Flusso dell'immagine PE.

options

PEStreamOptions

Opzioni che specificano la modalità di lettura delle sezioni dell'immagine PE dal flusso.

size

Int32

Dimensioni dell'immagine PE.

Eccezioni

ArgumentOutOfRangeException

size è negativo o si estende oltre la fine del flusso.

IOException

Errore durante la lettura dal flusso (solo in caso di prelettura dei dati).

BadImageFormatException

PrefetchMetadata viene specificato e le intestazioni PE dell'immagine non sono valide.

Commenti

A meno che PEStreamOptions.LeaveOpen non sia specificato, la proprietà del flusso viene trasferita all'oggetto dopo la convalida dell'argomento PEReader riuscita. Verrà eliminato dal PEReaderchiamante e il chiamante non deve modificarlo.

A meno che PEStreamOptions.PrefetchMetadata non sia specificato o PEStreamOptions.PrefetchEntireImage specificato, nessun dato viene letto dal flusso durante la costruzione di PEReader. Inoltre, il flusso non deve essere manipolato dal chiamante mentre il PEReader chiamante è vivo e non èdisposo.

Se options include i valori oPEStreamOptions.PrefetchEntireImage, l'oggetto PEStreamOptions.PrefetchMetadataPEReader avrà letto tutti i dati richiesti durante la costruzione. Di conseguenza, se PEStreamOptions.LeaveOpen è specificato anche, il chiamante mantiene la proprietà completa del flusso e viene assicurato che non verrà manipolato dalla costruzione dopo la PEReader costruzione.