IExtension.SetConfiguration(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.