Compartilhar via

  • Artigo

Implementando a interface ISubscriptionBaseUIUserControl para uma extensão de entrega

As extensões de entrega do Reporting Services podem conter uma implementação de uma interface do usuário de assinatura para a obtenção de informações específicas da extensão no Gerenciador de Relatórios. A interface do usuário é invocada quando um usuário cria uma assinatura nova ou modifica uma existente. Quando uma assinatura nova é criada, a interface do usuário exibe valores padrão adequados e permite que os usuários interajam com o provedor de entrega. Quando uma assinatura é modificada, a interface do usuário é preenchida previamente com as informações da assinatura atual.

As extensões de entrega oferecem a interface do usuário de assinatura como um controle de usuário do ASP.NET. O servidor de relatório incorpora o controle de usuário definido pela extensão de entrega ao exibir a interface do usuário de assinatura. A interface base que oferece métodos abstratos habilitando esta funcionalidade é a interface ISubscriptionBaseUIUserControl. Esta interface garante que as operações comuns, como a validação de valores de entrada, sejam executadas corretamente. Adicionalmente, o controle de usuário base oferece um conjunto de propriedades padrão usadas pelo servidor de relatório para consistência entre assinaturas. Essas propriedades são obrigatórias para extensões de entrega integradas ao Gerenciador de Relatórios.

Você pode implementar a interface ISubscriptionBaseUIUserControl em um provedor de entrega para criar uma interface do usuário de assinatura para o Gerenciador de Relatórios. A interface ISubscriptionBaseUIUserControl oferece infraestrutura para permitir que os usuários insiram valores para configurações de assinatura, para o processamento das configurações necessárias à extensão de entrega e para a validação das configurações.

ObservaçãoObservação

Você não é obrigado a implementar a interface ISubscriptionBaseUIUserControl como parte de sua extensão de entrega. As assinaturas que usam sua extensão de entrega podem sempre ser criadas pelos métodos da API SOAP CreateSubscription e CreateDataDrivenSubscription. Para obter mais informações sobre os recursos API SOAP para o gerenciamento de assinaturas e para entrega, consulte Métodos de assinatura e de entrega.

A interface ISubscriptionBaseUIUserControl estende IExtension. O seu controle de usuário que implementa ISubscriptionBaseUIUserControl também deve herdar de System.Web.UI.WebControls.WebControl. Para obter mais informações sobre a classe WebControl, consulte o Guia do Desenvolvedor do seu Microsoft .NET Framework.

Para obter um exemplo de como usar a interface ISubscriptionBaseUIUserControl, consulte SQL Server Reporting Services Product Samples (em inglês).