Criando um Controle Web Parts Vinculado a Dados
Por herança, a partir da classe base WebPart, você pode fornecer recursos Web Parts a um controle de servidor comum vinculados a dados.Em aplicativos Web Parts, os usuários finais são capazes modificar (personalizar) o comportamento e a interface do usuário (UI) de controles do servidor, e tem suas configurações salvas no armazenamento a longo prazo para sessões futuras do navegador.Os usuários podem alterar radicalmente a aparência de uma página adicionando ou removendo os controles, editando as propriedades e a aparência dos controles, reorganizando o layout da página, importando ou exportando as configurações para os controles e até mesmo formando conexões que ativam controles para compartilhar dados.Para saber mais sobre aplicativos Web Parts, consulte os tópicos listados em ASP.NET Web Parts Controls.Este tópico descreve os pré-requisitos para usar um controle WebPart (ou qualquer controle de servidor) personalizado, ligado a dados em um aplicativo Web Parts e resume alguns membros da classe base WebPart que são geralmente úteis para implementar ou substituir ao criar um controle personalizado.Um exemplo de substituição e implementação de alguns desses membros é fornecido no tópico Exemplo do Controle Web Parts com Dados Vinculados.
Elementos Necessários para usar um Controle Web Parts
Nenhum controle de Web Parts pode executar isoladamente e ainda manter seus recursos Web Parts.Se você executar um controle WebPart em um aplicativo da Web sem os outros elementos necessários para um aplicativo Web Parts, o controle simplesmente perde seus recursos Web Parts e funciona como um controle de servidor comum.A lista a seguir explica os elementos necessários que devem estar no local antes de usar um controle WebPart personalizado com recursos Web Parts:
O controle WebPartManager.Este controle deve estar presente em todas as páginas que oferecem funcionalidade Web Parts.Para obter detalhes, consulte:Visão Geral do Conjunto de Controle Web Parts.
Um controle de zona WebPartZoneBase.Uma página da Web deve ter uma zona que deriva dessa classe abstrata, como o controle WebPartZone, para conter os controles WebPart.Para obter detalhes, consulte:Visão Geral do Conjunto de Controle Web Parts.
Um site ASP.NET que possa reconhecer usuários individuais, usando a autenticação do Windows ou formulários.Para detalhes na criação de um diretório virtual ou site, consulte Como: Criar e configurar diretórios virtual no IIS 5.0 e 6.0 ou Como: Criar e configurar local Web sites do ASP.NET no IIS 6.0.
O provedor de personalização configurado e o banco de dados, para armazenar configurações de usuário em controles.Personalização de Web Parts é ativada por padrão e usa o provedor de personalização SQL (SqlPersonalizationProvider) com a edição do Microsoft SQL Server Express (SSE) para armazenar os dados de personalização.This walkthrough uses SSE and the default SQL provider.Se você tiver o SSE instalado, nenhuma configuração será necessária.SSE está disponível com Microsoft Visual Studio 2005 sistema autônomo uma parte opcional da instalação ou sistema autônomo um baixar gratuito do Microsoft.com.Para usar uma das versões completas do Microsoft SQL Server, você deve instalar e configurar um banco de dados um aplicativo ASP.NET com serviços de banco de dados e configurar o provedor personalizado para se conectar a esse banco de dados..Para obter detalhes, consulte:Criando e Configurando o Banco de Dados dos Serviços de Aplicativos para o SQL Server.Você também pode criar e configurar um provedor personalizado para uso com outros bancos de dados não SQL ou soluções de armazenamento.Para obter detalhes e um exemplo de código, consulte Implementando um Provedor de Associação.
Membros de WebPart Comumente Substituídos ou Usados
Embora qualquer tipo de controle de servidor possa ser usado em aplicativos Web Parts, há alguns benefícios para a criação de controles WebPart personalizados (para obter detalhes, consulte Usando controles do servidor ASP.NET em aplicativos Web Parts).Quando você herda da classe base WebPart, não há membros necessários para implementar.No entanto, há alguns membros comumente usados que você pode querer usar ou substituir, e esses estão resumidos na tabela a seguir.Para obter um exemplo completo de uma controle de servidor vinculados a dados implementado como um controle WebPart, consulte Exemplo do Controle Web Parts com Dados Vinculados.A tabela a seguir resume alguns dos membros comumente usados.
Membro |
Descrição |
|---|---|
Um uso comum para esse construtor é definir valores padrão em algumas das propriedades que determinam a aparência e o comportamento de um controle WebPart, como as propriedades herdadas da classe Part, ou propriedades comportamentais, como as propriedades AllowEdit e AllowLayoutChange. |
|
Propriedades comportamentais |
Isso inclui um número de propriedades "permitidas" de classe, como AllowClose, AllowConnect, AllowEdit, AllowMinimize, AllowLayoutChange e AllowZoneChange.Em vez de simplesmente atribuir valores padrão para essas propriedades no construtor, os desenvolvedores podem controlar completamente uma propriedade, por exemplo, impedindo que usuários ou desenvolvedores que usam o controle nunca sejam capazes de fechar o controle. |
Quando você herda da classe WebPart, você precisa fornecer uma interface de usuário para seu controle personalizado.Uma maneira muito eficiente de fazer isso é substituir o método CreateChildControls e, nesse método, adicionar outros controles de servidor para fazer a interface de usuário de seu controle personalizado.Talvez seja necessário executar tarefas adicionais quando você adicionar esses controles, como criar manipuladores de eventos personalizados para eles, ou vinculá-los a uma fonte de dados. |
|
Métodos de Processamento |
Talvez você precise substituir os métodos de processamento comuns, como RenderControl ou RenderContents.Nesses métodos, você pode substituir completamente o processamento, ou chamar o método base primeiro e então modificar algum aspecto do processamento. |
Se você criar objetos WebPartVerb personalizados que serão exibidos sobre o menu de verbos de seu controle com os verbos padrão (como minimizar e fechar), você deve adicioná-los à coleção Verbs de seu controle. |
|
Se você criar controles personalizados EditorPart, para permitir que os usuários possam editar as propriedades personalizadas em seu controle, você deve associá-los com seu controle substituindo o método CreateEditorParts.Por exemplo, consulte a interface IWebEditable. |
|
Ao criar propriedades personalizadas no seu controle WebPart, você irá geralmente querer que os usuários possam editar e personalizar essas propriedades, assim como as propriedades de controle padrão WebPart, para que suas configurações possam ser salvas.Adicione o atributo Personalizable de metadados para qualquer propriedade que os usuários possam personalizar. |
Exemplo de Controle WebPart Vinculado a Dados
Para um exemplo de código completo que demonstra como criar um controle GridView que vincula ao banco de dados Northwind e implementa o controle como um controle WebPart, consulte Exemplo do Controle Web Parts com Dados Vinculados.
Consulte também
Tarefas
Demonstra Passo a passo: Criação de uma página de Web Parts
Conceitos
Visão geral sobre Web Parts do ASP.NET