Class AssemblyReference

Namespace

AsmResolver.DotNet

Assembly

AsmResolver.DotNet.dll

Represents a reference to an external .NET assembly, hosted by a common language runtime (CLR).

public class AssemblyReference : AssemblyDescriptor, IResolutionScope, IModuleProvider, IOwnedCollectionElement<ModuleDefinition>, IImplementation, IImportable, IFullNameProvider, INameProvider, IHasCustomAttribute, IMetadataMember

Inheritance

object

MetadataMember

AssemblyDescriptor

AssemblyReference

Implements

IResolutionScope

IModuleProvider

IOwnedCollectionElement<ModuleDefinition>

IImplementation

IImportable

IFullNameProvider

INameProvider

IHasCustomAttribute

IMetadataMember

Derived

SerializedAssemblyReference

Inherited Members

AssemblyDescriptor.CustomAttributesInternal

AssemblyDescriptor.GetCustomAttributes()

AssemblyDescriptor.IsCorLib(in DotNetRuntimeInfo)

AssemblyDescriptor.IsReferenceCorLib(in DotNetRuntimeInfo)

AssemblyDescriptor.IsImplementationCorLib(in DotNetRuntimeInfo)

AssemblyDescriptor.GetName()

AssemblyDescriptor.GetCulture()

AssemblyDescriptor.ToString()

AssemblyDescriptor.ComputePublicKeyToken(byte[], AssemblyHashAlgorithm)

AssemblyDescriptor.Resolve(RuntimeContext)

AssemblyDescriptor.TryResolve(RuntimeContext, out AssemblyDefinition)

AssemblyDescriptor.ToAssemblyReference()

AssemblyDescriptor.Name

AssemblyDescriptor.FullName

AssemblyDescriptor.Version

AssemblyDescriptor.Attributes

AssemblyDescriptor.HasPublicKey

AssemblyDescriptor.EnableJitCompileTracking

AssemblyDescriptor.DisableJitCompileOptimizer

AssemblyDescriptor.IsWindowsRuntime

AssemblyDescriptor.IsRetargetable

AssemblyDescriptor.HasCustomAttributes

AssemblyDescriptor.CustomAttributes

AssemblyDescriptor.Culture

MetadataMember.MetadataToken

object.GetType()

object.MemberwiseClone()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Extension Methods

HasCustomAttributeExtensions.FindCustomAttributes(IHasCustomAttribute, Utf8String?, Utf8String?)

HasCustomAttributeExtensions.FindCustomAttributes(IHasCustomAttribute, string?, string?)

HasCustomAttributeExtensions.HasCustomAttribute(IHasCustomAttribute, Utf8String?, Utf8String?)

HasCustomAttributeExtensions.HasCustomAttribute(IHasCustomAttribute, string?, string?)

HasCustomAttributeExtensions.IsCompilerGenerated(IHasCustomAttribute)

TypeDescriptorExtensions.CreateTypeReference(IResolutionScope, Utf8String?, Utf8String)

TypeDescriptorExtensions.CreateTypeReference(IResolutionScope, string?, string)

Constructors

AssemblyReference(AssemblyDescriptor)

Creates a new assembly reference, and copies over all properties of another assembly descriptor.

public AssemblyReference(AssemblyDescriptor descriptor)

Parameters

descriptor AssemblyDescriptor

The assembly to base the reference on.

AssemblyReference(MetadataToken)

Initializes a new assembly reference.

protected AssemblyReference(MetadataToken token)

Parameters

token MetadataToken

The token of the assembly reference.

AssemblyReference(Utf8String?, Version)

Creates a new assembly reference.

public AssemblyReference(Utf8String? name, Version version)

Parameters

name Utf8String

The name of the assembly.

version Version

The version of the assembly.

AssemblyReference(Utf8String?, Version, bool, byte[]?)

Creates a new assembly reference.

public AssemblyReference(Utf8String? name, Version version, bool publicKey, byte[]? publicKeyOrToken)

Parameters

name Utf8String

The name of the assembly.

version Version

The version of the assembly.

publicKey bool

Indicates the key provided by publicKeyOrToken is the full, unhashed public key used to verify the authenticity of the assembly.

publicKeyOrToken byte[]

Indicates the public key or token (depending on publicKey), used to verify the authenticity of the assembly.

Properties

ContextModule

Gets the module that defines the member definition or reference.

public ModuleDefinition? ContextModule { get; }

Property Value

ModuleDefinition

Remarks

For member references, this does not obtain the module definition that the member is defined in. Rather, it obtains the module definition that references this reference.

HashValue

Gets or sets the hash value of the assembly reference.

public byte[]? HashValue { get; set; }

Property Value

byte[]

PublicKeyOrToken

Gets or sets the (token of the) public key of the assembly to use for verification of a signature.

public byte[]? PublicKeyOrToken { get; set; }

Property Value

byte[]

Remarks

If this value is set to null, no public key will be assigned.

When HasPublicKey is set to true, this value contains the full unhashed public key that was used to sign the assembly. This property does not automatically update the HasPublicKey property.

This property corresponds to the Culture column in the assembly definition table.

Methods

GetHashValue()

Obtains the hash value of the assembly reference.

protected virtual byte[]? GetHashValue()

Returns

byte[]

The hash value.

Remarks

This method is called upon initializing the HashValue property.

GetPublicKeyOrToken()

Obtains the public key or token of the assembly reference.

protected virtual byte[]? GetPublicKeyOrToken()

Returns

byte[]

The public key or token.

Remarks

This method is called upon initializing the PublicKeyOrToken property.

GetPublicKeyToken()

When the application is signed with a strong name, obtains the public key token of the assembly

public override byte[]? GetPublicKeyToken()

Returns

byte[]

The token.

ImportWith(ReferenceImporter)

Imports the assembly descriptor using the provided reference importer.

public override AssemblyReference ImportWith(ReferenceImporter importer)

Parameters

importer ReferenceImporter

The importer object to use.

Returns

AssemblyReference

The imported assembly reference.

IsImportedInModule(ModuleDefinition)

Determines whether the descriptor of the member is fully imported in the provided module.

public override bool IsImportedInModule(ModuleDefinition module)

Parameters

module ModuleDefinition

The module that is supposed to import the member.

Returns

bool

true if the descriptor of the member is fully imported by the module, false otherwise.

Remarks

This method verifies all references in the descriptor of the member only. It does not verify any additional data or contents (such as a method body) associated to the member.

Resolve(RuntimeContext?, out AssemblyDefinition?)

Attempts to resolve the assembly reference to its definition.

public override ResolutionStatus Resolve(RuntimeContext? context, out AssemblyDefinition? assembly)

Parameters

context RuntimeContext

The context to assume when resolving the assembly.

assembly AssemblyDefinition

The resolved assembly, or null if resolution failed.

Returns

ResolutionStatus

A value describing the success or failure status of the assembly resolution.