ConnectionsZone Clase

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Ofrece una interfaz de usuario (IU) que permite a los usuarios establecer conexiones entre WebPart y otros controles de servidor que se encuentran en zonas WebPartZoneBase.

public ref class ConnectionsZone : System::Web::UI::WebControls::WebParts::ToolZone

public class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZone

type ConnectionsZone = class
    inherit ToolZone

Public Class ConnectionsZone
Inherits ToolZone

Herencia

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el ConnectionsZone control en una página de elementos web. El ejemplo tiene cuatro partes:

• Control de usuario que permite cambiar los modos de visualización en la página web.

• Un archivo de código fuente que contiene el código de una interfaz de código postal y dos WebPart controles que actúan como proveedor y consumidor para una conexión.

• Una página web que hospeda todos los controles, muestra cómo declarar un <asp:connectionszone> elemento y establece una serie de propiedades en la zona de conexiones mediante declaración y mediante programación.

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

La primera parte de este ejemplo de código es el control de usuario que permite a los usuarios cambiar los modos de visualización en una página web. Para obtener más información sobre los modos de visualización y una descripción del código fuente de este control, vea Tutorial: Cambiar modos de presentación en una página de elementos web.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

La segunda parte del ejemplo es el archivo de origen con la interfaz y los controles personalizados. Observe que el ZipCodeWebPart control implementa la IZipCode interfaz, agregando un ConnectionProvider atributo para que el control pueda actuar como proveedor de una conexión. El WeatherWebPart control tiene un método marcado con un ConnectionConsumer atributo, donde consume la IZipCode interfaz, por lo que puede actuar como consumidor en una conexión.

Para que se ejecute el ejemplo de código, debe compilar este código fuente. Puede compilarlo explícitamente y colocar el ensamblado resultante en la carpeta Bin del sitio web o en la caché global de ensamblados. Como alternativa, puede colocar el código fuente en la carpeta App_Code del sitio, donde se compilará dinámicamente en tiempo de ejecución. En este ejemplo se usa la compilación dinámica. Para ver un tutorial que muestra cómo compilar, consulte Tutorial: Desarrollo y uso de un control de servidor web personalizado.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code Provider", "ZipCodeProvider")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code Provider", "ZipCodeProvider")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
                DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

La tercera parte del código de ejemplo es la página web. Cerca de la parte superior hay Register directivas para el control de usuario y los controles personalizados usados en la conexión. Un <asp:connectionszone> elemento se declara en la página como ejemplo de uso del ConnectionsZone control mediante declaración. Dentro del elemento , se establecen varias propiedades mediante declaración. Otras propiedades de la zona de conexiones se establecen mediante programación en la <script> sección de la página.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuCS"
    src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

