Sdílet prostřednictvím


ConnectionsZone Třída

Definice

Poskytuje uživatelské rozhraní(UI), které umožňuje uživatelům vytvářet připojení mezi WebPart a dalšími serverovými ovládacími prvky, které se nacházejí 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

Příklady

Následující příklad kódu ukazuje, jak použít ConnectionsZone ovládací prvek 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 deklarativně a programově nastaví řadu vlastností v zóně připojení.

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

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje uživatelům 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 najdete v tématu Návod: 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 připojení. Ovládací WeatherWebPart prvek má metodu označenou atributem ConnectionConsumer , kde využívá IZipCode rozhraní, takže může v připojení fungovat jako příjemce.

Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a umístit výsledné sestavení do složky Bin 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 kompilovat, najdete v tématu 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í. Element <asp:connectionszone> je deklarován na stránce jako příklad použití ConnectionsZone ovládacího prvku deklarativně. V rámci elementu je několik vlastností nastaveno deklarativně. Další vlastnosti v zóně připojení se nastavují 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. Pomocí ovládacího prvku rozevíracího seznamu Režim zobrazení přepněte stránku do režimu připojení. V nabídce sloves ovládacího prvku zprostředkovatele PSČ (nabídka sloves je označená šipkou dolů v záhlaví ovládacího prvku) klikněte na příkaz připojit. Zobrazí ConnectionsZone se 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. Klikněte na Ukončit připojení a pak znovu pomocí ovládacího prvku Režim zobrazení vraťte stránku do režimu procházení. V dalším kroku vraťte stránku do režimu připojení, klikněte na příkaz připojit u jednoho z ovládacích prvků a všimněte si, že uživatelské rozhraní připojení teď zobrazí hypertextový odkaz, který umožňuje vytvořit spojení mezi ovládacími prvky. Klikněte na odkaz a pomocí uživatelského rozhraní pro připojení vyberte spojovací body a navazujte připojení.

Poznámky

Pomocí sady ovládacích prvků webové části můžete povolit, aby dva serverové ovládací prvky vytvořily připojení a sdílely data, přičemž jeden ovládací prvek funguje jako zprostředkovatel a druhý 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ženy 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 a také v tématu 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ě připojit. Existují tři způsoby, jak vytvořit spojení mezi serverovými ovládacími prvky: deklarování připojení na webové stránce, vytvoření připojení v kódu nebo přidání ConnectionsZone ovládacího prvku na stránku, aby uživatelé mohli připojit ovládací prvky na vyžádání. Ovládací ConnectionsZone prvek vygeneruje uživatelské rozhraní, které uživatelům umožňuje připojit nebo odpojit všechny serverové ovládací prvky na stránce, které splňují podmínky nezbytné pro 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 poskytnout 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ástroje webové části, 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 jeho webová stránka v určitém režimu zobrazení. V tomto případě se režim zobrazení nazývá režim připojení (stránka je v tomto režimu, když WebPartManager má ovládací prvek na stránce hodnotu DisplayMode vlastnosti nastavenou na ConnectDisplayMode). Jakmile uživatelé přepnou stránku do režimu připojení, musí kliknout na příkaz připojit v nabídce sloves některého ze serverových ovládacích prvků 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 obsahoval další ovládací prvky. Obecně platí, že ConnectionsZone zóna obsahuje většinu stejných prvků jako ostatní zóny nástrojů webových částí: záhlaví, oblast obsahu 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é poznamenat, že ConnectionsZone zóna neobsahuje jedinečný typ serverového ovládacího prvku přidruženého k ní. Seznam zón a souvisejících ovládacích prvků, které obsahují, najdete v grafu v přehledu WebZone třídy. ConnectionsZone Zóna ale neobsahuje WebPartConnection ovládací prvky. Místo toho slouží 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 některé WebPartZoneBase zóně na stránce. Jediné ovládací prvky obsažené v ovládacím ConnectionsZone prvku jsou standardní ASP.NET serverové ovládací prvky, které generuje jako součást svého uživatelského rozhraní pro vytváření připojení.

Při vykreslení ConnectionsZone 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 poskytovateli, které jsou spotřebiteli, které body připojení jsou k dispozici a zda jsou ovládací prvky serveru aktuálně připojeny nebo odpojeny, a poté vygeneruje uživatelské rozhraní odpovídajícím způsobem.

