Como: Criar propriedades personalizable em um controle de Web Parts

Um dos recursos principais do conjunto de controles de Web Parts é a capacidade para personalizar controles em uma página.Isso permite que o usuário final defina valores de propriedade que permanecem com aquele usuário sempre que ele ou ela exibe a página.

Desenvolvedores de página podem habilitar personalização aplicando uma propriedade pública de um controle de Web Parts ao atributo Personalizable.O controle pode ser uma controle personalizado herdado do WebPart, um controle de usuário ou qualquer outro controle em que você pode criar uma propriedade, desde que ele resida em uma zona WebPartZone e seja um controle WebPartManager em algum lugar na página.

Observação:

Para este procedimento funcionar, é necessário um site da Web ASP.NET que possa identificar usuários individuais.Se você tiver um site já configurado, você pode usá-lo.Caso contrário, para detalhes na criação de um diretório virtual ou site, veja Como: Criar e configurar diretórios virtual no IIS 5.0 e 6.0. Você também precisa de um provedor de personalização configurado e banco de dados.Personalização de Web Parts é habilitado por padrão; se você tiver o Microsoft SQL Server Express (SSE) instalado, nenhuma configuração é necessária.SSE está disponível com o Microsoft Visual Studio 2005 como uma parte opcional da instalação ou como um download gratuito a partir de Microsoft.com. Caso contrário, se você estiver usando uma versão completa do SQL Server, consulte Criando e Configurando o Banco de Dados dos Serviços de Aplicativos para o SQL Server, ou para um banco de dados não SQL ou solução de armazenamento, consulte Implementando um Provedor de Associação.

Para permitir personalização em um controle

1. Coloque o controle a ser personalizado dentro da zona WebPartZone na página Web Parts ASP.NET.A página deve conter um controle WebPartManager para controles de Partes Web para a função.Para obter mais informações, consulte Demonstra Passo a passo: Criação de uma página de Web Parts.

2. Na parte superior do bloco de código onde a propriedade que você deseja personalizar é definida, adicione o atributo Personalizable, conforme mostrado no exemplo a seguir.

   <Personalizable()>
   Property SampleProperty() As String
     Get…
     Set…
   End Property
   

   [Personalizable]
   Public string SampleProperty
   {
     Get{…}
     Set{…}
   }
   

Consulte também

Conceitos

Visão geral sobre personalização de Web Parts

Requisitos para usar personalização do Web Parts

Referência

System.Web.UI.WebControls.WebParts

Personalizable

Outros recursos

ASP.NET Web Parts Controls

Personalização das Web Parts