Share via


IExtension.SetConfiguration(String) Method

Definition

Used to pass custom configuration data to an extension.

public:
 void SetConfiguration(System::String ^ configuration);
public void SetConfiguration (string configuration);
abstract member SetConfiguration : string -> unit
Public Sub SetConfiguration (configuration As String)

Parameters

configuration
String

The XML string from the configuration file that contains extension configuration data.

Remarks

Configuration data that you store in the configuration file for your custom extension takes the form of a Configuration element. The Configuration element is a child element of the Extension element entry in the rsreportserver.config file. The XML structure used in the configuration file might look like the one in the following example:

<Extension Name="My Extension" Type="Microsoft.Samples.ReportingServices.MyExtension.ExtensionClass,Microsoft.Samples.ReportingServices.MyExtension">  
   <Configuration>  
      <MyExtensionConfigurationData>  
         <MyExtensionData1>Value</MyExtensionData1>  
         <MyExtensionData2>Value</MyExtensionData2>  
      </MyExtensionConfigurationData>  
   </Configuration>  
</Extension>  

If no Configuration element is present for an extension entry in the configuration file, Reporting Services sets the value of the configuration parameter to an empty string.

Note

The Configuration element is not passed into the configuration parameter. You should parse the inner XML of the Configuration element, if you want to process configuration data.

Applies to