Předpokládejme například, že existuje jeden WebPart ovládací prvek, který může být zprostředkovatelem, jeden WebPart ovládací prvek schopný být příjemcem, jsou deklarovány v objektu WebPartZone na stránce a jsou aktuálně odpojené. Když uživatel přepne stránku do režimu připojení a klikne na příkaz připojit 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řipojeny, zobrazí se uživatelům v počátečním zobrazení 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říjemce. Pod každým serverovým ovládacím prvku se zobrazí ovládací prvek rozevíracího seznamu se seznamem dostupných ConnectionPoint objektů pro ovládací prvek. V příslušných rozevíracích seznamech musí uživatelé vybrat jeden ProviderConnectionPoint objekt pro zprostředkovatele (aby bylo možné určit, jaké rozhraní a data budou sdílena se spotřebiteli) a jeden ConsumerConnectionPoint objekt pro každého příjemce (aby bylo možné určit, jaké rozhraní a data bude příjemce využívat), který bude připojen k poskytovateli.

Poznámka

Ve výchozí implementaci ovládacího prvku webové části se jeden zprostředkovatel 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 elementu <form> na webové stránce (ale ne vnořený 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 jiných zón webových částí, nelze deklarovat žádný jiný typ serverových ovládacích prvků mezi značkami elementu <asp:connectionszone> . Můžete v něm deklarovat prvky, které se vztahují k jeho vlastním vlastnostem a podrobnostem o stylu, ale je to samostatný prvek a není to ovládací prvek šablony, ve kterém lze deklarovat jiné serverové ovládací prvky.

Poznámka

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

Ovládací ConnectionsZone prvek má řadu vlastností, které používá pro vykreslení uživatelského rozhraní připojení. Jedna sada vlastností obsahuje několik sloves – používaných pouze ve vztahu k připojením – 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 když dojde k chybám) v uživatelském rozhraní: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToProviderTitleNoExistingConnectionTitleConnectToConsumerTextExistingConnectionErrorMessageConsumersTitleGetFromTextConsumersInstructionTextGetTextConnectToProviderTextInstructionTitleNewConnectionErrorMessageConnectToProviderInstructionTextConnectToConsumerTitleProvidersInstructionTextProvidersTitleNoExistingConnectionInstructionTextSendTexta .SendToText Třída ConnectionsZone obsahuje také řadu společných vlastností nalezených v jiných zónách webových částí: CancelVerb, , DisplayCloseVerb, EmptyZoneText, HeaderTextInstructionText, a PartChromeType. WebPartToConnect Nakonec je vlastnost jedinečná pro třídu a odkazuje na ovládací prvek, který inicializuje připojení (jedná se o ovládací prvek, u kterého uživatel klikne na příkaz connect v nabídce sloves, což je také ovládací prvek odkazovaný ve WebPartManager vlastnosti ovládacího prvkuSelectedWebPart).

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óny webových částí. Podrobnosti najdete v jednotlivých metodách.

Poznámky pro dědice

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

Konstruktory

ConnectionsZone()

Inicializuje novou instanci ConnectionsZone třídy.

Vlastnosti

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í aplikace relativní virtuální adresář nebo UserControl objektuPage, 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í pro zónu.

(Zděděno od WebZone)
BindingContainer

Získá ovládací prvek, který obsahuje datové vazby 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í znak oddělovače 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 uživatelské rozhraní připojení (UI) vytvořené ovládacím ConnectionsZone prvku.

ConfigureConnectionTitle

Získá nebo nastaví text zobrazený jako název pododdílu uživatelského rozhraní (UI) připojení vytvořené ovládacím prvku ConnectionsZone .

ConfigureVerb

Získá odkaz na WebPartVerb objekt použitý k otevření zobrazení konfigurace v uživatelském rozhraní (UI) připojení.

ConnectToConsumerInstructionText

Získá nebo nastaví instruktáž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 zprostředkovatel připojí.

ConnectToConsumerText

Získá nebo nastaví text hypertextového odkazu, na který uživatelé kliknou k otevření zobrazení, ve kterém mohou zvolit ovládací prvek příjemce pro připojení.

ConnectToConsumerTitle

Získá nebo nastaví text názvu oddílu v uživatelském rozhraní připojení (UI), ve kterém uživatelé mohou vybrat konkrétního uživatele, se kterým se mají připojit.

ConnectToProviderInstructionText

