ConnectionsZone Třída

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Poskytuje uživatelské rozhraní,které umožňuje uživatelům vytvořit připojení mezi WebPart ovládacími prvky serveru a jinými ovládacími prvky serveru umístěnými v WebPartZoneBase zónách.

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

Dědičnost

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Příklady

Následující příklad kódu ukazuje použití ConnectionsZone ovládacího prvku na stránce webových částí. Příklad má čtyři části:

• Uživatelský ovládací prvek, který umožňuje přepínat režimy zobrazení na webové stránce.

• Zdrojový soubor, který obsahuje kód pro rozhraní PSČ, a dva WebPart ovládací prvky, které fungují jako zprostředkovatel a příjemce připojení.

• Webová stránka, která je hostitelem všech ovládacích prvků, ukazuje, jak deklarovat <asp:connectionszone> prvek, a nastaví řadu vlastností zóny připojení deklarativním a programovým způsobem.

• Vysvětlení fungování příkladu v prohlížeči

První část tohoto příkladu kódu je uživatelský ovládací prvek, který uživatelům umožňuje přepínat režimy zobrazení na webové stránce. Podrobnosti o režimech zobrazení a popis zdrojového kódu v tomto ovládacím prvku naleznete v návodu : Změna režimů zobrazení na stránce webových částí.

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

Druhou částí příkladu je zdrojový soubor s rozhraním a vlastními ovládacími prvky. Všimněte si, že ZipCodeWebPart ovládací prvek implementuje IZipCode rozhraní a přidává ConnectionProvider atribut, aby ovládací prvek mohl fungovat jako zprostředkovatel pro připojení. Ovládací WeatherWebPart prvek má metodu označenou atributem ConnectionConsumer , kde využívá IZipCode rozhraní, takže může fungovat jako spotřebitel v připojení.

Pro spuštění příkladu kódu je nutné zkompilovat tento zdrojový kód. Můžete jej explicitně zkompilovat a výsledné sestavení umístit do složky Bin vašeho webu nebo globální mezipaměti sestavení. Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Tento příklad používá dynamickou kompilaci. Návod, který ukazuje, jak se zkompilovat, naleznete v části Návod: Vývoj a použití vlastního ovládacího prvku webového serveru.

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

Třetí částí ukázkového kódu je webová stránka. V horní části jsou Register direktivy pro uživatelský ovládací prvek a vlastní ovládací prvky použité v připojení. Prvek <asp:connectionszone> je deklarován na stránce jako příklad použití ConnectionsZone ovládacího prvku deklarativní. V rámci elementu je nastaveno několik vlastností deklarativním způsobem. Další vlastnosti v zóně připojení jsou nastaveny programově v <script> části stránky.

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

Načtěte webovou stránku v prohlížeči. K přepnutí stránky do režimu připojení použijte ovládací prvek rozevíracího seznamu Režim zobrazení . V nabídce sloves v ovládacím prvku Zprostředkovatele PSČ (nabídka sloves je označena šipkou dolů v záhlaví ovládacího prvku), klikněte na spojovací sloveso. Zobrazí se ConnectionsZone ovládací prvek. Všimněte si, že v uživatelském rozhraní připojení se zobrazí tlačítko Ukončit připojení ; připojení již bylo deklarováno v kódu stránky, takže ovládací prvky jsou již připojeny. Klepněte na tlačítko Ukončit připojení a potom pomocí ovládacího prvku Režim zobrazení znovu vrátit stránku do režimu procházení. V dalším kroku vraťte stránku, abyste se připojili do režimu připojení, klikněte na příkaz pro připojení na jednom z ovládacích prvků a všimněte si, že uživatelské rozhraní připojení teď zobrazuje hypertextový odkaz, který umožňuje vytvořit propojení mezi ovládacími prvky. Klikněte na odkaz a pomocí uživatelského rozhraní připojení vyberte spojovací body a vytvořte připojení.

Poznámky

