Практическое руководство. Объявление статического соединения между двумя элементами управления веб-частей

Статья
10/22/2014

Обновлен: Ноябрь 2007

Разработчики могут создавать статическое соединение веб-частей между двумя элементами управление серверов, объявив соединение в формате сохранения страницы. Статическое соединение, подобно объявленному элементу управления, становится на веб-странице постоянным объектом. Просматривать данные соединения могут все пользователи (поскольку его представляет общий объект). Пользователи не могут удалить объект соединения, но могут отключить его, если позволяет пользовательский интерфейс. Статические соединения хорошо подходят в ситуации, когда нужно, чтобы они были всегда доступны всем пользователям, и чтобы пользователи не могли удалить их со страницы. Более подробные сведения о соединениях см. в разделах WebPartConnection и Общие сведения о подключениях веб-частей. Более подробные сведения о статических соединениях см. в разделе IsStatic. В этом разделе проиллюстрировано создание статического соединения между двумя элементами управления WebPart.

Примечание.
В этом разделе описывается объявление статического соединения в разметке веб-страницы. Для того чтобы объявить статическое соединение веб-частей между двумя серверными элементами управления, эти элементы управления должны правильно обрабатывать соединения и находиться в зоне WebPartZoneBase. Полное описание требований к элементам управления, которые участвуют в соединениях, см. в разделе WebPartConnection. Пример кода для двух элементов управления WebPart и веб-страницы со статическим соединением, описанным в этом разделе, см. в разделе «Пример»; там же описано свойство IsStatic.

В этом разделе описывается объявление статического соединения в разметке веб-страницы. Для того чтобы объявить статическое соединение веб-частей между двумя серверными элементами управления, эти элементы управления должны правильно обрабатывать соединения и находиться в зоне WebPartZoneBase. Полное описание требований к элементам управления, которые участвуют в соединениях, см. в разделе WebPartConnection. Пример кода для двух элементов управления WebPart и веб-страницы со статическим соединением, описанным в этом разделе, см. в разделе «Пример»; там же описано свойство IsStatic.

Объявление серверных элементов управления в зоне

Добавьте в основной раздел веб-страницы, где будет находиться соединение, элемент <webpartzone>, а также дочерний элемент <zonetemplate>, который будет содержать серверные элементы управления, добавляемые в зону. В примере ниже показано, как должен выглядеть код.
```
<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Объявите в тегах элемента <zonetemplate> серверные элементы управления, которые будут играть роль поставщика и потребителя в соединении веб-частей. Эти элементы управления должны заранее быть созданы так, чтобы они могли участвовать в соединении. В зону можно также добавить другие серверные элементы управления. Как уже упоминалось выше в этом разделе, элементы управления, объявленные в этом примере, взяты из примера кода, иллюстрирующего свойство IsStatic. Полный код зоны с серверными элементами управления выглядит следующим образом.
```
<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
    <aspSample:ZipCodeWebPart ID="zip1" runat="server"
       Title="ZIP Code Provider"  />
    <aspSample:WeatherWebPart ID="weather1" runat="server" 
       Title="ZIP Code Consumer" />
  </ZoneTemplate>
</asp:WebPartZone> 
```

Объявление статического соединения

Веб-страница уже должна содержать элемент <asp:webpartmanager>, наличие которого необходимо на страницах, на которых используются элементы управления веб-частей. Добавьте элемент <staticconnections> в качестве потомка элемента <asp:webpartmanager> для размещения объявленных статических соединений. В примере ниже показано, как должен выглядеть код.
```
<asp:WebPartManager ID="mgr" runat="server" >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
Объявите в элементе <staticconnections> элемент <asp:webpartconnection>. Вдобавок к атрибутамid и runat в соединении необходимо задать приведенные ниже обязательные атрибуты.
- ConsumerID — идентификатор элемента управления получателя в соединении.
- ConsumerConnectionPointID — идентификатор специального метода обратного вызова в получателе, с помощью которого устанавливается соединение. Этот атрибут необходим только при наличии у получателя нескольких точек подключения. Дополнительные сведения о точках подключения см. в описании класса ConnectionPoint.
- ProviderID — идентификатор элемента управления поставщика в соединении.
- ProviderConnectionPointID — идентификатор специального метода обратного вызова в поставщике, с помощью которого устанавливается соединение. Этот атрибут необходим только при наличии у поставщика нескольких точек подключения.
Ниже приведен пример того, как должен выглядеть полный код элемента <asp:webpartmanager> и дочернего статического соединения.
```
<asp:WebPartManager ID="mgr" runat="server" >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

См. также

Основные понятия

Общие сведения о подключениях веб-частей

Общие сведения о веб-частях ASP.NET

Ссылки

WebPartConnection

IsStatic

Поделиться через