Získá nebo nastaví instruktážní text zobrazený v části uživatelského rozhraní připojení (UI), kde uživatelé vyberou spojovací bod poskytovatele, ke kterému se příjemce připojí.

ConnectToProviderText

Získá nebo nastaví text hypertextového odkazu, na který uživatelé kliknou k otevření zobrazení, ve kterém mohou zvolit ovládací prvek zprostředkovatele pro připojení.

ConnectToProviderTitle

Získá nebo nastaví text názvu oddílu v uživatelském rozhraní připojení (UI), ve kterém uživatelé mohou vybrat konkrétního poskytovatele pro připojení.

ConnectVerb

Získá odkaz na WebPartVerb objekt, který umožňuje dva WebPart ovládací prvky vytvořit připojení.

ConsumersInstructionText

Získá nebo nastaví instruktáž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říjemci v uživatelském rozhraní (UI) připojení, pokud připojení již existuje.

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í především vývojáři ovládacích prvků.

(Zděděno od WebControl)
ControlStyleCreated

Získá hodnotu označ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í css (CSS) třídy vykreslované webový server ovládací prvek v klientovi.

(Zděděno od WebControl)
DataItemContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer.

(Zděděno od Control)
DataKeysContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl.

(Zděděno od Control)
DesignMode

Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše.

(Zděděno od Control)
DisconnectVerb

Získá odkaz na WebPartVerb objekt, který umožňuje uživateli odpojit dva připojené WebPart ovládací prvky.

Display

Získá hodnotu, která označuje, zda ToolZone je aktuálně zobrazen ovládací prvek.

EditUIStyle

Získá atributy stylu pro upravitelné ovládací prvky obsažené v ovládacím prvku ToolZone .

(Zděděno od ToolZone)
EmptyZoneText

Získá nebo nastaví textovou zprávu, která se zobrazí v prázdném ConnectionsZone ovládacím prvku, pokud není k dispozici dostatek ovládacích prvků 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 označující, zda je povolený ovládací prvek webového serveru.

(Zděděno od WebControl)
EnableTheming

Získá nebo nastaví hodnotu označující, zda motivy použít 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, pro žádajícího klienta.

(Zděděno od Control)
ErrorStyle

Získá atributy stylu pro vykreslení chybové zprávy, která se zobrazí, pokud WebPart nelze načíst nebo vytvořit ovládací prvek.

