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 был загружен в память загрузчиком ОС; 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 после строительства.