Carregar peças Web para um catálogo em tempo de execução

Bem-vindo à coluna voz de suporte ASP.NET! Sou Jerry Orman. Foram com a Microsoft por mais de cinco anos e ter gasto a maior parte do meu tempo concentrado em tecnologias relacionadas com a Web como o Microsoft FrontPage e Microsoft SharePoint Products and Technologies. Gastou o ano passado a trabalhar com o Microsoft ASP.NET como um engenheiro de suporte.

ASP.NET 2.0 introduz a estrutura de peça Web fora do ambiente do SharePoint. Isto permite aos programadores criar aplicações que são configuráveis pelo utilizador em tempo de execução. A classe CatalogPart é utilizada para fornecer uma lista de peças Web aos utilizadores em tempo de execução. Fora da caixa, o ASP.NET 2.0 não fornece um catálogo é preenchido em tempo de execução. Esta coluna voz de suporte irá explica como criar um catálogo personalizado com este objectivo.

Fora da caixa, o ASP.NET 2.0 fornece os seguintes catálogos:

• DeclarativeCatalogPart
  Esta classe permite-lhe adicionar forma declarativa as peças Web para uma página .aspx no momento da concepção. Também pode definir a propriedade WebPartsListUserControlPath e aponte para um controlo de utilizador (.ascx) que tem de forma declarativa adicionada no momento da estruturação de peças Web. Para mais informações, visite o seguinte Web site da Microsoft Developer Network (MSDN):
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.declarativecatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.declarativecatalogpart.aspx)
• PageCatalogPart
  Esta classe apresenta peças Web que foram fechados por um utilizador. Para mais informações, visite o seguinte site da Web MSDN:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.pagecatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.pagecatalogpart.aspx)
• ImportCatalogPart
  Esta classe permite-lhe importar uma peça Web que ter exportado. Exportar uma peça Web permite-lhe preservar as definições, que é útil para peças Web altamente personalizada. Para mais informações, visite o seguinte site da Web MSDN:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.importcatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.importcatalogpart.aspx)

Assim, como pode ver, há nada fora da caixa que lhe permitirá abandonar dll para uma pasta e peça-lhes obter recolhida como peças Web em tempo de execução. Para efectuar este procedimento, terá de criar uma classe CatalogPart personalizada e substituir os seguintes métodos:

• GetAvailableWebPartDescriptions
  Este método devolve as descrições de peça Web utilizadas para preencher o catálogo no CatalogZone . Neste exemplo, utilizaremos reflexão neste método para carregar as DLLs e determinar se contêm peças Web. Para mais informações, visite o seguinte site da Web MSDN:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getavailablewebpartdescriptions.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getavailablewebpartdescriptions.aspx)
• GetWebPart
  Este método devolve as peças Web real a compor na página. Se não processar a preencher a colecção que devolve a peça Web correctamente, o catálogo irá compor e apresentar as descrições, mas adicionar uma peça Web para uma WebPartZone não fará nada. Para mais informações, visite o seguinte site da Web MSDN:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getwebpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getwebpart.aspx)

O exemplo seguinte demonstra como criar um catálogo personalizado que utiliza reflexão para preencher a lista de peças Web em tempo de execução. Este exemplo é fornecido como está e destina-se apenas a fins de demonstração. O ficheiro seguinte está disponível para transferência a partir do Centro de transferências da Microsoft:

Download the CustomCatalogSample.exe package now. (http://download.microsoft.com/download/c/8/0/c8034014-ab56-42b5-bd8e-d2d49c2d0dca/customcatalogsample.exe)

Para obter mais informações sobre como transferir ficheiros de suporte da Microsoft, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base: Microsoft procedeu de vírus neste ficheiro. Microsoft utilizou o mais recente software de detecção de vírus que estava disponível na data em que o ficheiro foi publicado. O ficheiro é alojado em servidores com segurança avançada o que ajuda a impedir alterações não autorizadas ao ficheiro.

Microsoft vai percorra os projectos de exemplo para que poder obter uma ideia de que está a colocar no. O código é totalmente comentado, qual deve efectuar para alguns leitura excelente.

O exemplo inclui três projectos:

• Projecto de classe MyControls
  • ReflectionCatalogPart
    Esta é a classe funciona para o catálogo.
• Projecto de classe SampleWebParts
  • RSSPart.cs
    Esta é uma peça Web que escreveu que irá sair e obter dados a partir de um RSS2 feed. Adicionar mais informações, poderia a este mais para adicionar modelos diferentes e colocação em cache.
  • FeaturedProductPart.cs ICategoryInterface.cs e SelectCategory.cs
    Estas são a partir do seguinte artigo da MSDN:
    http://msdn2.microsoft.com/en-us/library/ms379628(VS.80).aspx (http://msdn2.microsoft.com/en-us/library/ms379628(VS.80).aspx)
    É incluído aqui para adicionar mais informações ao lista de Web peças.
• Site CustomParts
  • Default.aspx
    Este ficheiro unidades de exemplo. Tem todos os vários catálogos e partes já foi declarados na página.
  MyControls
  • CatalogTemplate.ascx
    Este ficheiro é utilizado na propriedade WebPartsListUserControlPath da classe DeclarativeCatalogPart para demonstram a utilização dessa propriedade.
  • ReportGenerator.ascx
    Este ficheiro tem um controlo de GridView para mostrar a utilização de um ficheiro .ascx como uma peça Web. (Qualquer controlo que não é uma peça Web é moldado na classe GenericWebPart quando é colocado numa WebPartZone .)
  
  

Para utilizar o exemplo, siga estes passos:

1. Abra o site CustomParts Web como um projecto com base em ficheiros no Microsoft Visual Studio 2005.
2. Adicionar o projecto de classe MyControls e o SampleWebParts classe projecto como projectos para a solução. Para o fazer, clique em ficheiro , clique em Adicionar e, em seguida, clique em Projecto existente .
3. Expanda CustomParts Web Site .
4. Faça duplo clique no ficheiro Web.config.
5. Altere a cadeia de ligação para apontar para a instância do Microsoft SQL Server que hospeda a base de dados Adamastor.
6. Localize o ficheiro default.aspx.
7. Clique em início de sessão .
8. Iniciar sessão escrevendo BobSmith e a palavra-passe BobSmith! .
9. No menu Modificar peças Web , clique em catálogo .
   
   Vai ter dois catálogos, o catálogo de Peças de reflexão e o catálogo de Peças declarativa .

Pode ver o ficheiro ReflectionCatalogPart.cs na classe MyControls e na secção asp: CatalogZone no ficheiro default.aspx para ver como funciona o catálogo personalizado. Em geral, verifica para determinar se existe um HttpContext e, em seguida, utiliza reflexão para preencher e cache de peças Web que estão disponíveis na pasta /bin. Pode adicionar peças Web adicionando a DLL na pasta /bin. Isto irá desencadear uma Reciclagem de domínio de aplicação , que irá limpar a cache e permitir que o catálogo para preenchê-la novamente no carregamento seguinte.

Agora que tem um exemplo que demonstram como preencher o catálogo utilizando reflexão, pode tirar partido para criar catálogos poderão adequar às suas necessidades.

Como sempre, vontade submeter ideias tópicos que pretende no futuro corrigida colunas ou na base de dados de conhecimento utilizando o formulário Ask For It (http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=) .