IDeliveryExtension.ExtensionSettings Property

Article
12/03/2008

Gets a list of settings that are used by the delivery extension to create a notification or report.

Namespace: Microsoft.ReportingServices.Interfaces
Assembly: Microsoft.ReportingServices.Interfaces (in microsoft.reportingservices.interfaces.dll)

Syntax

'Declaration
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey:="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
ReadOnly Property ExtensionSettings As Setting()

[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
Setting[] ExtensionSettings { get; }

[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey=L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
property array<Setting^>^ ExtensionSettings {
    array<Setting^>^ get ();
}

/** @property */
/** @attribute StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8") */ 
Setting[] get_ExtensionSettings ()

function get ExtensionSettings () : Setting[]

Property Value

The settings of a delivery extension.

Remarks

Delivery extensions must implement the ExtensionSettings property. The report server uses the value returned by the ExtensionSettings property to evaluate the settings that a delivery extension requires. Clients that interact with delivery extensions use the GetExtensionSettings method of the Web service to return a list of settings for the delivery extension. If this method is not properly implemented, clients cannot retrieve a list of settings for the extension and therefore cannot retrieve the necessary information to use the delivery extension in subscriptions.

Example

The following code example returns settings that might be used in a delivery provider that sends reports to a printer.

Visual Basic implementation not available for this release.

private Setting[] m_settings = null;
// Public property implementation
public Setting[] ExtensionSettings
{
   get
   {
      if (m_settings == null)
      {
         m_settings = new Setting[3];
         m_settings[0] = new Setting();
         m_settings[0].Name = SubscriptionData.PRINTER;
         m_settings[0].ReadOnly = false;
         m_settings[0].Required = true;

         // Add the printer names that were retrieved from the 
         // configuration file to the set of valid values for
         // the setting
         foreach (string printer in m_printers)
         {
            m_settings[0].AddValidValue(printer.ToString(), printer.ToString());
         }

         // Setting for page height
         m_settings[1] = new Setting();
         m_settings[1].Name = SubscriptionData.PAGEHEIGHT;
         m_settings[1].ReadOnly = false;
         m_settings[1].Required = true;
         m_settings[1].Value = "11";

         // Setting for page width
         m_settings[2] = new Setting();
         m_settings[2].Name = SubscriptionData.PAGEWIDTH;
         m_settings[2].ReadOnly = false;
         m_settings[2].Required = true;
         m_settings[2].Value = "8.5";
      }

      return m_settings;
   }
}

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms