ConnectionsZone Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma IU (interface do usuário) que permite que os usuários formem conexões entre WebPart e outros controles de servidor que residem em 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

Herança: Object

Control

WebControl

CompositeControl

WebZone

ToolZone
ConnectionsZone

Exemplos

O exemplo de código a seguir demonstra como usar o ConnectionsZone controle em uma página de Web Parts. O exemplo tem quatro partes:

Um controle de usuário que permite alternar os modos de exibição na página da Web.
Um arquivo de origem que contém o código para uma interface de CEP e dois WebPart controles que atuam como o provedor e o consumidor de uma conexão.
Uma página da Web que hospeda todos os controles demonstra como declarar um <asp:connectionszone> elemento e define várias propriedades na zona de conexões de forma declarativa e programática.
Uma explicação de como o exemplo funciona em um navegador.

A primeira parte desse exemplo de código é o controle de usuário que permite aos usuários alternar os modos de exibição em uma página da Web. Para obter detalhes sobre modos de exibição e uma descrição do código-fonte nesse controle, consulte Passo a passo: alterando modos de exibição em uma página de Web Parts.

<%@ 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>

A segunda parte do exemplo é o arquivo de origem com a interface e os controles personalizados. Observe que o ZipCodeWebPart controle implementa a IZipCode interface , adicionando um ConnectionProvider atributo para que o controle possa atuar como um provedor para uma conexão. O WeatherWebPart controle tem um método marcado com um ConnectionConsumer atributo , em que consome a IZipCode interface , para que ele possa atuar como um consumidor em uma conexão.

Para que o exemplo de código seja executado, você deve compilar esse código-fonte. Você pode compilá-lo explicitamente e colocar o assembly resultante na pasta Bin do site ou no cache de assembly global. Como alternativa, você pode colocar o código-fonte na pasta App_Code do site, na qual ele será compilado dinamicamente em tempo de execução. Este exemplo usa compilação dinâmica. Para obter um passo a passo que demonstra como compilar, consulte Passo a passo : desenvolvendo e usando um controle 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

A terceira parte do código de exemplo é a página da Web. Perto da parte superior estão Register diretivas para o controle de usuário e os controles personalizados usados na conexão. Um <asp:connectionszone> elemento é declarado na página como um exemplo de como usar o ConnectionsZone controle declarativamente. Dentro do elemento , várias propriedades são definidas declarativamente. Outras propriedades na zona de conexões são definidas programaticamente na <script> seção da 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>

Carregue a página da Web em um navegador. Use o controle de lista suspensa Modo de Exibição para alternar a página para o modo de conexão. No menu de verbos do controle Provedor de CEP (o menu de verbos é indicado pela seta para baixo na barra de título do controle), clique no verbo de conexão. Um ConnectionsZone controle é exibido. Observe que, na interface do usuário da conexão, um botão Encerrar Conexão é exibido; a conexão já foi declarada na marcação da página, portanto, os controles já estão conectados. Clique em Encerrar Conexão e use o controle Modo de Exibição novamente para retornar a página para o modo de navegação. Em seguida, retorne a página para o modo de conexão novamente, clique no verbo de conexão em um dos controles e observe que a interface do usuário de conexão agora exibe um hiperlink que permite formar uma conexão entre os controles. Clique no link e use a interface do usuário de conexão para selecionar pontos de conexão e estabelecer a conexão.

Comentários

Usando o conjunto de controle de Web Parts, você pode habilitar dois controles de servidor para formar uma conexão e compartilhar dados, com um controle atuando como o provedor e o outro atuando como consumidor dos dados. Os dois controles podem ser WebPart controles ou qualquer outro tipo de controle de servidor, desde que eles sejam projetados para lidar com conexões e que estejam residindo em uma WebPartZoneBase zona. Para saber mais sobre conexões de Web Parts, consulte as visões gerais da WebPartConnection classe e ConnectionPoint , bem como Visão geral de conexões de Web Parts.

