Defines an assembly by either referencing a file or through elements that make up the canonical name.
AssemblyReference is a data-only class that defines an assembly by either referencing a file or through elements that make up the canonical name. The purpose of this class is to simplify calling functions on the DotNet::Services object.
Canonical names are used to reference assemblies that are registered in the .NET Global Assembly Cache (GAC). The use of this cache allows for sharing of assemblies (much like installing a DLL into System32 or registering an OLE type with multiple versions). The objective is to be sure that multiple versions of an assembly can coexist in a managed way.
Referencing an assembly by file name (typically a "private assembly") is used for assemblies that are NOT registered in the global cache and are stored in a directory the application knows how to find.
Create a reference to an assembly by file name.
Dim Assy as DotNet::AssemblyReference Assy.FileName = MyAssembly.dll
Create a reference to an assembly by name, version, culture and public key token.
Dim Assy as DotNet::AssemblyReference Assy.Name = "SampleAssembly" Assy.Version = "1.0.2004.0" Assy.Culture = "neutral" Assy.PublicKeyToken = "8744b20f8da049e3"
When an instance of this class is passed to one of the functions in the DotNet::Services class, FileName takes precedence.
If FileName is populated, the assembly will be loaded from the path and file provided.
If FileName is empty, the called function will construct the canonical form of the name to use in loading the assembly; for example "SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3"