(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 dojde k chybě nebo upozornění na existující připojení.

Font

Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru.

(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 připojení uživatelského rozhraní (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 připojení uživatelské rozhraní (UI), který předchází pojmenovaného příjemce, který bude přijímat data od zprostředkovatele.

HasAttributes

Získá hodnotu označující, zda ovládací prvek má nastaveny atributy.

(Zděděno od WebControl)
HasChildViewState

Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení.

(Zděděno od Control)
HasFooter

Získá hodnotu označující, zda má zóna oblast zápatí.

(Zděděno od WebZone)
HasHeader

Získá hodnotu označující, zda má zóna oblast záhlaví.

(Zděděno od WebZone)
HeaderCloseVerb

Získá odkaz na WebPartVerb objekt v záhlaví ToolZone ovládacího prvku, který se používá 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í (UI) vytvořené ovládacím ConnectionsZone prvku.

HeaderVerbStyle

Získá atributy stylu pro všechny příkazy záhlaví zobrazené v ovládacím prvku ToolZone .

(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ý k 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 nastavte text, který se používá pro obecné pokyny o vybraném ovládacím prvku v části uživatelského rozhraní připojení (UI) pro správu existujících připojení.

InstructionTextStyle

Získá atributy stylu pro text instrukce, který se zobrazí v horní části ovládacího prvku ToolZone .

(Zděděno od ToolZone)
InstructionTitle

Získá nebo nastaví text, který se používá pro obecný popis akce, která může být provedena v ovládacím prvku příjemce nebo zprostředkovatele v rámci uživatelského rozhraní připojení (UI) pro správu existujících připojení.

IsChildControlStateCleared

Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení.

(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 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 rámci ovládacího prvku ToolZone . Odvozené ToolZone ovládací prvky, například CatalogZone a EditorZone, aplikují styly na popisky.

(Zděděno od ToolZone)
LoadViewStateByID

Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu.

(Zděděno od Control)
NamingContainer

Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl 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í (UI) připojení při výskytu chyby nebo upozornění na nové připojení, které se uživatel pokusí vytvořit.

NoExistingConnectionInstructionText

Získá nebo nastaví text instrukce, který se zobrazí v těle připojení uživatelské rozhraní (UI), když webové části ovládací prvek nemá žádné existující připojení.

NoExistingConnectionTitle

Získá nebo nastaví text nadpisu, který se zobrazí v textu připojení uživatelské rozhraní (UI), když webové části ovládací prvek 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 serverový ovládací prvek nadřazený ovládací prvek 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é platí pro ohraničení webových částí ovládacích prvků 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 prvku ConnectionsZone .

PartStyle

Získá vlastnosti stylu, které platí pro ohraničení a obsah každé webové části ovládacího prvku obsaženého v zóně.

(Zděděno od WebZone)
PartTitleStyle

Získá atributy stylu pro záhlaví obsahu pro každý webových částí ovládací prvek obsažený v zóně.

(Zděděno od WebZone)
ProvidersInstructionText

Získá nebo nastaví instrukční text zobrazený v sekci zprostředkovatelů uživatelského rozhraní (UI) připojení, pokud připojení již existuje.

ProvidersTitle

Získá nebo nastaví název uvedený nad oddílem zprostředkovatelů uživatelského rozhraní (UI) připojení, pokud připojení již existuje.

RenderClientScript

Získá hodnotu, která označuje, zda vykreslit klientský skript na stránce webových částí.

(Zděděno od WebZone)
RenderingCompatibility

Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s.

(Zděděno od Control)
SendText

Získá nebo nastaví text zobrazený v části připojení uživatelského rozhraní (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í (UI) připojení, který předchází pojmenovaného příjemce, do kterého bude zprostředkovatel odesílat data.

Site

Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše.

(Zděděno od Control)
SkinID

Získá nebo nastaví kůži na ovládací prvek.

(Zděděno od WebControl)
Style

Získá kolekci text atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku.

(Zděděno od WebControl)
SupportsDisabledAttribute

Získá hodnotu, která označuje, zda má ovládací prvek nastavit disabled atribut vykresleného html elementu na "zakázáno", pokud je falsevlastnost ovládacího prvku IsEnabled je .

(Zděděno od CompositeControl)
TabIndex

Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru.

(Zděděno od WebControl)
TagKey

HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají především 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í především 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 ovládací prvek.

(Zděděno od Control)
ToolTip

Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru.

(Zděděno od WebControl)
UniqueID

Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku.

(Zděděno od Control)
ValidateRequestMode

Získá nebo nastaví hodnotu, která označ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 uživatelské rozhraní (UI) sloves přidružených k ovládacím prvkům 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í serverového ovládacího prvku napříč několika požadavky na stejnou stránku.

(Zděděno od Control)
ViewStateIgnoresCase

Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje velká a malá písmena.

(Zděděno od Control)
ViewStateMode

Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku.

(Zděděno od Control)
Visible

Získá nebo nastaví hodnotu, která označuje, zda serverový ovládací prvek je vykreslen jako uživatelské rozhraní (UI) prvek 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, ke kterému se chcete připojit.

Width

Získá nebo nastaví šířku ovládacího prvku webového serveru.

(Zděděno od WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Přidá atributy a styly HTML, které je potřeba vykreslit na zadaný HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků.

(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í ovládací prvek serveru, že byl analyzován prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection 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)

Zahájí trasování vykreslování dat v době návrhu.

(Zděděno od Control)
BuildProfileTree(String, Boolean)

Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování.

(Zděděno od Control)
ClearCachedClientID()

Nastaví hodnotu v ClientID mezipaměti na null.

(Zděděno od Control)
ClearChildControlState()

Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildState()

Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildViewState()

Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků 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í (UI) 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 volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků.

(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, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku.

(Zděděno od Control)
CreateControlStyle()

Vytvoří objekt stylu, který se interně používá třídy k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
DataBind()

Sváže zdroj dat se CompositeControl všemi jeho podřízenými ovládacími prvky.

(Zděděno od CompositeControl)
DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvoláný 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()

Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku.

(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í vykreslovaných dat v době návrhu.

(Zděděno od Control)
EnsureChildControls()

Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky.

(Zděděno od Control)
EnsureID()

Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor.

(Zděděno od Control)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FindControl(String)

Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného id parametru.

(Zděděno od Control)
FindControl(String, Int32)

Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným id a celočíselným číslem zadaným v parametru pathOffset , který pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat.

(Zděděno od Control)
Focus()

Nastaví fokus vstupu 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 nebo platnou WebPart aktuální PartChromeType hodnotu ovládacího prvku vzhledem k PartChromeType vlastnosti zóny a aktuálnímu režimu zobrazení stránky webových částí.

(Zděděno od WebZone)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(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ázev trasy.

(Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)

Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.

(Zděděno od Control)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
GetUniqueIDRelativeTo(Control)

Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku.

(Zděděno od Control)
HasControls()

Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky.

(Zděděno od Control)
HasEvents()

Vrátí hodnotu označ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, jestli serverový ovládací prvek obsahuje pouze obsah literálu.

(Zděděno od Control)
LoadControlState(Object)

Obnoví informace o stavu ovládacího prvku z předchozí žádosti o 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 Objectsouboru .

(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í především vývojáři ovládacích prvků.

(Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)

Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru 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á zvyk 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ímu prvku.

(Zděděno od Control)
RaisePostBackEvent(String)

Vyvolá událost pro ovládací prvek, ConnectionsZone když formulář, který ho obsahuje, odešle 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 určenému HtmlTextWriter objektu, který zapíše obsah na webovou stránku.

RenderChildren(HtmlTextWriter)

Vypíše obsah podřízených položek serverového ovládacího prvku 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 na zadaný HtmlTextWriter objekt.

(Zděděno od WebZone)
RenderControl(HtmlTextWriter)

Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené.

(Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.

(Zděděno od Control)
RenderEndTag(HtmlTextWriter)

Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
RenderFooter(HtmlTextWriter)

Přepíše základní metodu 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 ToolZone pomocí ovládacího prvku.

(Zděděno od ToolZone)
RenderVerbs(HtmlTextWriter)

Vykreslí příkazy na úrovni zóny pro ovládací prvek ConnectionsZone .

ResolveAdapter()

Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku.

(Zděděno od Control)
ResolveClientUrl(String)

Získá adresu URL, kterou lze použít v prohlížeči.

(Zděděno od Control)
ResolveUrl(String)

Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi.

(Zděděno od Control)
SaveControlState()

Uloží všechny změny stavu ovládacího prvku webových částí, ke kterým došlo od posledního publikování stránky zpět na server.

SaveViewState()

Uloží ConnectionsZone 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 v době návrhu ovládacího prvku.

(Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)

Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku.

(Zděděno od Control)
SetTraceData(Object, Object)

Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování.

(Zděděno od Control)
SetTraceData(Object, Object, Object)

Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, 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 je bylo možné uložit do objektu StateBag ovládacího prvku.

Událost

DataBinding

Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat.

(Zděděno od Control)
Disposed

Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET.

(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 při načtení serverového ovládacího prvku 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 při uvolnění serverového ovládacího prvku z paměti.

(Zděděno od Control)

Explicitní implementace rozhraní

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 najdete v tématu ControlBuilder.

(Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()

Popis tohoto člena najdete v tématu GetDesignModeState().

(Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary).

(Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Popis tohoto člena najdete v tématu SetOwnerControl(Control).

(Zděděno od Control)
IControlDesignerAccessor.UserData

Popis tohoto člena najdete v tématu UserData.

(Zděděno od Control)
IDataBindingsAccessor.DataBindings

Popis tohoto člena najdete v tématu DataBindings.

(Zděděno od Control)
IDataBindingsAccessor.HasDataBindings

Popis tohoto člena najdete v tématu HasDataBindings.

(Zděděno od Control)
IExpressionsAccessor.Expressions

Popis tohoto člena najdete v tématu Expressions.

(Zděděno od Control)
IExpressionsAccessor.HasExpressions

Popis tohoto člena najdete v tématu HasExpressions.

(Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)

Popis tohoto člena najdete 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í

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 názvů 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ý datový ovládací prvek.

GetMetaTable(INamingContainer)

Získá metadata tabulky pro zadaný datový ovládací prvek.

SetMetaTable(INamingContainer, MetaTable)

Nastaví metadata tabulky pro zadaný ovládací prvek dat.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat.

SetMetaTable(INamingContainer, MetaTable, Object)

Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat.

TryGetMetaTable(INamingContainer, MetaTable)

Určuje, jestli jsou k dispozici metadata tabulky.

EnableDynamicData(INamingContainer, Type)

Povolí chování dynamických dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Povolí chování dynamických dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, Object)

Povolí chování dynamických dat pro zadaný datový ovládací prvek.

Platí pro

Viz také