Struct ExeReader 

pub struct ExeReader<R> { /* private fields */ }

.NET PE 文件惰性读取器

该类负责读取和解析 .NET 程序集文件，提供以下功能：

• 检查文件是否为有效的 .NET 程序集
• 解析 CLR 头和元数据
• 提取程序集的基本信息
• 验证程序集的完整性
• 支持惰性读取和完整解析两种模式

Implementations

impl<R> ExeReader<R>

where R: Read + Seek,

pub fn new(reader: R) -> Self

使用泛型 PE 读取器构造 .NET 读取器

注意：这是惰性构造函数，不会立即执行解析工作流程

impl<R> ExeReader<R>

where R: Read + Seek,

pub fn get_assembly_info(&mut self) -> Result<DotNetAssemblyInfo, GaiaError>

从文件读取 .NET 程序集

该方法读取并解析 .NET 程序集文件，步骤如下：

1. 将整个文件读入内存
2. 创建 PE 视图以访问 PE 结构
3. 创建读取器实例
4. 执行解析工作流程

参数

• file_path - .NET 程序集文件路径

返回

• Ok(DotNetReader) - 成功解析的读取器
• Err(GaiaError) - 读取或解析过程中的错误 惰性读取程序集基本信息

仅读取程序集的基本标识信息，不解析完整的类型系统。 适用于快速获取程序集名称、版本等信息的场景。

返回

• Ok(DotNetAssemblyInfo) - 程序集基本信息
• Err(GaiaError) - 读取过程中的错误

pub fn to_clr_program(&mut self) -> Result<ClrProgram, GaiaError>

检查文件是否为 .NET 程序集

快速检查方法，无需完整解析，仅通过检查 PE 数据目录：

• 读取 PE 文件并创建视图
• 检查第 15 个数据目录（索引 14）是否为 CLR 运行时头
• 如果该目录存在且有效，则为 .NET 程序集

参数

• file_path - 要检查的 PE 文件路径

返回

• Ok(true) - 是 .NET 程序集
• Ok(false) - 不是 .NET 程序集
• Err(GaiaError) - 检查过程中的错误 完整解析为 CLR 程序

解析整个 .NET 程序集，包括所有类型、方法、字段等信息。 这是一个重量级操作，会消耗较多内存和时间。

返回

• Ok(ClrProgram) - 完整的 CLR 程序表示
• Err(GaiaError) - 解析过程中的错误

pub fn validate_assembly(&mut self) -> Result<Vec<String>, GaiaError>

惰性读取程序集基本信息

仅读取程序集的基本标识信息，不解析完整的类型系统。 适用于快速获取程序集名称、版本等信息的场景。

返回

• Ok(DotNetAssemblyInfo) - 程序集基本信息
• Err(GaiaError) - 读取过程中的错误 验证程序集完整性

检查解析后的 .NET 程序集是否包含所有必需的组件：

• CLR 头：包含运行时信息
• 元数据头：描述类型系统
• 元数据流：包含实际的元数据

返回

• Ok(Vec<String>) - 警告信息列表，空列表表示验证通过
• Err(GaiaError) - 验证过程中的错误

pub fn get_assembly_summary(&mut self) -> Result<String, GaiaError>

完整解析为 CLR 程序

解析整个 .NET 程序集，包括所有类型、方法、字段等信息。 这是一个重量级操作，会消耗较多内存和时间。

返回

• Ok(ClrProgram) - 完整的 CLR 程序表示
• Err(GaiaError) - 解析过程中的错误 获取程序集摘要信息

返回程序集的基本信息摘要，包括名称、版本、文化等。 这是一个便捷方法，用于快速获取程序集的关键信息。

返回

• Ok(String) - 格式化的程序集摘要信息
• Err(GaiaError) - 获取信息过程中的错误

Trait Implementations

impl<R: Debug> Debug for ExeReader<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Read + Seek> PeReader<R> for ExeReader<R>

fn get_viewer(&mut self) -> &mut R

获取二进制读取器的可变引用

fn add_diagnostics(&mut self, error: impl Into<GaiaError>)

获取诊断信息的可变引用

fn get_section_headers(&mut self) -> Result<&[SectionHeader], GaiaError>

获取缓存的节头信息

fn get_pe_header(&mut self) -> Result<&PeHeader, GaiaError>

读取 PE 头部信息（通用实现）

fn get_program(&mut self) -> Result<&PeProgram, GaiaError>

强制读取完整的 PeProgram，并缓存结果

fn get_position(&mut self) -> Result<u64, GaiaError>

where R: Seek,

fn set_position(&mut self, offset: u64) -> Result<u64, GaiaError>

where R: Seek,

fn rva_to_file_offset( &self, rva: u32, sections: &[PeSection], ) -> Result<u32, GaiaError>

将 RVA 转换为文件偏移（通用实现）

fn parse_import_table( &mut self, header: &PeHeader, sections: &[PeSection], ) -> Result<ImportTable, GaiaError>

解析导入表（通用实现）

fn parse_export_table( &mut self, header: &PeHeader, sections: &[PeSection], ) -> Result<ExportTable, GaiaError>

解析导出表（通用实现）

fn create_pe_info(&mut self) -> Result<PeInfo, GaiaError>

创建 PE 信息视图（通用实现）