Como: Declarar uma conexão estático entre dois controles Web Parts

Artigo
10/15/2014

Os desenvolvedores podem criar uma conexão de Web Parts entre dois controles de servidor, declarando a conexão no formato de persistência na página estática.Se uma conexão estática torna-se um objeto em uma página da Web, como um controle declarado permanente.Todos os usuários podem ver uma conexão estática (porque ele é um objeto compartilhado), e eles não podem excluir o objeto de conexão, embora eles possam desconectar-se se fornecido com opção para a Interface do Usuário (UI) fazer isso.Conexões estáticas são uma boa opção quando você desejar que uma conexão esteja sempre disponível para todos os usuários, e você não desejar que usuários devam ter a opção de excluí-la a partir da página.Para obter detalhes sobre conexões, consulte WebPartConnection e Visão Geral Sobre as Conexões do Web Parts.Para obter detalhes sobre conexões, consulte IsStatic.Este tópico demonstra como criar uma conexão estática entre dois controles WebPart.

Observação:
Este tópico concentra-se na exibição como declarar uma conexão estática na marcação de uma página da Web.Para declarar uma conexão estática de Web Parts entre dois controles de servidor, os controles devem ser corretamente projetados para manipular conexões, e eles devem ficar em uma zona WebPartZoneBase.Para obter uma descrição completa dos requisitos de controles que participem de conexões, consulte WebPartConnection.Para obter o exemplo de código para os dois controles WebPart e a página da Web usada para hospedar a conexão estática que é demonstrada neste tópico, consulte a seção exemplo para a propriedade IsStatic.

Este tópico concentra-se na exibição como declarar uma conexão estática na marcação de uma página da Web.Para declarar uma conexão estática de Web Parts entre dois controles de servidor, os controles devem ser corretamente projetados para manipular conexões, e eles devem ficar em uma zona WebPartZoneBase.Para obter uma descrição completa dos requisitos de controles que participem de conexões, consulte WebPartConnection.Para obter o exemplo de código para os dois controles WebPart e a página da Web usada para hospedar a conexão estática que é demonstrada neste tópico, consulte a seção exemplo para a propriedade IsStatic.

Para declarar os controles do servidor dentro de uma zona

Adicione um elemento <webpartzone> dentro da seção de corpo de uma página da Web que conterá a conexão, e adicione um elemento filho <zonetemplate> para conter os controles de servidor que você irá adicionar à zona.O código deve ter aparência do exemplo a seguir.
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Entre as marcas do elemento <zonetemplate>, declare os controles de servidor que atuarão como o provedor de servidor e os controles do consumidor em uma conexão de Web Parts.Esses controles já devem ser criados para participar de conexões.Você também pode adicionar outros controles de servidor para a zona.Conforme observado anteriormente neste tópico, os controles declarados nesse exemplo são obtidos do código de exemplo encontrado na propriedade IsStatic.O código para a zona inteira com os controles de servidor é semelhante ao seguinte.
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
    <aspSample:ZipCodeWebPart ID="zip1" 
       Title="ZIP Code Provider"  />
    <aspSample:WeatherWebPart ID="weather1"  
       Title="ZIP Code Consumer" />
  </ZoneTemplate>
</asp:WebPartZone> 
```

Para declarar uma conexão estática

Sua página da Web deve ter um elemento <asp:webpartmanager>, que é necessário em páginas que usam controles Web Parts.Adicione um elemento <staticconnections> como um filho do elemento <asp:webpartmanager> para conter uma ou mais conexões estáticas declaradas.O código deve ter aparência do exemplo a seguir.
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
Dentro do elemento <staticconnections>, declare um elemento <asp:webpartconnection>.Para a conexão, você deve especificar os seguintes atributos necessários, além dos atributos id e runat:
- ConsumerID - Indica a identificação do controle consumidor da conexão.
- ConsumerConnectionPointID - indica a identificação de um método de chamada especial no consumidor usado para estabelecer a conexão.Esse atributo é necessário somente se o consumidor tiver mais de um ponto de conexão.Para obter detalhes sobre pontos de conexão, consulte ConnectionPoint.
- ProviderID - Indica a identificação do controle do provedor na conexão.
- ProviderConnectionPointID - Indica a identificação de um método de chamada especial no provedor usado para estabelecer a conexão.Este atributo é necessário apenas se o provedor tem mais de um ponto de conexão.
O código completo para o elemento <asp:webpartmanager> e a conexão estática filha devem ter a aparência do exemplo a seguir.
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

Consulte também

Conceitos

Visão Geral Sobre as Conexões do Web Parts

Visão geral sobre Web Parts do ASP.NET

Referência

WebPartConnection

IsStatic

Partilhar via