Pomocí sadyovládacíchm prvkům můžete povolit pomocí sady ovládacích prvků Webové části a druhý ovládací prvek, který funguje jako příjemce dat. Tyto dva ovládací prvky mohou být WebPart ovládací prvky nebo jakýkoli jiný typ serverového ovládacího prvku za předpokladu, že jsou navržené pro zpracování připojení a že se nacházejí v WebPartZoneBase zóně. Další informace o připojeních webových částí najdete v WebPartConnection přehledech tříd a ConnectionPoint také přehled připojení webových částí.

Za předpokladu, že existují požadované ovládací prvky a podmínky pro vytvoření připojení webových částí, je stále nutné ovládací prvky skutečně propojit. Existují tři způsoby, jak vytvořit propojení mezi ovládacími prvky serveru: deklarováním připojení na webové stránce, vytvořením připojení v kódu nebo přidáním ConnectionsZone ovládacího prvku na stránku, aby uživatelé mohli ovládací prvky připojit na vyžádání. Ovládací ConnectionsZone prvek vygeneruje uživatelské rozhraní, které uživatelům umožňuje připojit nebo odpojit všechny ovládací prvky serveru na stránce, které splňují podmínky potřebné k vytvoření připojení. Jedná se o volitelný ovládací prvek, který není nutný k vytvoření připojení, ale je užitečný v případě, že chcete uživatelům udělit kontrolu nad tím, které ovládací prvky serveru jsou připojené nebo odpojené.

Ovládací ConnectionsZone prvek je jedním z ovládacích prvků zóny nástrojů webových částí, které dědí ze ToolZone základní třídy. Jako zóna nástrojů je ovládací prvek navržený tak, aby byl viditelný pouze v případě, ConnectionsZone že je webová stránka v určitém režimu zobrazení. V tomto případě se režim zobrazení jmenuje režim připojení (stránka je v tomto režimu, pokud WebPartManager má ovládací prvek na stránce jeho DisplayMode vlastnost nastavenou ConnectDisplayModehodnotu ). Jakmile uživatelé přepnou stránku do režimu připojení, musí kliknout na příkazy v nabídce příkazů jednoho z ovládacích prvků serveru a pak se uživatelské rozhraní připojení zobrazí.

Jako ovládací prvek zóny webových částí je ovládací prvek typem WebZone zóny (která dědí z CompositeControl třídy) navržená tak, ConnectionsZone aby obsahovala jiné ovládací prvky. Obecně platí, že ConnectionsZone zóna má většinu stejných prvků jako ostatní zóny nástrojů webových částí: záhlaví, oblast textu nebo obsahu a zápatí. Úplnou diskuzi o tom, co je zóna webových částí a o různých částech zóny, najdete v přehledu WebZone třídy.

Důležité

Na rozdíl od většiny ostatních zón webových částí je důležité si uvědomit, že ConnectionsZone zóna neobsahuje jedinečný typ ovládacího prvku serveru, který je k němu přidružený. Seznam zón a přidružených ovládacích prvků, které obsahují, najdete v grafu v přehledu WebZone třídy. Zóna ale neobsahuje ConnectionsZoneWebPartConnection ovládací prvky. Místo toho slouží k velmi omezenému účelu poskytování uživatelského rozhraní uživatelům pro připojení nebo odpojení serverových ovládacích prvků, které existují v určité WebPartZoneBase zóně na stránce. Jedinými ovládacími prvky obsaženými v ovládacím ConnectionsZone prvku jsou standardní ASP.NET serverové ovládací prvky, které generuje jako součást uživatelského rozhraní pro vytváření připojení.

ConnectionsZone Při vykreslení ovládacího prvku vygeneruje uživatelské rozhraní založené na serverových ovládacích prvcích na stránce, které jsou schopné vytvořit připojení. Ovládací ConnectionsZone prvek určuje, které ovládací prvky serveru v WebPartZoneBase zóně na stránce jsou zprostředkovatelé, což jsou příjemci, které spojovací body jsou k dispozici, a zda jsou ovládací prvky serveru aktuálně připojené nebo odpojené, a pak odpovídajícím způsobem vygeneruje uživatelské rozhraní.

Předpokládejme například, že existuje jeden WebPart ovládací prvek schopný být zprostředkovatel, jeden WebPart ovládací prvek schopný být příjemcem, jsou deklarovány na WebPartZone stránce a jsou aktuálně odpojeny. Když uživatel přepne stránku do režimu připojení a klikne na příkaz připojení na jednom z ovládacích prvků, ConnectionsZone ovládací prvek vygeneruje uživatelské rozhraní s odkazem, který po kliknutí zobrazí formulář, ve kterém mohou uživatelé zvolit možnosti pro vytvoření připojení. (Pokud byly ovládací prvky dříve připojené, zobrazí se místo toho uživatelům tlačítko pro odpojení ovládacích prvků. V uživatelském rozhraní připojení pro vytváření nových připojení se uživatelům zobrazí, který ovládací prvek je zprostředkovatel a který ovládací prvek je příjemcem. Pod jednotlivými ovládacími prvky serveru se zobrazí ovládací prvek rozevíracího seznamu se seznamem dostupných ConnectionPoint objektů ovládacího prvku. V příslušných rozevíracích seznamech musí uživatelé vybrat jeden ProviderConnectionPoint objekt pro poskytovatele (určit, jaké rozhraní a data budou sdíleny se spotřebiteli) a jeden ConsumerConnectionPoint objekt pro každého příjemce (určit, jaké rozhraní a data příjemce bude spotřebovávat), který bude připojen k poskytovateli.

Poznámka:

V ovládacím prvku webové části nastavit výchozí implementaci, jeden zprostředkovatel se může připojit k mnoha příjemcům, ale příjemce může mít pouze jednoho zprostředkovatele.

Pokud chcete ovládací prvek použít ConnectionsZone , můžete ho deklarovat v rámci <form> elementu na webové stránce (ale ne vnořeno do jiného prvku zóny webových částí), pomocí elementu <asp:connectionszone> nebo ho můžete přidat na stránku programově. Pokud deklarujete prvek na stránce, na rozdíl od ostatních zón webových částí, nelze deklarovat žádný jiný typ serverových ovládacích prvků mezi značkami <asp:connectionszone> prvku. Můžete v něm deklarovat prvky, které se vztahují k vlastním vlastnostem a podrobnostem stylu, ale jedná se o samostatný prvek a není to ovládací prvek šablony, ve kterém lze deklarovat jiné ovládací prvky serveru.

Poznámka:

Aby se zlepšila přístupnost, ConnectionsZone ovládací prvek se vykreslí v rámci elementu <fieldset> . Element <fieldset> seskupuje související sadu ovládacích prvků používaných k navazování připojení v ovládacím ConnectionsZone prvku a usnadňuje navigaci na záložkách mezi těmito ovládacími prvky pro vizuální uživatelské agenty (například běžné webové prohlížeče) a agenty uživatele orientované na řeč (například software pro čtení obrazovky).

Ovládací ConnectionsZone prvek má řadu vlastností, které používá k vykreslení uživatelského rozhraní připojení. Jedna sada vlastností zahrnuje několik sloves - --used pouze ve vztahu k připojení ---, které provádějí akce v uživatelském rozhraní: ConfigureVerb, ConnectVerba DisconnectVerb. Velká sada vlastností, která se používá zejména pro uživatelské rozhraní zóny připojení, se skládá z textových řetězců zobrazených na různých místech (nebo v určitých situacích, například při výskytu chyb) v uživatelském rozhraní: ConfigureConnectionTitle, , ConnectToConsumerTextConnectToConsumerInstructionText, , ConsumersInstructionTextGetFromTextConnectToProviderTextConnectToProviderInstructionTextConnectToProviderTitleConsumersTitleNewConnectionErrorMessageInstructionTitleNoExistingConnectionInstructionTextConnectToConsumerTitleGetTextExistingConnectionErrorMessage, . NoExistingConnectionTitleProvidersInstructionTextProvidersTitleSendTextSendToText Třída ConnectionsZone obsahuje také řadu společných vlastností nalezených v jiných zónách webových částí: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, , InstructionTexta PartChromeType. Nakonec je vlastnost jedinečná pro třídu, odkazující na ovládací prvek, který inicializuje připojení (to je ovládací prvek, WebPartToConnect na kterém uživatel klikne na příkazy v jeho příkazy nabídky, což je také ovládací prvek odkazovaný ve WebPartManager vlastnosti ovládacího prvku SelectedWebPart ).

Třída ConnectionsZone má také řadu metod, z nichž všechny jsou zděděné a přepsány ze základních tříd a většina z nich pochází ze základních tříd zón webových částí. Podrobnosti najdete v jednotlivých metodách.

Poznámky pro dědice

ConnectionsZone Třídu je možné rozšířit, pokud vývojáři chtějí změnit své chování nebo výchozí uživatelské rozhraní, které poskytuje pro práci s připojeními.

Konstruktory

Name	Description
ConnectionsZone()	Inicializuje novou instanci ConnectionsZone třídy.

Vlastnosti

Name	Description
AccessKey	Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl)
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control)
AssociatedDisplayModes	Získá kolekci WebPartDisplayMode objektů, které jsou přidruženy k určité ToolZone zóně. (Zděděno od ToolZone)
Attributes	Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl)
BackColor	Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl)
BackImageUrl	Získá nebo nastaví adresu URL na obrázek pozadí zóny. (Zděděno od WebZone)
BindingContainer	Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control)
BorderColor	Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl)
BorderStyle	Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
BorderWidth	Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
CancelVerb	Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zrušit proces navázání připojení.
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control)
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control)
ClientIDSeparator	Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control)
CloseVerb	Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zavřít připojení uživatelské rozhraní (UI) vytvořené ovládacím ConnectionsZone prvku.
ConfigureConnectionTitle	Získá nebo nastaví text zobrazený jako název pododdílu uživatelského rozhraní připojení vytvořeného ovládacím ConnectionsZone prvku.
ConfigureVerb	Získá odkaz na WebPartVerb objekt použitý k otevření zobrazení konfigurace v uživatelském rozhraní připojení (UI).
ConnectToConsumerInstructionText	Získá nebo nastaví instrukční text zobrazený v části uživatelského rozhraní připojení (UI), kde uživatelé vyberou bod připojení příjemce, ke kterému se poskytovatel připojí.
ConnectToConsumerText	Získá nebo nastaví text hypertextového odkazu, na který uživatelé kliknou, aby otevřeli zobrazení, ve kterém mohou zvolit ovládací prvek příjemce pro připojení.
ConnectToConsumerTitle	Získá nebo nastaví text nadpisu oddílu v uživatelském rozhraní připojení (UI), ve kterém mohou uživatelé vybrat konkrétního příjemce, se kterým se chcete připojit.
ConnectToProviderInstructionText	Získá nebo nastaví instrukční text zobrazený v části uživatelského rozhraní připojení (UI), kde uživatelé vyberou spojovací bod zprostředkovatele, ke kterému se příjemce připojí.
ConnectToProviderText	Získá nebo nastaví text hypertextového odkazu, na který uživatelé kliknou, aby otevřeli zobrazení, ve kterém mohou zvolit ovládací prvek zprostředkovatele pro připojení.
ConnectToProviderTitle	Získá nebo nastaví text nadpisu oddílu v uživatelském rozhraní připojení (UI), ve kterém mohou uživatelé vybrat konkrétního zprostředkovatele, se kterým se chcete připojit.
ConnectVerb	Získá odkaz na WebPartVerb objekt, který umožňuje dva WebPart ovládací prvky navázat připojení.
ConsumersInstructionText	Získá nebo nastaví instrukční text zobrazený v části příjemci uživatelského rozhraní připojení (UI), pokud připojení již existuje.
ConsumersTitle	Získá nebo nastaví název zobrazený nad částí příjemců uživatelského rozhraní připojení (UI), pokud již existuje připojení.
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky v objektu CompositeControl. (Zděděno od CompositeControl)
ControlStyle	Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlStyleCreated	Získá hodnotu určující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
CssClass	Získá nebo nastaví cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl)
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control)
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control)
DisconnectVerb	Získá odkaz na WebPartVerb objekt, který umožňuje uživateli odpojit dva propojené WebPart ovládací prvky.
Display	Získá hodnotu, která určuje, zda ToolZone je ovládací prvek aktuálně zobrazen.
EditUIStyle	Získá atributy stylu pro upravitelné ovládací prvky obsažené v ovládacím ToolZone prvku. (Zděděno od ToolZone)
EmptyZoneText	Získá nebo nastaví textovou zprávu, která je zobrazena v prázdném ConnectionsZone ovládacím prvku, pokud existují nedostatečné ovládací prvky na webové stránce pro navázání připojení.
EmptyZoneTextStyle	Získá atributy stylu pro zástupný text v prázdné zóně. (Zděděno od WebZone)
Enabled	Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl)
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control)
ErrorStyle	Získá atributy stylu pro vykreslení chybové zprávy, která je zobrazena, pokud WebPart ovládací prvek nelze načíst nebo vytvořit. (Zděděno od WebZone)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
ExistingConnectionErrorMessage	Získá nebo nastaví text zprávy zobrazené v uživatelském rozhraní připojení (UI), pokud je u existujícího připojení chyba nebo upozornění.
Font	Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl)
FooterStyle	Získá atributy stylu pro obsah oblasti zápatí zóny. (Zděděno od WebZone)
ForeColor	Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl)
GetFromText	Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), který předchází pojmenovaného zprostředkovatele, ze kterého příjemce načte data.
GetText	Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), který předchází pojmenovaného příjemce, který bude přijímat data od zprostředkovatele.
HasAttributes	Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl)
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control)
HasFooter	Získá hodnotu určující, zda zóna má oblast zápatí. (Zděděno od WebZone)
HasHeader	Získá hodnotu určující, zda zóna má oblast záhlaví. (Zděděno od WebZone)
HeaderCloseVerb	Získá odkaz na WebPartVerb objekt v záhlaví ToolZone ovládacího prvku, který slouží k zavření ovládacího prvku. (Zděděno od ToolZone)
HeaderStyle	Získá atributy stylu pro obsah oblasti záhlaví zóny. (Zděděno od WebZone)
HeaderText	Získá nebo nastaví text záhlaví, který se zobrazí v horní části uživatelského rozhraní připojení vytvořené ovládacím prvkem ConnectionsZone .
HeaderVerbStyle	Získá atributy stylu pro všechny příkazy záhlaví zobrazené v ovládacím ToolZone prvku. (Zděděno od ToolZone)
Height	Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl)
ID	Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
InstructionText	Získá nebo nastaví text, který se používá pro obecné pokyny k vybranému ovládacímu prvku v části uživatelského rozhraní připojení (UI) pro správu existujících připojení.
InstructionTextStyle	Získá atributy stylu pro instrukční text, který se zobrazí v horní části ToolZone ovládacího prvku. (Zděděno od ToolZone)
InstructionTitle	Získá nebo nastaví text, který se používá pro obecný popis akce, kterou lze provést u ovládacího prvku příjemce nebo zprostředkovatele v rámci uživatelského rozhraní připojení pro správu existujících připojení.
IsChildControlStateCleared	Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control)
IsEnabled	Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LabelStyle	Získá atributy stylu pro obsah popisků, které se zobrazí spolu s ovládacími prvky pro úpravy v ovládacím ToolZone prvku. Odvozené ToolZone ovládací prvky, například CatalogZone a EditorZone, aplikují styly na popisky. (Zděděno od ToolZone)
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
NewConnectionErrorMessage	Získá nebo nastaví text zprávy zobrazené v uživatelském rozhraní připojení (UI), pokud dojde k chybě nebo upozornění na nové připojení, které se uživatel pokusí vytvořit.
NoExistingConnectionInstructionText	Získá nebo nastaví instrukční text, který se zobrazí v těle uživatelského rozhraní připojení (UI), pokud ovládací prvek webové části nemá žádné existující připojení.
NoExistingConnectionTitle	Získá nebo nastaví text nadpisu, který se zobrazí v těle uživatelského rozhraní připojení (UI), když ovládací prvek webové části nemá žádné existující připojení.
Padding	Získá nebo nastaví atributy odsazení buňky v tabulce, která obsahuje WebPart ovládací prvky v zóně. (Zděděno od WebZone)
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
PartChromePadding	Získá nebo nastaví vzdálenost mezi obsahem WebPart ovládacího prvku a ohraničení ovládacího prvku. (Zděděno od WebZone)
PartChromeStyle	Získá vlastnosti stylu, které se vztahují na ohraničení ovládacích prvků webových částí obsažených v zóně. (Zděděno od WebZone)
PartChromeType	Získá nebo nastaví typ ohraničení, které rámuje serverové ovládací prvky obsažené v ovládacím ConnectionsZone prvku.
PartStyle	Získá vlastnosti stylu, které se vztahují na ohraničení a obsah každého ovládacího prvku webové části obsažené v zóně. (Zděděno od WebZone)
PartTitleStyle	Získá atributy stylu pro obsah záhlaví pro každý ovládací prvek webové části obsažené v zóně. (Zděděno od WebZone)
ProvidersInstructionText	Získá nebo nastaví instrukční text zobrazený v části zprostředkovatele uživatelského rozhraní připojení (UI), pokud připojení již existuje.
ProvidersTitle	Získá nebo nastaví název zobrazený nad částí zprostředkovatelů uživatelského rozhraní připojení (UI), pokud připojení již existuje.
RenderClientScript	Získá hodnotu, která určuje, zda se má vykreslit klientský skript na stránce webových částí. (Zděděno od WebZone)
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control)
SendText	Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), který předchází pojmenovaného zprostředkovatele, který bude odesílat data příjemci.
SendToText	Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), který předchází pojmenovaného příjemce, do kterého zprostředkovatel odešle data.
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od WebControl)
Style	Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která určuje, zda ovládací prvek má nastavit disabled atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je false. (Zděděno od CompositeControl)
TabIndex	Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl)
TagKey	Získá hodnotu, která odpovídá tomuto ovládacímu HtmlTextWriterTag prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebZone)
TagName	Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control)
ToolTip	Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control)
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
VerbButtonType	Získá nebo nastaví, jaký typ tlačítka se používá k reprezentaci sloves v zóně. (Zděděno od WebZone)
VerbStyle	Získá atributy stylu pro příkazy uživatelského rozhraní (UI) přidružené k ovládacím částem webových částí v zóně. (Zděděno od WebZone)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako prvek uživatelského rozhraní (UI) na stránce. (Zděděno od ToolZone)
WebPartManager	Získá odkaz na WebPartManager ovládací prvek přidružený k WebZone instanci ovládacího prvku na stránce webových částí. (Zděděno od WebZone)
WebPartToConnect	Získá aktuálně vybraný WebPart ovládací prvek pro připojení.
Width	Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl)

