New to Telerik Reporting? Download free 30-day trial

assemblyReferences Element Overview

Defines a collection of assembly references that are used from Reporting Engine during processing stage to resolve names of user functions and user aggregate functions and also the types used by ObjectDataSource component.

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 configuration file. Failing to do so will result in a ConfigurationErrorsException with following text: Configuration system failed to initialize.

See Also

In this article