Esta documentación está archivada y no tiene mantenimiento.

WebPartManager.StaticConnections (Propiedad)

Obtiene una referencia a la colección de todos los objetos WebPartConnection de una página Web que se definen como conexiones estáticas.

Espacio de nombres: System.Web.UI.WebControls.WebParts
Ensamblado: System.Web (en system.web.dll)

public WebPartConnectionCollection StaticConnections { get; }
/** @property */
public WebPartConnectionCollection get_StaticConnections ()

public function get StaticConnections () : WebPartConnectionCollection

No aplicable.

Valor de propiedad

Colección WebPartConnectionCollection que contiene todas las conexiones estáticas de la página.

El control WebPartManager utiliza la propiedad StaticConnections para efectuar el seguimiento y administrar todas las conexiones estáticas en una página. Una conexión estática, a diferencia de una conexión dinámica, no tiene por qué agregarse a una página cada vez que se representa la página.

La colección a la que hace referencia esta propiedad contiene todas las conexiones estáticas que existen en la página, bien se hayan creado mediante programación o se hayan especificado con un elemento <asp:webpartconnection> en el formato de la página.

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad StaticConnections mediante programación.

El ejemplo de código tiene cuatro partes:

  • Un control de usuario que permite cambiar los modos de presentación en una página de elementos Web.

  • Un archivo de código fuente que contiene dos controles WebPart personalizados y una interfaz personalizada.

  • Una página Web que contiene dos controles WebPart personalizados que se pueden conectar y un elemento <asp:webpartmanager>.

  • Una explicación de cómo funciona el ejemplo en un explorador.

El código siguiente sólo contiene la parte de la página Web del ejemplo. También deberá obtener las dos primeras partes del ejemplo (el control de usuario personalizado y el código fuente para los controles personalizados y la interfaz) en la sección Ejemplo de la información general de la clase WebPartManager. En ese tema se explican también las opciones para compilar los controles WebPart.

La tercera parte del ejemplo de código es la página Web. El formato declarativo de la página contiene directivas Register para el control de usuario y los controles personalizados. Hay un elemento <asp:webpartmanager>, un elemento <asp:webpartzone> que contiene los controles personalizados y un elemento <asp:connectionszone>. Observe que en el método Page_Load, el código comprueba si ya existe una conexión y, si no existe, define un proveedor, un consumidor y sus respectivos puntos de conexión, y después agrega una nueva conexión al conjunto de conexiones estáticas al que hace referencia la propiedad StaticConnections.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    
    // Define provider, consumer, and connection points.
    WebPart provider = mgr.WebParts["zip1"];
    ProviderConnectionPoint provConnPoint =
      mgr.GetProviderConnectionPoints(provider)["ZipCodeProvider"];
    WebPart consumer = mgr.WebParts["weather1"];
    ConsumerConnectionPoint consConnPoint =
      mgr.GetConsumerConnectionPoints(consumer)["ZipCodeConsumer"];
    
    // Check whether the connection already exists.
    if (mgr.CanConnectWebParts(provider, provConnPoint,
      consumer, consConnPoint))
    {
      // Create a new static connection.
      WebPartConnection conn = new WebPartConnection();
      conn.ID = "staticConn1";
      conn.ConsumerID = "weather1";
      conn.ConsumerConnectionPointID = "ZipCodeConsumer";
      conn.ProviderID = "zip1";
      conn.ProviderConnectionPointID = "ZipCodeProvider";
      mgr.StaticConnections.Add(conn);
    }
 }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="mgr" runat="server" />   
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" 
        runat="server" />
      <!-- Reference consumer and provider controls 
           in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect 
           controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" 
        runat="server" />
    </div>
    </form>
</body>
</html>

Después de cargar la página Web en un explorador, haga clic en el control de lista desplegable Modo de presentación y seleccione Conectar para cambiar la página al modo de conexión. El modo de conexión utiliza el elemento <asp:connectionszone>, que permite crear conexiones entre controles. En modo de conexión, haga clic en la flecha abajo en la barra de título del control ZIP Code (Código postal) para activar el menú de verbos y, a continuación, haga clic en Conectar. Después de que aparezca la interfaz de usuario de conexión, observe que el código contenido en el método Page_Load ya ha creado una conexión. Si vuelve a esta página en una sesión posterior del explorador, esta conexión estática ya estará establecida y no será necesario volver a crearla cada vez que se cargue la página.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: