Progress® Telerik® Reporting R2 2017

assemblyReferences Element

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.

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

Attributes and Elements

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

AttributesNone
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.

<?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>
Important note Important

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