Desde que existam controles e condições necessários para formar uma conexão de Web Parts, ainda é necessário realmente conectar os controles. Há três maneiras de formar uma conexão entre controles de servidor: declarar uma conexão em uma página da Web, criar uma conexão no código ou adicionar um ConnectionsZone controle à página para que os usuários possam conectar os controles sob demanda. O ConnectionsZone controle gera uma interface do usuário que permite que os usuários se conectem ou desconectem quaisquer controles de servidor em uma página que atendam às condições necessárias para formar uma conexão. É um controle opcional que não é necessário para formar conexões, mas é útil no caso em que você deseja dar aos usuários controle sobre quais controles de servidor estão conectados ou desconectados.

O ConnectionsZone controle é um dos controles de zona de ferramentas de Web Parts que herdam da ToolZone classe base. Como uma zona de ferramentas, o ConnectionsZone controle foi projetado para ser visível somente quando sua página da Web estiver em um determinado modo de exibição. Nesse caso, o modo de exibição é chamado de modo de conexão (uma página está nesse modo quando o WebPartManager controle na página tem seu DisplayMode valor de propriedade definido ConnectDisplayModecomo ). Depois que os usuários alternam uma página para o modo de conexão, eles devem clicar em um verbo de conexão no menu de verbos de um dos controles do servidor e, em seguida, a interface do usuário de conexão se torna visível.

Como um controle de zona de Web Parts, o ConnectionsZone controle é um tipo de WebZone zona (que herda da CompositeControl classe ) projetada para conter outros controles. Em geral, uma ConnectionsZone zona tem a maioria dos mesmos elementos que outras zonas de ferramentas de Web Parts: um cabeçalho, uma área de corpo ou conteúdo e um rodapé. Para obter uma discussão completa sobre o que é uma zona de Web Parts e as diferentes partes de uma zona, consulte a visão geral da WebZone classe.

Importante

Ao contrário da maioria das outras zonas de Web Parts, é importante observar que uma ConnectionsZone zona não contém um tipo exclusivo de controle de servidor associado a ela. Para obter uma lista de zonas e os controles associados que elas contêm, consulte o gráfico na visão geral da WebZone classe. Mas a ConnectionsZone zona não contém WebPartConnection controles. Em vez disso, ele tem uma finalidade muito limitada de fornecer uma interface do usuário para que os usuários se conectem ou desconectem controles de servidor que existem em alguma WebPartZoneBase zona na página. Os únicos controles contidos em um ConnectionsZone controle são os controles de servidor padrão ASP.NET que ele gera como parte de sua interface do usuário para formar conexões.

Quando o ConnectionsZone controle é renderizado, ele gera uma interface do usuário com base nos controles do servidor na página que são capazes de formar conexões. O ConnectionsZone controle determina quais controles de servidor na WebPartZoneBase zona na página são provedores, que são consumidores, quais pontos de conexão estão disponíveis e se os controles de servidor estão conectados ou desconectados no momento e, em seguida, gera a interface do usuário adequadamente.

Por exemplo, suponha que haja um WebPart controle capaz de ser um provedor, um WebPart controle capaz de ser um consumidor, eles são declarados em um WebPartZone na página e estão desconectados no momento. Quando um usuário alterna a página para o modo de conexão e clica no verbo de conexão em um dos controles, o ConnectionsZone controle gera uma interface do usuário com um link que, quando clicado, exibe um formulário no qual os usuários podem escolher opções para criar uma conexão. (Se os controles foram conectados anteriormente, a exibição inicial, em vez disso, apresenta aos usuários um botão para desconectar os controles). Na interface do usuário de conexão para criar novas conexões, os usuários são mostrados qual controle é um provedor e qual controle é um consumidor. Um controle de lista suspensa aparece abaixo de cada controle de servidor, listando os objetos disponíveis ConnectionPoint para o controle. Nas respectivas listas suspensas, os usuários devem selecionar um ProviderConnectionPoint objeto para o provedor (para determinar qual interface e dados serão compartilhados com os consumidores) e um ConsumerConnectionPoint objeto para cada consumidor (para determinar qual interface e dados o consumidor consumirá) que será conectado ao provedor.