Metody

Name	Description
AddAttributesToRender(HtmlTextWriter)	Přidá atributy a styly HTML, které je třeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control)
ApplyStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na nullhodnotu . (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
Close()	Zavře uživatelské rozhraní připojení vytvořené ovládacím ConnectionsZone prvku.
CopyBaseAttributes(WebControl)	Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
CreateChildControls()	Vytvoří všechny podřízené ovládací prvky obsažené v ovládacím ConnectionsZone prvku při přípravě na publikování zpět na server nebo vykreslování.
CreateControlCollection()	Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control)
CreateControlStyle()	Vytvoří objekt stylu, který je interně WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
DataBind()	Vytvoří vazbu zdroje dat s podřízenými CompositeControl ovládacími prvky a všemi jeho podřízenými ovládacími prvky. (Zděděno od CompositeControl)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným id a celé číslo zadané v parametru pathOffset , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat. (Zděděno od Control)
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným id parametrem. (Zděděno od Control)
Focus()	Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetEffectiveChromeType(Part)	Vrátí skutečnou WebPart nebo efektivní aktuální PartChromeType hodnotu ovládacího prvku vzhledem k PartChromeType vlastnosti zóny a aktuální režim zobrazení stránky webových částí. (Zděděno od WebZone)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
IsLiteralContent()	Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() .
LoadViewState(Object)	Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena metodou SaveViewState() .
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MergeStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	DisplayModeChanged Vyvolá událost.
OnInit(EventArgs)	Init Vyvolá událost.
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	SelectedWebPartChanged Vyvolá událost.
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá použité ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control)
RaisePostBackEvent(String)	Vyvolá událost pro ConnectionsZone ovládací prvek, když formulář, který obsahuje, publikuje zpět na server.
RecreateChildControls()	Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl. (Zděděno od CompositeControl)
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Vykreslí obsah ConnectionsZone ovládacího prvku na zadaný HtmlTextWriter objekt.
RenderBeginTag(HtmlTextWriter)	Vykreslí levou značku HTML ovládacího prvku zóny na zadaný HtmlTextWriter objekt. (Zděděno od WebZone)
RenderBody(HtmlTextWriter)	Odešle obsah ConnectionsZone oblasti těla ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah na webovou stránku.
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí celý obsah ovládacího prvku zóny mezi počáteční a koncovou značkou do zadaného HtmlTextWriter objektu. (Zděděno od WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
RenderFooter(HtmlTextWriter)	Přepíše základní metodu pro vykreslení sloves v zápatí ToolZone ovládacího prvku. (Zděděno od ToolZone)
RenderHeader(HtmlTextWriter)	Přepíše základní metodu tak, aby poskytovala specializované vykreslování oblasti záhlaví vyžadované ovládacími ToolZone prvky. (Zděděno od ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Vykreslí jednotlivé sloveso pomocí ToolZone ovládacího prvku. (Zděděno od ToolZone)
RenderVerbs(HtmlTextWriter)	Vykreslí příkazy na úrovni zóny pro ConnectionsZone ovládací prvek.
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu ovládacího prvku webové části, ke kterým došlo od posledního publikování stránky zpět na server.
SaveViewState()	ConnectionsZone Uloží změny stavu zobrazení ovládacího prvku, ke kterým došlo od posledního publikování stránky zpět na server.
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Sleduje změny ConnectionsZone stavu zobrazení ovládacího prvku, aby se změny mohly uložit do objektu StateBag ovládacího prvku.

Událost

Name	Description
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control)
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

Name	Description
IAttributeAccessor.GetAttribute(String)	Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)	Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Umožňuje návrháři znovu vytvořit kolekci podřízených ovládacích prvků složeného ovládacího prvku v prostředí návrhu. (Zděděno od CompositeControl)
IControlBuilderAccessor.ControlBuilder	Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementuje metodu RaisePostBackEvent(String) . (Zděděno od ToolZone)

Metody rozšíření

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
EnableDynamicData(INamingContainer, Type, Object)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
EnableDynamicData(INamingContainer, Type)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.
GetDefaultValues(INamingContainer)	Získá kolekci výchozích hodnot pro zadaný ovládací prvek dat.
GetMetaTable(INamingContainer)	Získá metadata tabulky pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable, Object)	Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable)	Nastaví metadata tabulky pro zadaný ovládací prvek dat.
TryGetMetaTable(INamingContainer, MetaTable)	Určuje, zda jsou k dispozici metadata tabulky.

Viz také

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• ovládací prvky webových částí ASP.NET
• Přehled připojení webových částí