assemblyReferences Element Overview

Defines a collection of assembly references used by the Reporting Engine during processing stage to resolve names of user functions, user aggregate functions, and types used by ObjectDataSource component and Report Event Handlers.

The types from the assemblies included in the assemblyReferences element do not need to be registered explicitly in the typeReferences Element.

XML-based configuration file:

<assemblyReferences>
    <add />
    <clear />
    <remove />
</assemblyReferences>

JSON-based configuration file:

"assemblyReferences": [
],

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes	None
Child Elements	add - Optional element. Adds an assembly reference to the collection. clear - Optional element. Removes all references to inherited assembly names, allowing only the references that are added by the current add element. remove - Optional element. Removes a reference to an inherited assembly name from the collection.
Parent Elements	configuration - Specifies the root element in every configuration file that is used by the common language runtime and the.NET Framework applications. Telerik.Reporting - Configures all settings that Telerik Reporting Engine uses.

Example

The following code example demonstrates how to configure the reporting engine to use MyUserFunctionsAssembly assembly as source for user functions. In this example it would also search for assemblies in MyDir and SubDir application base subdirectories as we have explicitly instructed that via the <probing> Element. This is not mandatory, and when not specified, it would search in the application base, which is the root location where the application is being executed.

The probing element is not supported in the .NET Standalone Designer

XML-based configuration file:

<?xml version="1.0"?>
<configuration>
    <configSections>
        <section name="Telerik.Reporting" type="Telerik.Reporting.Configuration.ReportingConfigurationSection, Telerik.Reporting" allowLocation="true" allowDefinition="Everywhere" />
    </configSections>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
              <probing privatePath="MyDir; MyDir2\SubDir"/>
        </assemblyBinding>
    </runtime>
    <Telerik.Reporting>
        <assemblyReferences>
            <add name="MyUserFunctionsAssembly" version="1.0.0.0" culture="neutral" publicKeyToken ="null" />
        </assemblyReferences>
    </Telerik.Reporting>
...
</configuration>

JSON-based configuration file:

"telerikReporting": {
    "assemblyReferences": [
        {
            "name": "MyUserFunctionsAssembly",
            "version": "1.0.0.0",
            "culture": "neutral",
            "publicKeyToken": "null"
        }
    ]
}

When adding the Telerik.Reporting section manually, do not forget to register it in configSections element of the configuration file. Failing to do so will result in a ConfigurationErrorsException with the following text: Configuration system failed to initialize.

See Also

• How the Runtime Locates Assemblies
• Specifying an Assembly's Location
• Element
• Application Configuration Files
• User Functions
• User Aggregate Functions