<!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_PreRender(object sender, EventArgs e)
  {
     // Set properties on verbs.
     connectionsZone1.CancelVerb.Description = 
       "Terminates the connection process";
     connectionsZone1.CloseVerb.Description = 
       "Closes the connections UI";
     connectionsZone1.ConfigureVerb.Description =
       "Configure the transformer for the connection";
     connectionsZone1.ConnectVerb.Description =
       "Connect two WebPart controls";
     connectionsZone1.DisconnectVerb.Description =
       "End the connection between two controls";
    
     // Set properties for UI text strings.
     connectionsZone1.ConfigureConnectionTitle = 
       "Configure";
     connectionsZone1.ConnectToConsumerInstructionText = 
       "Choose a consumer connection point";
     connectionsZone1.ConnectToConsumerText = 
       "Select a consumer for the provider to connect with";
     connectionsZone1.ConnectToConsumerTitle = 
       "Send data to this consumer";
     connectionsZone1.ConnectToProviderInstructionText =
       "Choose a provider connection point";
     connectionsZone1.ConnectToProviderText =
       "Select a provider for the consumer to connect with";
     connectionsZone1.ConnectToProviderTitle =
       "Get data from this provider";
     connectionsZone1.ConsumersInstructionText = 
       "WebPart controls that receive data from providers";
     connectionsZone1.ConsumersTitle = "Consumer Controls";
     connectionsZone1.GetFromText = "Receive from";
     connectionsZone1.GetText = "Retrieve";
     connectionsZone1.HeaderText = 
      "Create and Manage Connections";
     connectionsZone1.InstructionText = 
      "Manage connections for the selected WebPart control";
     connectionsZone1.InstructionTitle = 
       "Manage connections for consumers or providers";
     connectionsZone1.NoExistingConnectionInstructionText = 
       "No connections exist. Click the above link to create "
       + "a connection.";
     connectionsZone1.NoExistingConnectionTitle = 
       "No current connections";
     connectionsZone1.ProvidersInstructionText =
       "WebPart controls that send data to consumers";
     connectionsZone1.ProvidersTitle = "Provider controls";
     
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenucs id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider"  />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuVB"
    src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

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

<script runat="server">

  Protected Sub Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Set properties for verbs.
    connectionsZone1.CancelVerb.Description = _
      "Terminates the connection process"
    connectionsZone1.CloseVerb.Description = _
      "Closes the connections UI"
    connectionsZone1.ConfigureVerb.Description = _
      "Configure the transformer for the connection"
    connectionsZone1.ConnectVerb.Description = _
      "Connect two WebPart controls"
    connectionsZone1.DisconnectVerb.Description = _
      "End the connection between two controls"
    
    ' Set properties for UI text strings.
    connectionsZone1.ConfigureConnectionTitle = _
      "Configure a new connection"
    connectionsZone1.ConnectToConsumerInstructionText = _
      "Choose a consumer connection point"
    connectionsZone1.ConnectToConsumerText = _
      "Select a consumer for the provider to connect with"
    connectionsZone1.ConnectToConsumerTitle = _
      "Send data to this consumer"
    connectionsZone1.ConnectToProviderInstructionText = _
      "Choose a provider connection point"
    connectionsZone1.ConnectToProviderText = _
      "Select a provider for the consumer to connect with"
    connectionsZone1.ConnectToProviderTitle = _
      "Get data from this provider"
    connectionsZone1.ConsumersInstructionText = _
      "WebPart controls that receive data from providers"
    connectionsZone1.ConsumersTitle = "Consumer Controls"
    connectionsZone1.GetFromText = "Receive from"
    connectionsZone1.GetText = "Retrieve"
    connectionsZone1.HeaderText = _
      "Create and Manage Connections"
    connectionsZone1.InstructionText = _
      "Manage connections for the selected WebPart control"
    connectionsZone1.InstructionTitle = _
      "Manage connections for consumers or providers"
    connectionsZone1.NoExistingConnectionInstructionText = _
      "No connections exist. Click the above link to create " _
      & "a connection."
    connectionsZone1.NoExistingConnectionTitle = _
      "No current connections"
    connectionsZone1.ProvidersInstructionText = _
      "WebPart controls that send data to consumers"
    connectionsZone1.ProvidersTitle = "Provider controls"

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenuvb id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider" />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

Cargue la página web en un explorador. Use el control de lista desplegable Modo de visualización para cambiar la página al modo de conexión. En el menú de verbos del control Proveedor de código postal (el menú verbos se indica mediante la flecha hacia abajo en la barra de título del control), haga clic en el verbo connect. Aparece un ConnectionsZone control. Tenga en cuenta que, en la interfaz de usuario de conexión, aparece un botón Finalizar conexión ; la conexión ya se ha declarado en el marcado de la página, por lo que los controles ya están conectados. Haga clic en Finalizar conexión y, a continuación, vuelva a usar el control Modo de presentación para devolver la página para examinar el modo. A continuación, vuelva a devolver la página para conectar el modo, haga clic en el verbo connect en uno de los controles y tenga en cuenta que la interfaz de usuario de conexión muestra ahora un hipervínculo que le permite formar una conexión entre los controles. Haga clic en el vínculo y use la interfaz de usuario de conexión para seleccionar puntos de conexión y establecer la conexión.

Comentarios

Con el conjunto de controles de elementos web, puede habilitar dos controles de servidor para formar una conexión y compartir datos, con un control que actúa como proveedor y el otro que actúa como consumidor de los datos. Los dos controles pueden ser WebPart controles o cualquier otro tipo de control de servidor, siempre que estén diseñados para controlar las conexiones y que residan en una WebPartZoneBase zona. Para obtener más información sobre las conexiones de elementos web, consulte información general sobre las WebPartConnection clases y ConnectionPoint , así como Información general sobre conexiones de elementos web.

Siempre que existan los controles y condiciones necesarios para formar una conexión de elementos web, todavía es necesario conectar realmente los controles. Hay tres maneras de formar una conexión entre los controles de servidor: declarar una conexión en una página web, crear una conexión en el código o agregar un ConnectionsZone control a la página para que los usuarios puedan conectar los controles a petición. El ConnectionsZone control genera una interfaz de usuario que permite a los usuarios conectarse o desconectar los controles de servidor de una página que cumplan las condiciones necesarias para formar una conexión. Es un control opcional que no es necesario para formar conexiones, pero es útil en el caso de que quiera proporcionar a los usuarios control sobre qué controles de servidor están conectados o desconectados.

El ConnectionsZone control es uno de los controles de zona de herramientas de elementos web que heredan de la ToolZone clase base. Como zona de herramientas, el ConnectionsZone control está diseñado para ser visible solo cuando su página web está en un modo de visualización determinado. En este caso, el modo de visualización se denomina modo de conexión (una página está en este modo cuando el WebPartManager control de la página tiene su DisplayMode valor de propiedad establecido ConnectDisplayModeen ). Después de que los usuarios cambien una página al modo de conexión, deben hacer clic en un verbo connect en el menú verbos de uno de los controles de servidor y, a continuación, la interfaz de usuario de conexión se vuelve visible.

Como control de zona de elementos web, el ConnectionsZone control es un tipo de WebZone zona (que hereda de la CompositeControl clase ) diseñada para contener otros controles. En general, una ConnectionsZone zona tiene la mayoría de los mismos elementos que otras zonas de herramientas de elementos web: un encabezado, un cuerpo o un área de contenido y un pie de página. Para obtener una explicación completa de lo que es una zona de elementos web y las distintas partes de una zona, consulte la información general de la WebZone clase.

Importante

A diferencia de la mayoría de las otras zonas de elementos web, es importante tener en cuenta que una ConnectionsZone zona no contiene un tipo único de control de servidor asociado. Para obtener una lista de zonas y los controles asociados que contienen, consulte el gráfico en la información general de la WebZone clase. Pero la ConnectionsZone zona no contiene WebPartConnection controles. En su lugar, sirve para proporcionar una interfaz de usuario muy limitada para que los usuarios conecten o desconecten los controles de servidor que existen en alguna WebPartZoneBase zona de la página. Los únicos controles contenidos en un ConnectionsZone control son los controles estándar de ASP.NET servidor que genera como parte de su interfaz de usuario para formar conexiones.

Cuando se representa el ConnectionsZone control, genera una interfaz de usuario basada en los controles de servidor de la página que son capaces de formar conexiones. El ConnectionsZone control determina qué controles de servidor de la zona de la WebPartZoneBase página son proveedores, que son consumidores, qué puntos de conexión están disponibles y si los controles de servidor están conectados o desconectados actualmente y, a continuación, genera la interfaz de usuario en consecuencia.

Por ejemplo, supongamos que hay un WebPart control capaz de ser un proveedor, un WebPart control capaz de ser un consumidor, se declaran en una WebPartZone en la página y actualmente están desconectados. Cuando un usuario cambia la página para conectar el modo de conexión y hace clic en el verbo connect en uno de los controles, el ConnectionsZone control genera una interfaz de usuario con un vínculo que, cuando se hace clic, muestra un formulario en el que los usuarios pueden elegir opciones para crear una conexión. (Si los controles estaban conectados anteriormente, la vista inicial presenta a los usuarios un botón para desconectar los controles). En la interfaz de usuario de conexión para crear nuevas conexiones, los usuarios se muestran qué control es un proveedor y qué control es un consumidor. Un control de lista desplegable aparece debajo de cada control de servidor, enumerando los objetos disponibles ConnectionPoint para el control. En las listas desplegables respectivas, los usuarios deben seleccionar un ProviderConnectionPoint objeto para el proveedor (para determinar qué interfaz y datos se compartirán con los consumidores) y un ConsumerConnectionPoint objeto para cada consumidor (para determinar qué interfaz y datos consumirá el consumidor) que se conectarán al proveedor.

Nota

En la implementación predeterminada del control de elementos web, un proveedor puede conectarse a muchos consumidores, pero un consumidor solo puede tener un proveedor.

Para usar el ConnectionsZone control, puede declararlo dentro del <form> elemento en una página web (pero no anidado dentro de otro elemento de zona de elementos web), mediante el <asp:connectionszone> elemento o puede agregarlo a la página mediante programación. Si declara el elemento en una página, a diferencia de las demás zonas de elementos web, no puede declarar ningún otro tipo de controles de servidor entre las etiquetas del <asp:connectionszone> elemento. Puede declarar elementos dentro de él relacionados con sus propias propiedades y detalles de estilo, pero es un elemento independiente y no es un control de plantilla dentro del cual se pueden declarar otros controles de servidor.

Nota

Para mejorar la accesibilidad, el ConnectionsZone control se representa dentro de un <fieldset> elemento . El <fieldset> elemento agrupa el conjunto de controles relacionado que se usan para establecer conexiones en el ConnectionsZone control y facilita la navegación por pestañas entre esos controles para los agentes de usuario visuales (como exploradores web normales) y agentes de usuario orientados a voz (como el software de lectura de pantalla).

El ConnectionsZone control tiene varias propiedades que usa para representar la interfaz de usuario de conexión. Un conjunto de propiedades incluye varios verbos que solo se usan en relación con las conexiones, que llevan a cabo acciones en la interfaz de usuario: ConfigureVerb, ConnectVerby DisconnectVerb. Un conjunto grande de propiedades, que se usa especialmente para la interfaz de usuario de la zona de conexiones, consta de cadenas de texto mostradas en varios lugares (o en determinadas situaciones, como cuando se producen errores) en la interfaz de usuario: ConfigureConnectionTitle, , GetFromTextNoExistingConnectionTitleConnectToConsumerInstructionTextConnectToConsumerTextConsumersTitleConsumersInstructionTextExistingConnectionErrorMessageConnectToProviderTitleGetTextConnectToProviderTextInstructionTitleNewConnectionErrorMessageConnectToProviderInstructionTextConnectToConsumerTitleProvidersInstructionTextProvidersTitleNoExistingConnectionInstructionTextSendTexty .SendToText La ConnectionsZone clase también contiene una serie de propiedades comunes que se encuentran en otras zonas de elementos web: CancelVerb, CloseVerb, DisplayEmptyZoneText, , HeaderText, InstructionTexty PartChromeType. Por último, la WebPartToConnect propiedad es única para la clase , haciendo referencia al control que inicia la conexión (este es el control en el que el usuario hace clic en el verbo connect en su menú verbos, que también es el control al que se hace referencia en la WebPartManager propiedad del SelectedWebPart control).

La ConnectionsZone clase también tiene una serie de métodos, todos los cuales se heredan y reemplazan de las clases base, y la mayoría de ellos proceden de las clases de zona de elementos web base. Para más información, consulte los métodos individuales.

Notas a los desarrolladores de herederos

La ConnectionsZone clase se puede ampliar si los desarrolladores quieren cambiar su comportamiento o la interfaz de usuario predeterminada que proporciona para trabajar con conexiones.

Constructores

ConnectionsZone()

Inicializa una nueva instancia de la clase ConnectionsZone.

Propiedades

AccessKey	Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Heredado de WebControl)
Adapter	Obtiene el adaptador específico del explorador para el control. (Heredado de Control)
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control)
AssociatedDisplayModes	Obtiene la colección de objetos WebPartDisplayMode que están asociados a una zona ToolZone determinada. (Heredado de ToolZone)
Attributes	Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Heredado de WebControl)
BackColor	Obtiene o establece el color de fondo del control de servidor web. (Heredado de WebControl)
BackImageUrl	Obtiene o establece la dirección URL a una imagen de fondo para una zona. (Heredado de WebZone)
BindingContainer	Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control)
BorderColor	Obtiene o establece el color de borde del control Web. (Heredado de WebControl)
BorderStyle	Obtiene o establece el estilo del borde del control de servidor web. (Heredado de WebControl)
BorderWidth	Obtiene o establece el ancho del borde del control de servidor web. (Heredado de WebControl)
CancelVerb	Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales cancelar el proceso de establecimiento de una conexión.
ChildControlsCreated	Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control)
ClientID	Obtiene el id. de control para marcado HTML que se genera por ASP.NET. (Heredado de Control)
ClientIDMode	Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control)
CloseVerb	Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales cerrar la interfaz de usuario de conexión creada por el control ConnectionsZone.
ConfigureConnectionTitle	Obtiene o establece el texto que aparece como título de una subsección de la interfaz de usuario de conexión creada por un control ConnectionsZone.
ConfigureVerb	Obtiene una referencia a un objeto WebPartVerb que se utiliza para abrir la vista de configuración en la interfaz de usuario de conexión.
ConnectToConsumerInstructionText	Obtiene o establece el texto informativo mostrado en la sección de la interfaz de usuario de conexión en la que los usuarios seleccionan un punto de conexión del consumidor al que se conectará el proveedor.
ConnectToConsumerText	Obtiene o establece el texto de un hipervínculo en el que los usuarios hacen clic para abrir una vista en la que pueden elegir un control consumidor para una conexión.
ConnectToConsumerTitle	Obtiene o establece el texto del título de la sección de la interfaz de usuario de conexión en la que los usuarios pueden seleccionar un consumidor específico al que conectarse.
ConnectToProviderInstructionText	Obtiene o establece el texto informativo mostrado en la sección de la interfaz de usuario de conexión en la que los usuarios seleccionan un punto de conexión del proveedor al que se conectará el consumidor.
ConnectToProviderText	Obtiene o establece el texto de un hipervínculo en el que los usuarios hacen clic para abrir una vista en la que elegir un control proveedor para una conexión.
ConnectToProviderTitle	Obtiene o establece el texto del título de la sección de la interfaz de usuario de conexión en la que los usuarios pueden seleccionar un proveedor específico al que conectarse.
ConnectVerb	Obtiene una referencia a un objeto WebPartVerb que permite que dos controles WebPart establezcan una conexión.
ConsumersInstructionText	Obtiene o establece el texto informativo que aparece en la sección de consumidores de la interfaz de usuario de conexión cuando ya existe una conexión.
ConsumersTitle	Obtiene o establece el título que aparece sobre la sección de consumidores de la interfaz de usuario de conexión cuando ya existe una conexión.
Context	Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control)
Controls	Obtiene un objeto ControlCollection que representa los controles secundarios de CompositeControl. (Heredado de CompositeControl)
ControlStyle	Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl)
ControlStyleCreated	Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl)
CssClass	Obtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente. (Heredado de WebControl)
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control)
DesignMode	Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control)
DisconnectVerb	Obtiene una referencia a un objeto WebPartVerb que permite a un usuario desconectar dos controles WebPart conectados.
Display	Obtiene un valor que indica si un control ToolZone se muestra actualmente.
EditUIStyle	Obtiene los atributos de estilo para los controles modificables contenidos en un control ToolZone. (Heredado de ToolZone)
EmptyZoneText	Obtiene o establece un mensaje de texto que se muestra en un control ConnectionsZone vacío si no hay suficientes controles en una página Web para establecer una conexión.
EmptyZoneTextStyle	Obtiene los atributos de estilo para el texto del marcador de posición en una zona vacía. (Heredado de WebZone)
Enabled	Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Heredado de WebControl)
EnableTheming	Obtiene o establece un valor que indica si los temas se aplican a este control. (Heredado de WebControl)
EnableViewState	Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
ErrorStyle	Obtiene los atributos de estilo para representar el mensaje de error que se muestra si no se puede cargar o crear un control WebPart. (Heredado de WebZone)
Events	Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control)
ExistingConnectionErrorMessage	Obtiene o establece el texto de un mensaje que se muestra en la interfaz de usuario de conexión cuando se produce un error o una advertencia en un conexión existente.
Font	Obtiene las propiedades de fuente asociadas al control de servidor web. (Heredado de WebControl)
FooterStyle	Obtiene los atributos de estilo del contenido del área de pie de página de una zona. (Heredado de WebZone)
ForeColor	Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Heredado de WebControl)
GetFromText	Obtiene o establece el texto que aparece en la sección de la interfaz de usuario de conexión que precede al proveedor asignado desde el que el consumidor recuperará los datos.
GetText	Obtiene o establece el texto que aparece en la sección de la interfaz de usuario de conexión que precede al consumidor asignado que recibirá datos de un proveedor.
HasAttributes	Obtiene un valor que indica si el control tiene establecido algún atributo. (Heredado de WebControl)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control)
HasFooter	Obtiene un valor que indica si una zona tiene un área de pie de página. (Heredado de WebZone)
HasHeader	Obtiene un valor que indica si una zona tiene un área de encabezado. (Heredado de WebZone)
HeaderCloseVerb	Obtiene una referencia al objeto WebPartVerb en el encabezado de un control ToolZone utilizado para cerrar el control. (Heredado de ToolZone)
HeaderStyle	Obtiene los atributos de estilo del contenido del área de encabezado de una zona. (Heredado de WebZone)
HeaderText	Obtiene o establece el texto de encabezado que aparece en la parte superior de la interfaz de usuario de conexión creada por el control ConnectionsZone.
HeaderVerbStyle	Obtiene los atributos de estilo de todos los verbos del encabezado mostrados en un control ToolZone. (Heredado de ToolZone)
Height	Obtiene o establece el alto del control de servidor Web. (Heredado de WebControl)
ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control)
IdSeparator	Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control)
InstructionText	Obtiene o establece el texto que se utiliza para proporcionar instrucciones generales sobre el control seleccionado en la sección de la interfaz de usuario de conexión destinada a la administración de las conexiones existentes.
InstructionTextStyle	Obtiene los atributos de estilo del texto de instrucciones que aparece en la parte superior de un control ToolZone. (Heredado de ToolZone)
InstructionTitle	Obtiene o establece el texto que se utiliza para proporcionar una descripción general de la acción que puede llevarse a cabo en el control consumidor o proveedor en la interfaz de usuario de conexión para la administración de conexiones existentes.
IsChildControlStateCleared	Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control)
IsEnabled	Obtiene un valor que indica si está habilitado el control. (Heredado de WebControl)
IsTrackingViewState	Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control)
IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control)
LabelStyle	Obtiene los atributos de estilo del contenido de las etiquetas que aparecen junto a los controles de edición dentro de un control ToolZone. Los controles ToolZone derivados, como CatalogZone y EditorZone, aplican los estilos a las etiquetas. (Heredado de ToolZone)
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control)
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID. (Heredado de Control)
NewConnectionErrorMessage	Obtiene o establece el texto de un mensaje que se muestra en la interfaz de usuario de conexión cuando se produce un error o una advertencia en una nueva conexión que un usuario intenta crear.
NoExistingConnectionInstructionText	Obtiene o establece el texto de la instrucción que aparece en el cuerpo de la interfaz de usuario de conexión cuando un control de elementos Web no tiene una conexión existente.
NoExistingConnectionTitle	Obtiene o establece el texto del título que aparece en el cuerpo de la interfaz de usuario de conexión cuando un control de elementos Web no tiene una conexión existente.
Padding	Obtiene o establece los atributos de espacio del borde al texto para las celdas de la tabla que contiene los controles WebPart de una zona. (Heredado de WebZone)
Page	Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control)
PartChromePadding	Obtiene o establece la distancia entre el contenido de un control WebPart y su borde. (Heredado de WebZone)
PartChromeStyle	Obtiene las características de estilo que se aplican a los bordes de los controles de elementos Web que una zona contiene. (Heredado de WebZone)
PartChromeType	Obtiene o establece el tipo de borde que rodea a los controles de servidor incluidos en un control ConnectionsZone.
PartStyle	Obtiene las características de estilo que se aplican al borde y al contenido de cada control de elementos Web que una zona contiene. (Heredado de WebZone)
PartTitleStyle	Obtiene los atributos de estilo del contenido de la barra de título de cada control de elementos Web que una zona contiene. (Heredado de WebZone)
ProvidersInstructionText	Obtiene o establece el texto informativo que aparece en la sección de proveedores de la interfaz de usuario de conexión cuando ya existe una conexión.
ProvidersTitle	Obtiene o establece el título que aparece encima de la sección de proveedores de la interfaz de usuario de conexión cuando ya existe una conexión.
RenderClientScript	Obtiene un valor que indica si se va a representar script de cliente en una página de elementos Web. (Heredado de WebZone)
RenderingCompatibility	Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control)
SendText	Obtiene o establece el texto que aparece en la sección de la interfaz de usuario de conexión que precede al proveedor asignado que enviará datos a un consumidor.
SendToText	Obtiene o establece el texto que aparece en la sección de la interfaz de usuario de conexión que precede al consumidor asignado al que un proveedor enviará datos.
Site	Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene o establece la máscara que se aplica al control. (Heredado de WebControl)
Style	Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Heredado de WebControl)
SupportsDisabledAttribute	Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false. (Heredado de CompositeControl)
TabIndex	Obtiene o establece el índice de tabulación del control de servidor web. (Heredado de WebControl)
TagKey	Obtiene el valor HtmlTextWriterTag correspondiente al control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebZone)
TagName	Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl)
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control)
TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control)
ToolTip	Obtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Heredado de WebControl)
UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control)
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control)
VerbButtonType	Obtiene o establece el tipo de botón que se utiliza para representar los verbos de una zona. (Heredado de WebZone)
VerbStyle	Obtiene los atributos de estilo para los verbos de la interfaz de usuario (UI) asociados a los controles de elementos Web de una zona. (Heredado de WebZone)
ViewState	Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Heredado de Control)
ViewStateIgnoresCase	Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control)
ViewStateMode	Obtiene o establece el modo del estado de vista de este control. (Heredado de Control)
Visible	Obtiene o establece un valor que indica si un control de servidor se debe representar como elemento de interfaz de usuario (IU) en la página. (Heredado de ToolZone)
WebPartManager	Obtiene una referencia al control WebPartManager asociado a una instancia del control WebZone en una página de elementos Web. (Heredado de WebZone)
WebPartToConnect	Obtiene el control WebPart seleccionado en la actualidad con el que se va a establecer la conexión.
Width	Obtiene o establece el ancho del control de servidor web. (Heredado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)	Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control)
AddParsedSubObject(Object)	Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor. (Heredado de Control)
ApplyStyle(Style)	Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Heredado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Heredado de Control)
BeginRenderTracing(TextWriter, Object)	Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
BuildProfileTree(String, Boolean)	Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Heredado de Control)
ClearCachedClientID()	Establece en null el valor de ClientID almacenado en caché. (Heredado de Control)
ClearChildControlState()	Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control)
Close()	Cierra la interfaz de usuario de conexión creada por el control ConnectionsZone.
CopyBaseAttributes(WebControl)	Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
CreateChildControls()	Crea todos los controles secundarios incluidos en un control ConnectionsZone para devolverlos al servidor o representarlos.
CreateControlCollection()	Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor. (Heredado de Control)
CreateControlStyle()	Crea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
DataBind()	Enlaza un origen de datos a CompositeControl y todos sus controles secundarios. (Heredado de CompositeControl)
DataBind(Boolean)	Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Heredado de Control)
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control)
Dispose()	Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control)
EndRenderTracing(TextWriter, Object)	Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
EnsureChildControls()	Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control)
EnsureID()	Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindControl(String)	Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Heredado de Control)
FindControl(String, Int32)	Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar. (Heredado de Control)
Focus()	Establece el foco de entrada en un control. (Heredado de Control)
GetDesignModeState()	Obtiene datos en tiempo de diseño para un control. (Heredado de Control)
GetEffectiveChromeType(Part)	Devuelve el valor PartChromeType actual real o eficaz de un control WebPart, dada la propiedad PartChromeType de la zona y el modo de presentación actual de la página de elementos web. (Heredado de WebZone)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetRouteUrl(Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(String, Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUniqueIDRelativeTo(Control)	Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control)
HasControls()	Determina si el control de servidor contiene controles secundarios. (Heredado de Control)
HasEvents()	Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura la información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState().
MapPathSecure(String)	Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MergeStyle(Style)	Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página. (Heredado de Control)
OnDataBinding(EventArgs)	Genera el evento DataBinding. (Heredado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Genera el evento DisplayModeChanged.
OnInit(EventArgs)	Genera el evento Init.
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnPreRender(EventArgs)	Genera el evento PreRender. (Heredado de WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Genera el evento SelectedWebPartChanged.
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control)
RaisePostBackEvent(String)	Provoca un evento para el control ConnectionsZone cuando el formulario que lo contiene devuelve datos al servidor.
RecreateChildControls()	Vuelve a crear los controles secundarios de un control derivado de CompositeControl. (Heredado de CompositeControl)
RemovedControl(Control)	Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control)
Render(HtmlTextWriter)	Representa el contenido del control ConnectionsZone en el objeto HtmlTextWriter especificado.
RenderBeginTag(HtmlTextWriter)	Representa la etiqueta HTML de apertura del control de zona en el objeto HtmlTextWriter especificado. (Heredado de WebZone)
RenderBody(HtmlTextWriter)	Envía el contenido del área del cuerpo de un control ConnectionsZone al objeto HtmlTextWriter especificado, que escribe el contenido en la página Web.
RenderChildren(HtmlTextWriter)	Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderContents(HtmlTextWriter)	Representa todo el contenido de un control de zona que se encuentre entre las etiquetas inicial y final en el objeto HtmlTextWriter especificado. (Heredado de WebZone)
RenderControl(HtmlTextWriter)	Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento. (Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control)
RenderEndTag(HtmlTextWriter)	Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
RenderFooter(HtmlTextWriter)	Reemplaza el método base para representar los verbos del pie de página de un control ToolZone. (Heredado de ToolZone)
RenderHeader(HtmlTextWriter)	Reemplaza el método base para proporcionar la representación especializada del área de encabezado que requieren los controles ToolZone. (Heredado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Representa un verbo individual con un control ToolZone. (Heredado de ToolZone)
RenderVerbs(HtmlTextWriter)	Representa los verbos de nivel de zona de un control ConnectionsZone.
ResolveAdapter()	Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control)
SaveControlState()	Guarda todos los cambios realizados en el estado del control de elementos Web desde la última vez que la página se envío al servidor.
SaveViewState()	Guarda los cambios del estado de vista de un control ConnectionsZone que se han efectuado desde la última vez que la página se envió al servidor.
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño para un control. (Heredado de Control)
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control)
SetTraceData(Object, Object)	Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Heredado de Control)
SetTraceData(Object, Object, Object)	Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Heredado de Control)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Efectúa el seguimiento de los cambios realizados en el estado de vista del control ConnectionsZone para que los cambios se puedan almacenar en su objeto StateBag.

Eventos

DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
Disposed	Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Heredado de Control)
Init	Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control)
PreRender	Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control)
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)	Obtiene un atributo del control Web con el nombre especificado. (Heredado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Establece un atributo del control Web con el nombre y el valor especificados. (Heredado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite que un diseñador vuelva a crear la colección de controles secundarios del control compuesto en el entorno en tiempo de diseño. (Heredado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control)
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea UserData. (Heredado de Control)
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control)
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control)
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control)
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementa el método RaisePostBackEvent(String). (Heredado de ToolZone)

Métodos de extensión

FindDataSourceControl(Control)	Devuelve el origen de datos que está asociado al control de datos del control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatabla para el control de datos contenedor.
GetDefaultValues(INamingContainer)	Obtiene la colección de los valores predeterminados para el control de datos especificado.
GetMetaTable(INamingContainer)	Obtiene los metadatos de la tabla para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable)	Establece los metadatos de la tabla para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina si están disponibles los metadatos de la tabla.
EnableDynamicData(INamingContainer, Type)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.

Consulte también

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• controles de elementos web de ASP.NET
• Introducción a las conexiones de elementos web