Infra-estrutura da Web Part nos serviços SharePoint Windows

Web Parts em Windows SharePoint Services 3.0 baseiam-se em infra-estrutura de Microsoft ASP.NET 2.0 da Web Part. Para criar Web Parts para aplicativos como alvo Windows SharePoint Services, você deve compilar personalizado Web Parts em parte superior da infra-estrutura de ASP.NET Web Part. No entanto, em um poucos casos, talvez seja necessário criar Web Parts que suporte Windows SharePoint Services recursos que não estão disponível na infra-estrutura de ASP.NET Web Part. Para obter mais informações, consulte " Para Derive da Windows SharePoint serviços Class" neste tópico.

Modelo de herança Parte da Web nos Serviços SharePoint Windows

O Windows SharePoint Services 3.0 WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe tem sido rebased para herdar da Microsoft ASP.NET 2.0 WebPart classe, fornecendo uma camada compatibilidade para garantir que Web Parts escritos para trabalho Windows SharePoint Services 2,0 wssversion2short em Windows SharePoint Services 3.0 sem modificação. Ela existe principalmente for the Purpose of compatibilidade com versões anteriores e secondarily, para fornecer um pequeno conjunto de recursos que não estão disponível na ASP.NET WebPart classe.

Observação

O Windows SharePoint Services WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe é parte da infra-estrutura de Web Parts que foi desenvolvida especificamente para sites Windows SharePoint Services 2,0 wssversion2short.

O seguinte diagrama mostra a hierarquia herança para o Windows SharePoint Services WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe.

Controles principais para Páginas de Web Parts

A seguinte seção descreve os controles núcleo para Páginas de Web Parts para Web Parts SharePoint-Based e Web Parts ASP.NET 2.0.

Web Parts SharePoint-based

A infra estrutura de Web Parts Windows SharePoint Services 3.0 wssversion3 usa muitos dos controles no conjunto de controle de ASP.NET 2.0 Web Parts, bem como apresenta vários de seus próprios controles que herdam classes de base fornecidas pelo conjunto de controle Web Parts ASP.NET 2.0.

De exemplo, páginas de Web Parts para um site Windows SharePoint Services wssnoversshort não use o padrão ASP.NET WebPartManager. Em vez disso, eles use o específicas dos serviços Windows SharePoint SPWebPartManager que herda a partir de ASP.NET WebPartManager. O seguinte definir mostra o herança de classe WebPartManager WebPartManager.

Da mesma forma, as Páginas de Web Parts para um site Windows SharePoint Services wssnoversshort também usar específicas dos serviços Windows SharePoint WebPartZone que herda a partir de ASP.NET WebPartZone.

Web Parts ASP.NET

A infra-estrutura se baseia uma WebPartManager WebPartManager classe que gerencia a tempo de vida de Web Part ASP.NET Web Part instâncias em tempo de execução.

Cada página ASP.NET que usa controles Web Part deve conter:

• Exatamente um objeto WebPartManager que controla que foram adicionados para cada zona específica, Web Parts e armazena e recupera dados sobre como cada Web Part tenha sido personalizado e personalizadas.

• Um ou mais WebPartZone objetos, no qual Web Parts são colocados.

Para executar Web Parts em um aplicativo ASP.NET 2.0, você deve criar uma página .aspx que contém exatamente uma instância de um ou mais controles WebPartManager e o controle WebPartZone WebPartManager. O WebPartManager é responsável por a serialização de Web Parts-relacionado dados, bem como armazenar e recuperá-los a partir de banco de dados Serviços.

A página .aspx servir como uma Página de Web Parts pode conter partes editor que permitem aos usuários personalizar e individualizar persistentes propriedades da Web Part. As Páginas de Web Parts também podem conter partes do catálogo que permitem aos usuários adicionar novos Web Parts em zonas. Windows SharePoint Services 3.0 faz o trabalho para adicionar o catálogo e editor partes para você, so that você não precisará explicitamente fazer isso em um designer página da Web. O seguinte definir mostra o herança de classe WebPartZone WebPartZone.