Observação

Na implementação padrão do conjunto de controle de Web Parts, um provedor pode se conectar a muitos consumidores, mas um consumidor pode ter apenas um provedor.

Para usar o ConnectionsZone controle, você pode declará-lo dentro do <form> elemento em uma página da Web (mas não aninhado em outro elemento de zona de Web Parts), usando o <asp:connectionszone> elemento ou pode adicioná-lo à página programaticamente. Se você declarar o elemento em uma página, ao contrário das outras zonas de Web Parts, não poderá declarar nenhum outro tipo de controle de servidor entre as marcas do <asp:connectionszone> elemento. Você pode declarar elementos dentro dele relacionados a suas próprias propriedades e detalhes de estilo, mas ele é um elemento autônomo e não é um controle de modelo no qual outros controles de servidor podem ser declarados.

Observação

Para melhorar a acessibilidade, o ConnectionsZone controle é renderizado em um <fieldset> elemento . O <fieldset> elemento agrupa o conjunto relacionado de controles usados para estabelecer conexões no controle e facilita a ConnectionsZone navegação com guias entre esses controles para agentes de usuário visual (como navegadores da Web comuns) e agentes de usuário orientados à fala (como software de leitura de tela).

O ConnectionsZone controle tem várias propriedades que usa para renderizar a interface do usuário da conexão. Um conjunto de propriedades inclui vários verbos, usados apenas em relação a conexões, que executam ações na interface do usuário: ConfigureVerb, ConnectVerbe DisconnectVerb. Um grande conjunto de propriedades, usado especialmente para a interface do usuário da zona de conexões, consiste em cadeias de caracteres de texto exibidas em vários locais (ou em determinadas situações, como quando ocorrem erros) na interface do usuário: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToConsumerText, ExistingConnectionErrorMessage ProvidersInstructionText ConsumersTitle ConsumersInstructionText GetFromText ConnectToProviderTitle GetText ConnectToProviderText InstructionTitle NewConnectionErrorMessage ConnectToProviderInstructionText ConnectToConsumerTitle NoExistingConnectionTitle ProvidersTitle NoExistingConnectionInstructionText SendTexte .SendToText A ConnectionsZone classe também contém várias propriedades comuns encontradas em outras zonas de Web Parts: CancelVerb, CloseVerb, , Display, EmptyZoneText, HeaderTexte InstructionText PartChromeType. Por fim, a WebPartToConnect propriedade é exclusiva para a classe , fazendo referência ao controle que inicia a conexão (esse é o controle no qual o usuário clica no verbo de conexão em seu menu de verbos, que também é o controle referenciado na WebPartManager propriedade do SelectedWebPart controle).

A ConnectionsZone classe também tem vários métodos, todos herdados e substituídos de classes base, e a maioria deles vem das classes de zona de Web Parts base. Para obter detalhes, consulte os métodos individuais.

Notas aos Herdeiros

A ConnectionsZone classe poderá ser estendida se os desenvolvedores quiserem alterar seu comportamento ou a interface do usuário padrão que ela fornece para trabalhar com conexões.

Construtores

ConnectionsZone()

Inicializa uma nova instância da classe ConnectionsZone.

Propriedades

