Skip to main content

CilAssemblyViewData

Struct CilAssemblyViewData 

pub struct CilAssemblyViewData<'a> {
    pub file: Arc<File>,
    pub data: &'a [u8],
    pub cor20header: Cor20Header,
    pub metadata_root: Root,
    pub metadata_tables: Option<TablesHeader<'a>>,
    pub strings: Option<Strings<'a>>,
    pub userstrings: Option<UserStrings<'a>>,
    pub guids: Option<Guid<'a>>,
    pub blobs: Option<Blob<'a>>,
    pub diagnostics: Arc<Diagnostics>,
}
Expand description

Raw assembly view data holding references to file structures.

CilAssemblyViewData manages the parsed metadata structures while maintaining direct references to the underlying file data. This structure is designed to preserve the raw layout of metadata streams and tables as they appear in the PE file, enabling future editing operations.

§Layout Preservation

Unlike CilObjectData which creates resolved and cross-referenced structures, CilAssemblyViewData maintains:

  • Raw metadata table data without resolution
  • Direct stream references without semantic processing
  • Original file offsets and layout information
  • Unprocessed blob and signature data

Fields§

§file: Arc<File>

Reference to the owning File structure

§data: &'a [u8]

Raw file data slice

§cor20header: Cor20Header

COR20 header containing .NET-specific PE information

§metadata_root: Root

Metadata root header with stream directory

§metadata_tables: Option<TablesHeader<'a>>

Raw metadata tables header from #~ or #- stream

§strings: Option<Strings<'a>>

Strings heap from #Strings stream

§userstrings: Option<UserStrings<'a>>

User strings heap from #US stream

§guids: Option<Guid<'a>>

GUID heap from #GUID stream

§blobs: Option<Blob<'a>>

Blob heap from #Blob stream

§diagnostics: Arc<Diagnostics>

Diagnostics collected during loading (duplicate heaps, structural issues, etc.)

Implementations§

§

impl<'a> CilAssemblyViewData<'a>

pub fn from_dotscope_file(file: Arc<File>, data: &'a [u8]) -> Result<Self>

Creates a new CilAssemblyViewData from file data.

This method parses the essential .NET metadata structures while preserving their raw form. Unlike CilObjectData::from_file, this method:

  • Does not resolve cross-references between tables
  • Does not create semantic object representations
  • Preserves original file layout information
  • Focuses on structural metadata access
  • Performs no validation or compliance checking
§Arguments
  • file - The File containing PE data
  • data - Raw file data slice
§Returns

Returns the parsed CilAssemblyViewData structure or an error if essential structures cannot be located (e.g., missing CLR header).

§Errors

Returns crate::Error::NotSupported if the file is not a .NET assembly (missing CLR header). Returns [crate::Error::OutOfBounds] if the file data is truncated or corrupted.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AsAny for T
where T: Any,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Source§

fn type_name(&self) -> &'static str

Gets the type name of self
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Downcast for T
where T: AsAny + ?Sized,

Source§

fn is<T>(&self) -> bool
where T: AsAny,

Returns true if the boxed type is the same as T. Read more
Source§

fn downcast_ref<T>(&self) -> Option<&T>
where T: AsAny,

Forward to the method defined on the type Any.
Source§

fn downcast_mut<T>(&mut self) -> Option<&mut T>
where T: AsAny,

Forward to the method defined on the type Any.
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, A> IntoAst<A> for T
where T: Into<A>, A: Ast,

Source§

fn into_ast(self, _a: &A) -> A

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<F, T> IntoSample<T> for F
where T: FromSample<F>,

Source§

fn into_sample(self) -> T

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more