PEReader コンストラクター

定義

名前空間:

System.Reflection.PortableExecutable

アセンブリ:

System.Reflection.Metadata.dll

オーバーロード

PEReader(ImmutableArray<Byte>)	バイト配列に格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。
PEReader(Stream)	ストリームに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。
PEReader(Byte*, Int32)	メモリに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。
PEReader(Stream, PEStreamOptions)	現在の位置から開始し、ストリームの末尾で終わるストリームに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。
PEReader(Byte*, Int32, Boolean)	メモリに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。 フラグは、イメージが既にメモリに読み込まれているかどうかを示します。
PEReader(Stream, PEStreamOptions, Int32)	ストリームの現在の位置から開始する、指定されたサイズの PE イメージに対して、移植可能な実行可能リーダーを作成します。

PEReader(ImmutableArray<Byte>)

ソース:

PEReader.cs

バイト配列に格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。

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

パラメーター

peImage

ImmutableArray<Byte>

PE イメージを表す、変更できないバイト配列。

例外

ArgumentNullException

peImage は null です。

注釈

の構築中に画像の内容が読み取られない PEReader

PEReader(Stream)

ソース:

PEReader.cs

ストリームに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。

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)

パラメーター

peStream

Stream

PE イメージ ストリーム。

例外

ArgumentNullException

peStream が nullです。

注釈

コンストラクター引数の検証が成功すると、ストリームの所有権が に PEReader 転送されます。 によって破棄され PEReader 、呼び出し元がそれを操作することはできません。

PEReader(Byte*, Int32)

ソース:

PEReader.cs

メモリに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。

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

パラメーター

peImage

Byte*

PE イメージの開始へのポインター。

size

Int32

PE イメージのサイズです。

例外

ArgumentNullException

peImage が Zeroです。

ArgumentOutOfRangeException

size が負の値です。

注釈

メモリは呼び出し元によって所有され、 の PEReader破棄時に解放されません。 呼び出し元は、 の有効期間 PEReaderを通じてメモリを維持し、変更を行いません。

の構築中に画像の内容が読み取られない PEReader

PEReader(Stream, PEStreamOptions)

ソース:

PEReader.cs

現在の位置から開始し、ストリームの末尾で終わるストリームに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。

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)

パラメーター

peStream

Stream

PE イメージ ストリーム。

options

PEStreamOptions

ストリームから、PE イメージのセクションを読み取る方法を指定するオプション。

例外

ArgumentNullException

peStream が nullです。

ArgumentOutOfRangeException

options の値が無効です。

IOException

ストリームから読み取り中のエラー (データをプリフェッチする場合のみ)。

BadImageFormatException

PrefetchMetadata が指定されており、イメージの PE ヘッダーが無効です。

注釈

が指定されていない限り PEStreamOptions.LeaveOpen 、引数の検証が成功すると、ストリームの所有権が に PEReader 転送されます。 によって破棄され PEReader 、呼び出し元がそれを操作することはできません。

または PEStreamOptions.PrefetchEntireImage を指定しない限りPEStreamOptions.PrefetchMetadata、 の構築PEReader中にストリームからデータが読み取られます。 さらに、 が生きている間は、ストリームを PEReader 呼び出し元が操作しないようにする必要があります。

に または PEStreamOptions.PrefetchEntireImageが含まれているPEStreamOptions.PrefetchMetadata場合options、 PEReader は構築時に要求されたすべてのデータを読み取ります。 したがって、 も指定されている場合 PEStreamOptions.LeaveOpen 、呼び出し元はストリームの完全な所有権を保持し、構築後に によって操作されないことが PEReader 保証されます。

PEReader(Byte*, Int32, Boolean)

ソース:

PEReader.cs

メモリに格納されている PE イメージに対して、移植可能な実行可能リーダーを作成します。 フラグは、イメージが既にメモリに読み込まれているかどうかを示します。

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

パラメーター

peImage

Byte*

PE イメージの開始へのポインター。

size

Int32

PE イメージのサイズです。

isLoadedImage

Boolean

OS ローダーによって PE イメージがメモリに読み込まれている場合は true、それ以外の場合は false。

例外

ArgumentNullException

peImage が Zeroです。

ArgumentOutOfRangeException

size が負の値です。

注釈

メモリは呼び出し元によって所有され、 が破棄されるときに PEReader 解放されません。 呼び出し元は、 の有効期間 PEReaderを通じてメモリを維持し、変更を行いません。

の構築中に画像の内容が読み取られない PEReader

PEReader(Stream, PEStreamOptions, Int32)

ソース:

PEReader.cs

ストリームの現在の位置から開始する、指定されたサイズの PE イメージに対して、移植可能な実行可能リーダーを作成します。

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)

パラメーター

peStream

Stream

PE イメージ ストリーム。

options

PEStreamOptions

ストリームから、PE イメージのセクションを読み取る方法を指定するオプション。

size

Int32

PE イメージ サイズ。

例外

ArgumentOutOfRangeException

size が負の値であるか、ストリームの末尾を超えています。

IOException

ストリームから読み取り中のエラー (データをプリフェッチする場合のみ)。

BadImageFormatException

PrefetchMetadata が指定されており、イメージの PE ヘッダーが無効です。

注釈

が指定されていない限り PEStreamOptions.LeaveOpen 、引数の検証が成功すると、ストリームの所有権が に PEReader 転送されます。 によって破棄され PEReader、呼び出し元がそれを操作することはできません。

または PEStreamOptions.PrefetchEntireImage を指定しない限りPEStreamOptions.PrefetchMetadata、 の構築PEReader中にストリームからデータが読み取られます。 さらに、 が生きている間 PEReader は、ストリームを呼び出し元が操作することはできません。

に または PEStreamOptions.PrefetchEntireImage の値がPEStreamOptions.PrefetchMetadata含まれている場合options、 PEReader は構築時に要求されたすべてのデータを読み取ります。 したがって、 も指定されている場合 PEStreamOptions.LeaveOpen 、呼び出し元はストリームの完全な所有権を保持し、構築後に によって操作されないことが PEReader 保証されます。