Cómo: Declarar una conexión estática entre dos controles de elementos Web

Artículo
10/22/2014

Actualización: noviembre 2007

Los desarrolladores pueden crear una conexión de elementos Web estática entre dos controles de servidor mediante la declaración de la conexión en formato de persistencia de las páginas. Una conexión estática se convierte en un objeto permanente en una página Web, como un control declarado. Todos los usuarios pueden ver una conexión estática (dado que es un objeto compartido) y ninguno puede eliminar el objeto de conexión, aunque tienen la posibilidad de desconectarlo si se les proporcionan las opciones correspondientes a través de la interfaz de usuario. Las conexiones estáticas constituyen una buena opción cuando se desea una conexión que esté siempre disponible para todos los usuarios, pero que los usuarios no puedan eliminar de la página. Para obtener información detallada sobre conexiones, vea WebPartConnection y Información general sobre conexiones a elementos Web. Para obtener información detallada sobre las conexiones estáticas, vea IsStatic. En este tema se muestra cómo crear una conexión estática entre dos controles WebPart.

Nota:
Este tema se centra en mostrar cómo se declara una conexión estática en el marcado de una página Web. Para declarar una conexión estática de elementos Web entre dos controles de servidor, éstos deben haber sido debidamente diseñados para controlar las conexiones y tienen que encontrarse en una zona WebPartZoneBase. Para obtener una descripción completa de los requisitos para los controles que participan en conexiones, vea WebPartConnection. Para obtener código de ejemplo relacionado con los dos controles WebPart y la página Web utilizada para alojar la conexión estática que se muestra en este tema, consulte en la sección Ejemplo la propiedad IsStatic.

Este tema se centra en mostrar cómo se declara una conexión estática en el marcado de una página Web. Para declarar una conexión estática de elementos Web entre dos controles de servidor, éstos deben haber sido debidamente diseñados para controlar las conexiones y tienen que encontrarse en una zona WebPartZoneBase. Para obtener una descripción completa de los requisitos para los controles que participan en conexiones, vea WebPartConnection. Para obtener código de ejemplo relacionado con los dos controles WebPart y la página Web utilizada para alojar la conexión estática que se muestra en este tema, consulte en la sección Ejemplo la propiedad IsStatic.

Para declarar controles de servidor dentro de una zona

Agregue un elemento <webpartzone> dentro de la sección del cuerpo de la página Web que va a contener la conexión; agregue un elemento <zonetemplate> secundario para que contenga los controles de servidor que desea agregar a la zona. El código debe tener la apariencia del ejemplo siguiente.
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Entre las etiquetas del elemento <zonetemplate>, declare los controles de servidor que van a actuar como controles de proveedor y consumidor en una conexión de elementos Web. Estos controles ya deben estar diseñados para participar en conexiones. También puede agregar otros controles de servidor a la zona. Tal como se observó anteriormente en este mismo tema, los controles declarados en el ejemplo se obtienen del código de ejemplo de la propiedad IsStatic. El código para toda la zona con los controles de servidor tiene una apariencia similar a la que se muestra a continuación.
```
<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 una conexión estática

La página Web ya debería tener un elemento <asp:webpartmanager>, necesario en páginas que utilizan controles de elementos Web. Agregue un elemento <staticconnections> como secundario del elemento <asp:webpartmanager> para que contenga una o varias conexiones estáticas declaradas. El código debe tener la apariencia del ejemplo siguiente.
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
Dentro del elemento <staticconnections>, declare un elemento <asp:webpartconnection>. Para la conexión debe especificar los siguientes atributos, que se necesitan junto con los atributos id y runat:
- ConsumerID: Indica el identificador del control del consumidor en la conexión.
- ConsumerConnectionPointID: Indica el identificador de un método especial de devolución de llamada en el consumidor que se utiliza para establecer la conexión. Se requiere este atributo sólo si el consumidor tiene más de un punto de conexión. Para obtener información detallada sobre los puntos de conexión, vea ConnectionPoint.
- ProviderID: Indica el identificador del control del proveedor en la conexión.
- ProviderConnectionPointID: Indica el identificador de un método especial de devolución de llamada en el proveedor que se utiliza para establecer la conexión. Se requiere este atributo sólo si el proveedor tiene más de un punto de conexión.
El código finalizado para el elemento <asp:webpartmanager> y la conexión estática secundaria deberían tener una apariencia similar a la del ejemplo que se muestra a continuación.
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

Vea también

Conceptos

Información general sobre conexiones a elementos Web

Información general sobre los elementos Web ASP.NET

Referencia

WebPartConnection

IsStatic

Compartir a través de