AccessKey	Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
AssociatedDisplayModes	Obtém a coleção de objetos WebPartDisplayMode associados a uma zona ToolZone específica. (Herdado de ToolZone)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl)
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
BackImageUrl	Obtém ou define a URL de uma imagem da tela de fundo para uma zona. (Herdado de WebZone)
BindingContainer	Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controle Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl)
CancelVerb	Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais cancelar o processo de estabelecimento de uma conexão.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
CloseVerb	Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais fechar a IU (interface do usuário) de conexão criada pelo controle ConnectionsZone.
ConfigureConnectionTitle	Obtém ou define o texto exibido como o título de uma subseção da IU (interface do usuário) de conexão criada por um controle ConnectionsZone.
ConfigureVerb	Obtém uma referência a um objeto WebPartVerb usado para abrir a exibição de configuração na IU (interface do usuário) de conexão.
ConnectToConsumerInstructionText	Obtém ou define o texto de instrução exibido na seção da IU (interface do usuário) de conexão em que os usuários selecionam um ponto de conexão do consumidor ao qual o provedor se conectará.
ConnectToConsumerText	Obtém ou define o texto de um hiperlink no qual os usuários clicam para abrir uma exibição na qual eles podem escolher um controle de consumidor para uma conexão.
ConnectToConsumerTitle	Obtém ou define o texto do título da seção na IU (interface do usuário) de conexão na qual os usuários podem selecionar um consumidor específico com o qual se conectar.
ConnectToProviderInstructionText	Obtém ou define o texto de instrução exibido na seção da IU (interface do usuário) de conexão em que os usuários selecionam um ponto de conexão do provedor ao qual o consumidor se conectará.
ConnectToProviderText	Obtém ou define o texto de um hiperlink no qual os usuários clicam para abrir uma exibição na qual eles podem escolher um controle do provedor para uma conexão.
ConnectToProviderTitle	Obtém ou define o texto do título da seção na IU (interface do usuário) de conexão na qual os usuários podem selecionar um provedor específico com o qual se conectar.
ConnectVerb	Obtém uma referência a um objeto WebPartVerb que permite que dois controles WebPart estabeleçam uma conexão.
ConsumersInstructionText	Obtém ou define o texto de instrução mostrado na seção de consumidores da IU (interface do usuário) de conexão quando uma conexão já existe.
ConsumersTitle	Obtém ou define o título mostrado acima da seção de consumidores da IU (interface do usuário) de conexão quando uma conexão já existe.
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que representa os controles filho em um CompositeControl. (Herdado de CompositeControl)
ControlStyle	Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
DisconnectVerb	Obtém uma referência a um objeto WebPartVerb que permite que um usuário desconecte dois controles WebPart conectados.
Display	Obtém um valor que indica se um controle ToolZone é exibido no momento.
EditUIStyle	Obtém os atributos de estilo para os controles editáveis contidos em um controle ToolZone. (Herdado de ToolZone)
EmptyZoneText	Obterá ou definirá uma mensagem de texto exibida em um controle ConnectionsZone vazio se houver controles insuficientes em uma página da Web para estabelecer uma conexão.
EmptyZoneTextStyle	Obtém os atributos de estilo para o texto de espaço reservado em uma zona vazia. (Herdado de WebZone)
Enabled	Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl)
EnableViewState	Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
ErrorStyle	Obtém os atributos de estilo para renderizar a mensagem de erro que será exibida se um controle WebPart não puder ser carregado ou criado. (Herdado de WebZone)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
ExistingConnectionErrorMessage	Obterá ou definirá o texto de uma mensagem exibido na IU (interface do usuário) de conexão quando houver um erro ou aviso em uma conexão existente.
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
FooterStyle	Obtém os atributos de estilo para o conteúdo da área de rodapé da zona. (Herdado de WebZone)
ForeColor	Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl)
GetFromText	Obtém ou define o texto mostrado na seção da IU (interface do usuário) de conexão que precede o provedor nomeado do qual um consumidor recuperará dados.
GetText	Obtém ou define o texto mostrado na seção da IU (interface do usuário) de conexão que precede o consumidor nomeado que receberá dados de um provedor.
HasAttributes	Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
HasFooter	Obtém um valor que indica se uma zona tem uma área de rodapé. (Herdado de WebZone)
HasHeader	Obtém um valor que indica se uma zona tem uma área de cabeçalho. (Herdado de WebZone)
HeaderCloseVerb	Obtém uma referência ao objeto WebPartVerb no cabeçalho de um controle ToolZone que é usado para fechar o controle. (Herdado de ToolZone)
HeaderStyle	Obtém os atributos de estilo para o conteúdo da área do cabeçalho da zona. (Herdado de WebZone)
HeaderText	Obtém ou define o texto do cabeçalho que aparece na parte superior da IU (interface do usuário) de conexão criada pelo controle ConnectionsZone.
HeaderVerbStyle	Obtém os atributos de estilo para todos os verbos de cabeçalho exibidos em um controle ToolZone. (Herdado de ToolZone)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
InstructionText	Obtém ou define o texto usado para instruções gerais sobre o controle selecionado na seção da UI (interface do usuário) de conexão para gerenciar conexões existentes.
InstructionTextStyle	Obtém os atributos de estilo para o texto de instrução exibido na parte superior de um controle ToolZone. (Herdado de ToolZone)
InstructionTitle	Obtém ou define o texto usado para uma descrição geral da ação que pode ser executada no controle do consumidor ou do provedor, dentro da IU (interface do usuário) de conexão para gerenciar conexões existentes.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LabelStyle	Obtém os atributos de estilo para o conteúdo dos rótulos exibidos junto com os controles de edição dentro de um controle ToolZone. Os controles ToolZone derivados, como CatalogZone e EditorZone, aplicam os estilos aos rótulos. (Herdado de ToolZone)
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
NewConnectionErrorMessage	Obterá ou definirá o texto de uma mensagem exibido na IU (interface do usuário) de conexão quando houver um erro ou aviso sobre uma nova conexão que o usuário tentar criar.
NoExistingConnectionInstructionText	Obterá ou definirá o texto de instrução que aparece no corpo da IU (interface do usuário) de conexão quando um controle de Web Parts não tiver nenhuma conexão existente.
NoExistingConnectionTitle	Obterá ou definirá o texto do título que aparece no corpo da IU (interface do usuário) de conexão quando um controle de Web Parts não tiver nenhuma conexão existente.
Padding	Obtém ou define os atributos de preenchimento de célula em uma tabela que contém o controles WebPart em uma zona. (Herdado de WebZone)
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
PartChromePadding	Obtém ou define a distância entre o conteúdo de um controle WebPart e a borda do controle. (Herdado de WebZone)
PartChromeStyle	Obtém as características de estilo que se aplicam às bordas dos controles de Web Parts contidos por uma zona. (Herdado de WebZone)
PartChromeType	Obtém ou define o tipo de borda que enquadra os controles de servidor contidos em um controle ConnectionsZone.
PartStyle	Obtém as características de estilo que se aplicam às bordas e ao conteúdo de cada controle de Web Parts contido por uma zona. (Herdado de WebZone)
PartTitleStyle	Obtém os atributos de estilo do conteúdo da barra de título de cada controle de Web Parts contido por uma zona. (Herdado de WebZone)
ProvidersInstructionText	Obtém ou define o texto de instrução mostrado na seção de provedores da IU (interface do usuário) de conexão quando uma conexão já existe.
ProvidersTitle	Obtém ou define o título mostrado acima da seção de provedores da IU (interface do usuário) de conexão quando uma conexão já existe.
RenderClientScript	Obtém um valor que indica se o script de cliente em uma página de Web Parts deve ser renderizado. (Herdado de WebZone)
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
SendText	Obtém ou define o texto mostrado na seção da IU (interface do usuário) de conexão que precede o provedor nomeado que enviará dados para um consumidor.
SendToText	Obtém ou define o texto mostrado na seção da IU (interface do usuário) de conexão que precede o consumidor nomeado para o qual um provedor enviará dados.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a capa a ser aplicada ao controle. (Herdado de WebControl)
Style	Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o atributo `disabled` do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é `false`. (Herdado de CompositeControl)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o valor HtmlTextWriterTag que corresponde ao controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebZone)
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TemplateControl	Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
VerbButtonType	Obtém ou define o tipo de botão usado para representar verbos em uma zona. (Herdado de WebZone)
VerbStyle	Obtém os atributos de estilo para os verbos da UI (interface do usuário) associados aos controles de Web Parts em uma zona. (Herdado de WebZone)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como um elemento da interface do usuário na página. (Herdado de ToolZone)
WebPartManager	Obtém uma referência para o controle WebPartManager associado a uma instância do controle WebZone em uma página de Web Parts. (Herdado de WebZone)
WebPartToConnect	Obtém o controle WebPart selecionado no momento com o qual se conectar.
Width	Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)	Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control)
ApplyStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
Close()	Fecha a IU (interface do usuário) de conexão criada pelo controle ConnectionsZone.
CopyBaseAttributes(WebControl)	Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateChildControls()	Cria todos os controles filho contidos em um controle ConnectionsZone na preparação para postar de volta no servidor ou para renderizar.
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
DataBind()	Associa uma fonte de dados ao CompositeControl e a todos os seus controles filho. (Herdado de CompositeControl)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de Control)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para um controle. (Herdado de Control)
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetEffectiveChromeType(Part)	Retorna o valor PartChromeType atual real ou efetivo de um controle WebPart, considerando a propriedade PartChromeType da zona e o modo de exibição atual da página de Web Parts. (Herdado de WebZone)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado do controle de uma solicitação de página anterior que foi salva pelo método SaveControlState().
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState().
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MergeStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Aciona o evento DisplayModeChanged.
OnInit(EventArgs)	Aciona o evento Init.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Aciona o evento SelectedWebPartChanged.
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RaisePostBackEvent(String)	Gera um evento para o controle ConnectionsZone quando o formulário que o contém o posta de volta no servidor.
RecreateChildControls()	Recria os controles filho em um controle derivado de CompositeControl. (Herdado de CompositeControl)
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o conteúdo do controle ConnectionsZone para o objeto HtmlTextWriter especificado.
RenderBeginTag(HtmlTextWriter)	Renderiza a marca HTML de abertura do controle de zona para o objeto HtmlTextWriter especificado. (Herdado de WebZone)
RenderBody(HtmlTextWriter)	Envia o conteúdo de uma área do corpo do controle ConnectionsZone para o objeto HtmlTextWriter especificado, que grava o conteúdo na página da Web.
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza todo o conteúdo de um controle de zona entre as marcas inicial e final no objeto HtmlTextWriter especificado. (Herdado de WebZone)
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderFooter(HtmlTextWriter)	Substitui o método base para renderizar verbos no rodapé de um controle ToolZone. (Herdado de ToolZone)
RenderHeader(HtmlTextWriter)	Substitui o método base para fornecer renderização especializada para a área de cabeçalho necessária para os controles ToolZone. (Herdado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Renderiza um verbo individual com um controle ToolZone. (Herdado de ToolZone)
RenderVerbs(HtmlTextWriter)	Renderiza os verbos de nível de zona para um controle ConnectionsZone.
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de Web Parts que ocorreram desde a última vez que a página foi postada de volta no servidor.
SaveViewState()	Salva as alterações no estado de exibição de um controle ConnectionsZone que ocorreram desde que a página foi postada pela última vez no servidor.
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Rastreia alterações de estado de exibição no controle ConnectionsZone de modo que as alterações possam ser armazenadas no objeto StateBag do controle.

Eventos

DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite que um designer recrie a coleção de controles filho do controle de composição no ambiente de tempo de design. (Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementa o método RaisePostBackEvent(String). (Herdado de ToolZone)

Métodos de Extensão

FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.
GetDefaultValues(INamingContainer)	Obtém a coleção de valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

Aplica-se a

Partilhar via