PEReader コンストラクター

定義

名前空間:

System.Reflection.PortableExecutable

アセンブリ:

System.Reflection.Metadata.dll

パッケージ:

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

オーバーロード

名前	説明
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.PrefetchMetadataまたはPEStreamOptions.PrefetchEntireImageが指定されていない限り、PEReaderの構築中にストリームからデータが読み取られます。 さらに、 PEReader が有効であり、処理されていない間は、ストリームを呼び出し元が操作してはなりません。

options PEStreamOptions.PrefetchMetadataまたはPEStreamOptions.PrefetchEntireImageが含まれている場合、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

true PE イメージが OS ローダーによってメモリに読み込まれている場合。それ以外の場合は 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.PrefetchMetadataまたはPEStreamOptions.PrefetchEntireImageが指定されていない限り、PEReaderの構築中にストリームからデータが読み取られます。 さらに、 PEReader が生きているときに、ストリームを呼び出し元が操作しないようにする必要があります。

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