PEReader Construtores

Definição

Namespace:

System.Reflection.PortableExecutable

Assembly:

System.Reflection.Metadata.dll

Sobrecargas

PEReader(ImmutableArray<Byte>)	Cria um leitor Executável Portátil em uma imagem PE armazenada em uma matriz de bytes.
PEReader(Stream)	Cria um leitor Executável Portátil em uma imagem PE armazenada em um fluxo.
PEReader(Byte*, Int32)	Cria um leitor Executável Portátil em uma imagem PE armazenada na memória.
PEReader(Stream, PEStreamOptions)	Cria um leitor de Executável Portátil em uma imagem PE armazenada em um fluxo, começando em sua posição atual e terminando no final do fluxo.
PEReader(Byte*, Int32, Boolean)	Cria um leitor Executável Portátil em uma imagem PE armazenada na memória. Um sinalizador indica se a imagem já foi carregada na memória.
PEReader(Stream, PEStreamOptions, Int32)	Cria um leitor de Executável Portátil em uma imagem PE do tamanho fornecido, começando na posição atual do fluxo.

PEReader(ImmutableArray<Byte>)

Origem:

PEReader.cs

Cria um leitor Executável Portátil em uma imagem PE armazenada em uma matriz de bytes.

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

Parâmetros

peImage

ImmutableArray<Byte>

Uma matriz de bytes imutável que representa a imagem PE.

Exceções

ArgumentNullException

peImage é null.

Comentários

O conteúdo da imagem não é lido durante a construção do PEReader

PEReader(Stream)

Origem:

PEReader.cs

Cria um leitor Executável Portátil em uma imagem PE armazenada em um fluxo.

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)

Parâmetros

peStream

Stream

Fluxo de imagem PE.

Exceções

ArgumentNullException

peStream é null.

Comentários

A propriedade do fluxo é transferida para o após a PEReader validação bem-sucedida de argumentos de construtor. Ele será descartado pelo PEReader e o chamador não deve manipulá-lo.

PEReader(Byte*, Int32)

Origem:

PEReader.cs

Cria um leitor Executável Portátil em uma imagem PE armazenada na memória.

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

Parâmetros

peImage

Byte*

Um ponteiro para o início da imagem PE.

size

Int32

O tamanho da imagem PE.

Exceções

ArgumentNullException

peImage é Zero.

ArgumentOutOfRangeException

size é negativo.

Comentários

A memória pertence ao chamador e não é liberada à disposição do PEReader. O chamador é responsável por manter a memória ativa e não modificada durante todo o tempo de vida do PEReader.

O conteúdo da imagem não é lido durante a construção do PEReader

PEReader(Stream, PEStreamOptions)

Origem:

PEReader.cs

Cria um leitor de Executável Portátil em uma imagem PE armazenada em um fluxo, começando em sua posição atual e terminando no final do fluxo.

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)

Parâmetros

peStream

Stream

Um fluxo de imagem PE.

options

PEStreamOptions

Opções especificando como as seções da imagem PE são lidas do fluxo.

Exceções

ArgumentNullException

peStream é null.

ArgumentOutOfRangeException

options tem um valor inválido.

IOException

Erro ao ler do fluxo (somente ao fazer a pré-busca de dados).

BadImageFormatException

PrefetchMetadata é especificado e os cabeçalhos PE da imagem são inválidos.

Comentários

PEStreamOptions.LeaveOpen A menos que seja especificado, a propriedade do fluxo é transferida para o após a PEReader validação bem-sucedida do argumento. Ele será descartado pelo PEReader e o chamador não deve manipulá-lo.

PEStreamOptions.PrefetchMetadata A menos que ou PEStreamOptions.PrefetchEntireImage seja especificado, nenhum dado é lido do fluxo durante a construção do PEReader. Além disso, o fluxo não deve ser manipulado pelo chamador enquanto o PEReader está vivo e não é desconhecido.

Se options incluir PEStreamOptions.PrefetchMetadata ou PEStreamOptions.PrefetchEntireImage, o PEReader terá lido todos os dados solicitados durante a construção. Dessa forma, se PEStreamOptions.LeaveOpen também for especificado, o chamador manterá a propriedade total do fluxo e terá certeza de que ele não será manipulado pelo após a PEReader construção.

PEReader(Byte*, Int32, Boolean)

Origem:

PEReader.cs

Cria um leitor Executável Portátil em uma imagem PE armazenada na memória. Um sinalizador indica se a imagem já foi carregada na memória.

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

Parâmetros

peImage

Byte*

Um ponteiro para o início da imagem PE.

size

Int32

O tamanho da imagem PE.

isLoadedImage

Boolean

true se a imagem de PE subjacente foi carregada na memória pelo carregador do sistema operacional; caso contrário, false.

Exceções

ArgumentNullException

peImage é Zero.

ArgumentOutOfRangeException

size é negativo.

Comentários

A memória pertence ao chamador e não é liberada quando o PEReader é descartado. O chamador é responsável por manter a memória ativa e não modificada durante todo o tempo de vida do PEReader.

O conteúdo da imagem não é lido durante a construção do PEReader

PEReader(Stream, PEStreamOptions, Int32)

Origem:

PEReader.cs

Cria um leitor de Executável Portátil em uma imagem PE do tamanho fornecido, começando na posição atual do fluxo.

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)

Parâmetros

peStream

Stream

Um fluxo de imagem PE.

options

PEStreamOptions

Opções especificando como as seções da imagem PE são lidas do fluxo.

size

Int32

O tamanho da imagem PE.

Exceções

ArgumentOutOfRangeException

size é negativo ou ultrapassa o final do fluxo.

IOException

Erro ao ler do fluxo (somente ao fazer a pré-busca de dados).

BadImageFormatException

PrefetchMetadata é especificado e os cabeçalhos PE da imagem são inválidos.

Comentários

PEStreamOptions.LeaveOpen A menos que seja especificado, a propriedade do fluxo é transferida para o após a PEReader validação bem-sucedida do argumento. Ele será descartado pelo PEReadere o chamador não deve manipulá-lo.

PEStreamOptions.PrefetchMetadata A menos que ou PEStreamOptions.PrefetchEntireImage seja especificado, nenhum dado é lido do fluxo durante a construção do PEReader. Além disso, o fluxo não deve ser manipulado pelo chamador enquanto o PEReader está vivo e não é desconhecido.

Se options incluir os PEStreamOptions.PrefetchMetadata valores ou PEStreamOptions.PrefetchEntireImage , o PEReader terá lido todos os dados solicitados durante a construção. Dessa forma, se PEStreamOptions.LeaveOpen também for especificado, o chamador manterá a propriedade total do fluxo e terá certeza de que ele não será manipulado pelo após a PEReader construção.