O SPWebPartManager e gerenciar controles WebPartZone T:Microsoft.SharePoint.WebPartPages.WebPartZone a serialização de dados associado com Web Parts para o apropriado de conteúdo Windows SharePoint Services banco de dados. Para poder dados persistir, o ASP.NET Web Parts deve ser colocado em uma página com esses dois controles.

Como esses controles específicos dos serviços Windows SharePoint são exigido nas páginas que contêm Web Parts, não é possível simplesmente copiar seu página ASP.NET em um site Windows SharePoint Services wssnoversshort. Para mover ASP.NET Web Parts de um aplicativo ASP.NET para um aplicativo Windows SharePoint Services wssnoversshort, você deve exportá-los do .NET ASP e importação-los em um site Windows SharePoint Services wssnoversshort.

Observação

O página mestra usar como padrão que é fornecido com o Windows SharePoint Services tecnologia inclui uma instância de SPWebPartManager, portanto, esse controle é automaticamente incluído todas as sua de conteúdo Windows SharePoint Services wssnoversshort páginas.

Diferenças no comportamento da Web Part entre Windows SharePoint Services 2.0 e 3.0 serviços SharePoint Windows

A equipe Windows SharePoint Services wssnoversshort está para comprimentos excelentes para garantir que o Windows SharePoint Services 2,0 Web Parts trabalho perfeitamente em Windows SharePoint Services 3.0. Há um pequeno número de ocorrências, no entanto, no qual o Windows SharePoint Services 2,0 Web Parts podem se comportar de maneira diferente. Esses incluem:

• Em Windows SharePoint Services 2,0, foram Web Parts gerenciado por zonas; No entanto, em Windows SharePoint Services 3.0, Web Parts são gerenciado pelo SPWebPartManager. If you use a Web Part's Parent property, you get a reference to SPWebPartManager rather than a reference to the containing WebPartZone.

• Em Windows SharePoint Services 2,0, o provedor e consumidor Web Parts podem ter múltiplo conexões. Em Windows SharePoint Services 3.0, a parte provedor pode ter múltiplo conexões, mas a parte consumidor pode ter apenas uma conexão (mesmo que controles de Web Part ASP.NET 2.0). Você pode replicar comportamento Windows SharePoint Services 2,0 wssversion2short, no entanto, especificando UnlimitedConnections no consumidor Web Part.

Quando a Derive da classe WebPart Windows SharePoint de serviços

Em um poucos casos, talvez seja necessário criar Web Parts que suporte Windows SharePoint Services recursos que não estão disponível na infra-estrutura de ASP.NET Web Part. Nesses casos, você pode criar uma classe que herda a partir de classe base Windows SharePoint Services wssnoversshort WebPart T:Microsoft.SharePoint.WebPartPages.WebPart. Web Parts such as estes são conhecidos como Web Parts SharePoint-based e pode ser usada somente em sites SharePoint.

A lista de recursos fornecidos exclusivamente pelo Windows SharePoint Services WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe Veja a seguir:

• Cruz conexões página

• As conexões entre Web Parts que são outside of uma zona Web Part

• Conexões de cliente-lateral (da Web Part da página de serviços Component)

• Uma infra-estrutura armazenamento de dados no cache que permite cache para o de conteúdo banco de dados

Outro motivo você pode considerar a derivação a partir de WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe é relacionado para criar novas versões do seu Web Parts. Se o original de Web Parts derivado da classe WebPart T:Microsoft.SharePoint.WebPartPages.WebPart e você desejar para atualizar instâncias do que Web Part para uma versão nova e, em seguida, a nova versão do Web Part também devem derivar do SharePoint WebPart T:Microsoft.SharePoint.WebPartPages.WebPart classe.

Consulte também

Conceitos

Visão geral sobre Web Parts
Desenvolvendo Web Parts nos serviços SharePoint Windows

Outros recursos

N:Microsoft.SharePoint.WebPartPages
ASP .NET Web Parts Control Set Overview
Discover Significant Developer Improvements in SharePoint Services