Compartir a través de


ConnectionsZone Clase

Definición

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

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.

Se aplica a

Consulte también