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.Provides a user interface (UI) that enables users to form connections between WebPart and other server controls that reside in WebPartZoneBase zones.

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é části.The following code example demonstrates how to use the ConnectionsZone control on a Web Parts page. Příklad obsahuje čtyři části:The example has four parts:

  • Uživatelský ovládací prvek, který umožňuje přepnout režimy zobrazení na webové stránce.A user control that enables you to switch display modes on the Web page.

  • Zdrojový soubor, který obsahuje kód pro rozhraní PSČ, a dva WebPart ovládací prvky fungující jako poskytovatel a příjemce pro připojení.A source file that contains the code for a ZIP Code interface, and two WebPart controls acting as the provider and the consumer for a connection.

  • Webová stránka, která je hostitelem všech ovládacích prvků, ukazuje, jak deklarovat <asp:connectionszone> element a nastavit řadu vlastností v zóně připojení deklarativně a programově.A Web page that hosts all the controls, demonstrates how to declare an <asp:connectionszone> element, and sets a number of properties on the connections zone declaratively and programmatically.

  • Vysvětlení, jak příklad funguje v prohlížeči.An explanation of how the example works in a browser.

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje uživatelům přepnout režimy zobrazení na webové stránce.The first part of this code example is the user control that enables users to switch display modes on a Web page. Podrobnosti o režimech zobrazení a popis zdrojového kódu v tomto ovládacím prvku naleznete v tématu Návod: Změna režimů zobrazení na stránce webové části.For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ 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="&nbsp;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="&nbsp;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>

Druhá část příkladu je zdrojový soubor s rozhraním a vlastními ovládacími prvky.The second part of the example is the source file with the interface and custom controls. Všimněte si, že ZipCodeWebPart ovládací prvek implementuje IZipCode rozhraní a přidává ConnectionProvider atribut tak, aby ovládací prvek mohl fungovat jako poskytovatel pro připojení.Notice that the ZipCodeWebPart control implements the IZipCode interface, adding a ConnectionProvider attribute so that the control can act as a provider for a connection. WeatherWebPartOvládací prvek má metodu označenou ConnectionConsumer atributem, kde spotřebovává IZipCode rozhraní, aby mohl fungovat jako příjemce v připojení.The WeatherWebPart control has a method marked with a ConnectionConsumer attribute, where it consumes the IZipCode interface, so it can act as a consumer in a connection.

Chcete-li spustit příklad kódu, je nutné tento zdrojový kód zkompilovat.For the code example to run, you must compile this source code. Můžete jej zkompilovat explicitně a výsledné sestavení umístit do složky Bin vašeho webu nebo do globální mezipaměti sestavení (GAC).You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Případně můžete zdrojový kód vložit do složky App_Code webu, kde bude dynamicky zkompilován za běhu.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. Tento příklad používá dynamickou kompilaci.This example uses dynamic compilation. Návod, který ukazuje, jak zkompilovat, naleznete v tématu Návod: vývoj a používání vlastního ovládacího prvku webového serveru.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

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í příkladu kódu je webová stránka.The third part of the example code is the Web page. Poblíž horního okraje jsou Register direktivy pro uživatelský ovládací prvek a vlastní ovládací prvky používané v připojení.Near the top are Register directives for the user control and the custom controls used in the connection. <asp:connectionszone>Element je deklarován na stránce jako příklad ConnectionsZone deklarativního použití ovládacího prvku.An <asp:connectionszone> element is declared in the page as an example of using the ConnectionsZone control declaratively. V rámci elementu je řada vlastností nastavena deklarativně.Within the element, a number of properties are set declaratively. Další vlastnosti v zóně připojení se nastavují programově v <script> části stránky.Other properties on the connections zone are set programmatically in the <script> section of the page.

<%@ 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.Load the Web page in a browser. Chcete-li přepnout stránku do režimu připojení, použijte ovládací prvek rozevírací seznam režim zobrazení .Use the Display Mode drop-down list control to switch the page to connect mode. V nabídce příkazů v ovládacím prvku poskytovatel PSČ (nabídka příkazů je označena šipkou dolů v záhlaví ovládacího prvku) klikněte na příkaz připojit.On the verbs menu of the ZIP Code Provider control (the verbs menu is indicated by the downward arrow in the control's title bar), click the connect verb. ConnectionsZoneZobrazí se ovládací prvek.A ConnectionsZone control appears. Všimněte si, že se v uživatelském rozhraní připojení zobrazuje tlačítko ukončit připojení ; připojení již bylo deklarováno v označení stránky, takže ovládací prvky jsou již připojeny.Note that in the connection UI, an End Connection button appears; the connection has already been declared in the markup of the page, so the controls are already connected. Klikněte na ukončit připojení a pak znovu použijte ovládací prvek režim zobrazení a vraťte stránku do režimu procházení.Click End Connection, and then use the Display Mode control again to return the page to browse mode. Potom znovu vraťte stránku do režimu připojení, klikněte na příkaz připojit na jednom z ovládacích prvků a Všimněte si, že uživatelské rozhraní připojení nyní zobrazuje hypertextový odkaz, který umožňuje vytvořit propojení mezi ovládacími prvky.Next, return the page to connect mode again, click the connect verb on one of the controls, and note that the connection UI now displays a hyperlink that enables you to form a connection between the controls. Klikněte na odkaz a použijte uživatelské rozhraní pro připojení k výběru bodů připojení a navázání připojení.Click the link, and use the connection UI to select connection points and establish the connection.

Poznámky

Pomocí sady ovládacích prvků Webové části můžete povolit dva serverové ovládací prvky pro vytvoření připojení a sdílení dat, přičemž jeden ovládací prvek funguje jako poskytovatel a druhý působí jako spotřebitel dat.Using the Web Parts control set, you can enable two server controls to form a connection and share data, with one control acting as the provider, and the other acting as the consumer of the data. 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 určeny pro zpracování připojení a že jsou umístěny v WebPartZoneBase zóně.The two controls can be WebPart controls or any other type of server control, provided that they are designed to handle connections, and that they are residing in a WebPartZoneBase zone. Další informace o Webové částich připojeních najdete v WebPartConnection tématu ConnectionPoint přehledy tříd a a webové části připojení.To learn more about Web Parts connections, see the WebPartConnection and ConnectionPoint class overviews, as well as Web Parts Connections Overview.

Za předpokladu, že požadované ovládací prvky a podmínky existují pro vytvoření Webové částiho připojení, je stále nutné tyto ovládací prvky skutečně propojit.Provided that the requisite controls and conditions exist to form a Web Parts connection, it is still necessary to actually connect the controls. Existují tři způsoby, jak vytvořit propojení 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í.There are three ways to form a connection between server controls: declaring a connection in a Web page, creating a connection in code, or adding a ConnectionsZone control to the page so that users can connect the controls on demand. ConnectionsZoneOvládací prvek generuje uživatelské rozhraní, které umožňuje uživatelům připojit nebo odpojit libovolné serverové ovládací prvky na stránce, která splňuje podmínky nutné k vytvoření připojení.The ConnectionsZone control generates a UI that enables users to connect or disconnect any server controls on a page that meet the conditions necessary to form a connection. Je to volitelný ovládací prvek, který není potřeba k vytvoření připojení, ale je užitečný v případě, že chcete uživatelům umožnit kontrolu nad tím, které serverové ovládací prvky jsou připojené nebo odpojené.It is an optional control that is not necessary to form connections, but is useful in the case where you want to give users control over which server controls are connected or disconnected.

ConnectionsZoneOvládací prvek je jedním z ovládacích prvků zóny webové části nástrojů, které dědí ze ToolZone základní třídy.The ConnectionsZone control is one of the Web Parts tool zone controls that inherit from the ToolZone base class. Jako zóna nástroje ConnectionsZone je ovládací prvek navržený tak, aby byl viditelný pouze v případě, že je jeho webová stránka v určitém režimu zobrazení.As a tool zone, the ConnectionsZone control is designed to be visible only when its Web page is in a certain display mode. V tomto případě se režim zobrazení nazývá režim připojení (stránka je v tomto režimu, pokud WebPartManager má ovládací prvek na stránce DisplayMode nastavenou hodnotu vlastnosti ConnectDisplayMode ).In this case, the display mode is named connect mode (a page is in this mode when the WebPartManager control on the page has its DisplayMode property value set to ConnectDisplayMode). Když uživatelé přepnou stránku do režimu připojení, musí kliknout na příkaz připojit v nabídce příkazy jednoho z ovládacích prvků serveru a pak se uživatelské rozhraní pro připojení zobrazí jako viditelné.After users switch a page into connect mode, they must click a connect verb on the verbs menu of one of the server controls, and then the connection UI becomes visible.

Jako ovládací prvek zóny Webové části ConnectionsZone je ovládací prvek typem WebZone zóny (která dědí z CompositeControl třídy) navrženou tak, aby obsahovala jiné ovládací prvky.As a Web Parts zone control, the ConnectionsZone control is a type of WebZone zone (which inherits from the CompositeControl class) designed to contain other controls. Obecně platí, že ConnectionsZone zóna má většinu stejných prvků jako jiné zóny nástroje webové části: záhlaví, tělo nebo oblast obsahu a zápatí.In general, a ConnectionsZone zone has most of the same elements as other Web Parts tool zones: a header, a body or contents area, and a footer. Kompletní informace o tom, co je zóna Webové části, a o různých částech zóny najdete v WebZone přehledu třídy.For a complete discussion of what a Web Parts zone is, and the different parts of a zone, see the WebZone class overview.

Důležité

Na rozdíl od většiny ostatních Webové části zón je důležité si uvědomit, že ConnectionsZone zóna neobsahuje jedinečný typ serverového ovládacího prvku, který je k němu přidružený.Unlike most other Web Parts zones, it is important to note that a ConnectionsZone zone does not contain a unique type of server control associated with it. Seznam zón a přidružených ovládacích prvků, které obsahují, naleznete v grafu v WebZone přehledu třídy.For a list of zones and the associated controls they contain, see the chart in the WebZone class overview. Ale ConnectionsZone zóna neobsahuje WebPartConnection ovládací prvky.But the ConnectionsZone zone does not contain WebPartConnection controls. Místo toho slouží k zajištění velmi omezeného účelu pro uživatele, aby mohli připojit nebo odpojit serverové ovládací prvky, které existují v některé WebPartZoneBase zóně na stránce.Instead, it serves a very limited purpose of providing a UI for users to connect or disconnect server controls that exist in some WebPartZoneBase zone on the page. Jedinými ovládacími prvky obsaženými v ConnectionsZone ovládacím prvku jsou standardní serverové ovládací prvky ASP.NET, které generuje jako součást svého uživatelského rozhraní pro vytváření připojení.The only controls contained in a ConnectionsZone control are the standard ASP.NET server controls that it generates as part of its UI for forming connections.

Když ConnectionsZone je ovládací prvek vykreslen, vygeneruje uživatelské rozhraní na základě serverových ovládacích prvků na stránce, které jsou schopny vytvořit připojení.When the ConnectionsZone control is rendered, it generates a UI based on the server controls on the page that are capable of forming connections. ConnectionsZoneOvládací prvek určuje, které serverové ovládací prvky v WebPartZoneBase zóně na stránce jsou poskytovatelé, kteří jsou příjemci, kteří jsou k dispozici spojovací body 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.The ConnectionsZone control determines which server controls in the WebPartZoneBase zone on the page are providers, which are consumers, which connection points are available, and whether the server controls are currently connected or disconnected, and then it generates the UI accordingly.

Předpokládejme například, že je jeden WebPart ovládací prvek schopný být poskytovatelem, jeden WebPart ovládací prvek schopný být příjemcem, jsou deklarovány v a WebPartZone na stránce a jsou aktuálně odpojeny.For example, suppose there is one WebPart control capable of being a provider, one WebPart control capable of being a consumer, they are declared in a WebPartZone on the page, and they are currently disconnected. 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 vygeneruje ovládací prvek uživatelské rozhraní s odkazem, který po kliknutí zobrazí formulář, ve kterém mohou uživatelé zvolit možnosti pro vytvoření připojení.When a user switches the page to connect mode and clicks the connect verb on one of the controls, the ConnectionsZone control generates a UI with a link that, when clicked, displays a form in which users can choose options to create a connection. (Pokud byly ovládací prvky dříve připojeny, počáteční zobrazení místo toho zobrazí uživatelům tlačítko pro odpojení ovládacích prvků).(If the controls were previously connected, the initial view instead presents users with a button to disconnect the controls). V uživatelském rozhraní připojení pro vytváření nových připojení se uživatelům zobrazí, který ovládací prvek je poskytovatelem a který ovládací prvek je příjemcem.In the connection UI for creating new connections, users are shown which control is a provider, and which control is a consumer. Pod každým ovládacím prvkem serveru se zobrazí ovládací prvek rozevírací seznam, který obsahuje seznam dostupných ConnectionPoint objektů pro ovládací prvek.A drop-down list control appears below each server control, listing the available ConnectionPoint objects for the control. V příslušných rozevíracích seznamech musí uživatelé vybrat jeden ProviderConnectionPoint objekt pro poskytovatele (abyste zjistili, jaké rozhraní a data budou sdílena s uživateli), a jeden ConsumerConnectionPoint objekt pro každého příjemce (k určení, jaké rozhraní a data bude příjemce využívat), které budou připojené k poskytovateli.From the respective drop-down lists, users must select one ProviderConnectionPoint object for the provider (to determine what interface and data will be shared with consumers), and one ConsumerConnectionPoint object for each consumer (to determine what interface and data the consumer will consume) that will be connected to the provider.

Poznámka

V ovládacím prvku Webové části nastavit výchozí implementaci se může jeden zprostředkovatel připojit k mnoha příjemcům, ale příjemce může mít pouze jednoho poskytovatele.In the Web Parts control set default implementation, one provider can connect to many consumers, but a consumer can have only one provider.

Chcete-li použít ConnectionsZone ovládací prvek, můžete ho deklarovat v rámci <form> elementu na webové stránce (ale ne vnořen v jiném elementu webové části zóny), pomocí <asp:connectionszone> elementu nebo ho můžete přidat na stránku programově.To use the ConnectionsZone control, you can declare it within the <form> element on a Web page (but not nested within another Web Parts zone element), using the <asp:connectionszone> element, or you can add it to the page programmatically. Pokud deklarujete element na stránce, na rozdíl od jiných zón Webové části, nelze deklarovat žádný jiný typ serverových ovládacích prvků mezi značkami <asp:connectionszone> elementu.If you declare the element in a page, unlike the other Web Parts zones, you cannot declare any other type of server controls between the tags of the <asp:connectionszone> element. Můžete deklarovat prvky, které se vztahují k jeho vlastním vlastnostem a podrobnostem o stylu, ale jedná se o samostatný prvek a nejedná se o ovládací prvek šablony, ve kterém lze deklarovat jiné serverové ovládací prvky.You can declare elements within it that relate to its own properties and style details, but it is a standalone element and is not a template control within which other server controls can be declared.

Poznámka

Pro zlepšení usnadnění ConnectionsZone je ovládací prvek vykreslen v rámci <fieldset> elementu.To improve accessibility, the ConnectionsZone control is rendered within a <fieldset> element. <fieldset>Element seskupí související sadu ovládacích prvků, které se používají pro vytváření připojení v ConnectionsZone ovládacím prvku, a usnadňuje navigaci mezi těmito ovládacími prvky pro vizuální uživatelské agenty (například běžné webové prohlížeče) a uživatelské agenty orientované na řeč (například software pro čtení obrazovky).The <fieldset> element groups the related set of controls used for establishing connections in the ConnectionsZone control, and it facilitates tabbed navigation among those controls for both visual user agents (such as ordinary Web browsers) and speech-oriented user agents (such as screen-reading software).

ConnectionsZoneOvládací prvek má několik vlastností, které používá pro vykreslování uživatelského rozhraní připojení.The ConnectionsZone control has a number of properties it uses for rendering the connection UI. Jedna sada vlastností obsahuje několik příkazů – používá se jenom ve vztahu k připojením – provádí akce v uživatelském rozhraní: ConfigureVerb , ConnectVerb a DisconnectVerb .One set of properties includes several verbs--used only in relation to connections--that carry out actions in the UI: ConfigureVerb, ConnectVerb, and DisconnectVerb. Velká sada vlastností, která se používá hlavně 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 ConnectToConsumerText ConnectToConsumerTitle ConnectToProviderInstructionText ConnectToProviderText ConnectToProviderTitle ConsumersInstructionText ConsumersTitle ExistingConnectionErrorMessage GetFromText GetText InstructionTitle , NewConnectionErrorMessage , NoExistingConnectionInstructionText , NoExistingConnectionTitle , ProvidersInstructionText , ProvidersTitle , a SendText SendToText .A large set of properties, used especially for the connections zone UI, consists of text strings displayed at various places (or in certain situations, such as when errors occur) in the UI: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToConsumerText, ConnectToConsumerTitle, ConnectToProviderInstructionText, ConnectToProviderText, ConnectToProviderTitle, ConsumersInstructionText, ConsumersTitle, ExistingConnectionErrorMessage, GetFromText, GetText, InstructionTitle, NewConnectionErrorMessage, NoExistingConnectionInstructionText, NoExistingConnectionTitle, ProvidersInstructionText, ProvidersTitle, SendText, and SendToText. ConnectionsZoneTřída také obsahuje řadu společných vlastností, které se nacházejí v jiných zónách webové části: CancelVerb , CloseVerb , Display , EmptyZoneText , HeaderText , InstructionText a PartChromeType .The ConnectionsZone class also contains a number of common properties found in other Web Parts zones: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, InstructionText, and PartChromeType. Nakonec WebPartToConnect je vlastnost jedinečná pro třídu, odkazování na ovládací prvek, který iniciuje připojení (Toto je ovládací prvek, na kterém uživatel klikne na příkaz připojit v nabídce jeho příkazů, což je také ovládací prvek odkazovaný ve WebPartManager vlastnosti ovládacího prvku SelectedWebPart ).Finally, the WebPartToConnect property is unique to the class, referencing the control that initiates the connection (this is the control on which the user clicks the connect verb in its verbs menu, which is also the control referenced in the WebPartManager control's SelectedWebPart property).

ConnectionsZoneTřída má také celou řadu metod, které 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 webové částich zón.The ConnectionsZone class also has a number of methods, all of which are inherited and overridden from base classes, and most of them come from the base Web Parts zone classes. Podrobnosti najdete v jednotlivých metodách.For details, see the individual methods.

Poznámky pro dědice

ConnectionsZoneTřídu 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.The ConnectionsZone class can be extended, if developers want to change its behavior or the default UI that it provides for working with connections.

Konstruktory

ConnectionsZone()

Inicializuje novou instanci ConnectionsZone třídy.Initializes a new instance of the ConnectionsZone class.

Vlastnosti

AccessKey

Získá nebo nastaví přístupový klíč, který vám umožní rychle přejít k ovládacímu prvku webového serveru.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Zděděno od WebControl)
Adapter

Načte pro ovládací prvek adaptér pro konkrétního prohlížeče.Gets the browser-specific adapter for the control.

(Zděděno od Control)
AppRelativeTemplateSourceDirectory

Získá nebo nastaví virtuální adresář nebo objekt relativní vzhledem k aplikaci Page UserControl , který obsahuje tento ovládací prvek.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Zděděno od Control)
AssociatedDisplayModes

Získá kolekci WebPartDisplayMode objektů, které jsou přidruženy ke konkrétní ToolZone zóně.Gets the collection of WebPartDisplayMode objects that are associated with a particular ToolZone zone.

(Zděděno od ToolZone)
Attributes

Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Zděděno od WebControl)
BackColor

Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru.Gets or sets the background color of the Web server control.

(Zděděno od WebControl)
BackImageUrl

Získá nebo nastaví adresu URL obrázku pozadí pro zónu.Gets or sets the URL to a background image for a zone.

(Zděděno od WebZone)
BindingContainer

Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku.Gets the control that contains this control's data binding.

(Zděděno od Control)
BorderColor

Získá nebo nastaví barvu ohraničení webového ovládacího prvku.Gets or sets the border color of the Web control.

(Zděděno od WebControl)
BorderStyle

Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru.Gets or sets the border style of the Web server control.

(Zděděno od WebControl)
BorderWidth

Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru.Gets or sets the border width of the Web server control.

(Zděděno od WebControl)
CancelVerb

Získá odkaz na WebPartVerb objekt, který koncovým uživatelům umožňuje zrušit proces navázání připojení.Gets a reference to a WebPartVerb object that enables end users to cancel the process of establishing a connection.

ChildControlsCreated

Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku.Gets a value that indicates whether the server control's child controls have been created.

(Zděděno od Control)
ClientID

Získá ID ovládacího prvku pro kód HTML, který je generován pomocí ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Zděděno od Control)
ClientIDMode

Získá nebo nastaví algoritmus, který se použije k vygenerování hodnoty ClientID Vlastnosti.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Zděděno od Control)
ClientIDSeparator

Získá hodnotu znaku představující znak oddělovače použitý ve ClientID Vlastnosti.Gets a character value representing the separator character used in the ClientID property.

(Zděděno od Control)
CloseVerb

Získá odkaz na WebPartVerb objekt, který koncovým uživatelům umožňuje zavřít uživatelské rozhraní (UI) připojení vytvořené ConnectionsZone ovládacím prvkem.Gets a reference to a WebPartVerb object that enables end users to close the connection user interface (UI) created by the ConnectionsZone control.

ConfigureConnectionTitle

Získá nebo nastaví text, který se zobrazuje jako název pododdílu uživatelského rozhraní (UI) připojení vytvořeného ConnectionsZone ovládacím prvkem.Gets or sets the text displayed as the title of a subsection of the connection user interface (UI) created by a ConnectionsZone control.

ConfigureVerb

Načte odkaz na objekt, WebPartVerb který slouží k otevření zobrazení konfigurace v uživatelském rozhraní (UI) připojení.Gets a reference to a WebPartVerb object used to open the configuration view in the connection user interface (UI).

ConnectToConsumerInstructionText

Získá nebo nastaví instruktážní text zobrazený v části uživatelského rozhraní připojení (UI), kde uživatelé vyberou přípojný bod spotřebitele, ke kterému se poskytovatel připojí.Gets or sets the instructional text displayed in the section of the connection user interface (UI) where users select a consumer connection point that the provider will connect to.

ConnectToConsumerText

Získá nebo nastaví text hypertextového odkazu, který uživatel klikne k otevření zobrazení, ve kterém může zvolit ovládací prvek příjemce pro připojení.Gets or sets the text of a hyperlink that users click to open a view in which they can choose a consumer control for a connection.

ConnectToConsumerTitle

Získá nebo nastaví text nadpisu oddílu v uživatelském rozhraní (UI) připojení, ve kterém můžou uživatelé vybrat konkrétního příjemce pro připojení.Gets or sets the title text of the section in the connection user interface (UI) in which users can select a specific consumer to connect with.

ConnectToProviderInstructionText

Získá nebo nastaví instruktáž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í.Gets or sets the instructional text displayed in the section of the connection user interface (UI) where users select a provider connection point that the consumer will connect to.

ConnectToProviderText

Získá nebo nastaví text hypertextového odkazu, který uživatel klikne k otevření zobrazení, ve kterém si můžou vybrat ovládací prvek poskytovatele pro připojení.Gets or sets the text of a hyperlink that users click to open a view in which they can choose a provider control for a connection.

ConnectToProviderTitle

Získá nebo nastaví text nadpisu oddílu v uživatelském rozhraní (UI) připojení, ve kterém můžou uživatelé vybrat konkrétního poskytovatele pro připojení.Gets or sets the title text of the section in the connection user interface (UI) in which users can select a specific provider to connect with.

ConnectVerb

Získá odkaz na WebPartVerb objekt, který umožňuje WebPart vytvořit připojení dvěma ovládacími prvky.Gets a reference to a WebPartVerb object that enables two WebPart controls to establish a connection.

ConsumersInstructionText

Získá nebo nastaví instruktážní text zobrazený v části příjemci uživatelského rozhraní připojení (UI), kdy připojení již existuje.Gets or sets the instructional text shown in the consumers section of the connection user interface (UI), when a connection already exists.

ConsumersTitle

Získá nebo nastaví název zobrazený výše v uživatelském rozhraní (UI) pro připojení, pokud již existuje připojení.Gets or sets the title shown above the consumers section of the connection user interface (UI), when a connection already exists.

Context

Získá HttpContext objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek.Gets the HttpContext object associated with the server control for the current Web request.

(Zděděno od Control)
Controls

Získá ControlCollection objekt, který představuje podřízené ovládací prvky v CompositeControl .Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Zděděno od CompositeControl)
ControlStyle

Získá styl ovládacího prvku webového serveru.Gets the style of the Web server control. Tato vlastnost se používá hlavně při řízení vývojářů.This property is used primarily by control developers.

(Zděděno od WebControl)
ControlStyleCreated

Vrací hodnotu určující, zda byl Style objekt pro ControlStyle vlastnost vytvořen.Gets a value indicating whether a Style object has been created for the ControlStyle property. Tato vlastnost je primárně používána vývojáři ovládacího prvku.This property is primarily used by control developers.

(Zděděno od WebControl)
CssClass

Získá nebo nastaví třídu CSS (Cascading Style Sheet) vykreslenou ovládacím prvkem webového serveru na klientovi.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Zděděno od WebControl)
DataItemContainer

Získá odkaz na názvový kontejner, pokud implementuje názvový kontejner IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Zděděno od Control)
DataKeysContainer

Získá odkaz na názvový kontejner, pokud implementuje názvový kontejner IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Zděděno od Control)
DesignMode

Načte hodnotu, která označuje, zda je ovládací prvek používán na návrhové ploše.Gets a value indicating whether a control is being used on a design surface.

(Zděděno od Control)
DisconnectVerb

Získá odkaz na WebPartVerb objekt, který uživateli umožňuje odpojit dva připojené WebPart ovládací prvky.Gets a reference to a WebPartVerb object that enables a user to disconnect two connected WebPart controls.

Display

Získá hodnotu, která označuje, zda ToolZone je ovládací prvek aktuálně zobrazen.Gets a value that indicates whether a ToolZone control is currently displayed.

EditUIStyle

Získá atributy stylu pro upravitelné ovládací prvky obsažené v ToolZone ovládacím prvku.Gets the style attributes for the editable controls contained in a ToolZone control.

(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í.Gets or sets a text message that is displayed in an empty ConnectionsZone control if there are insufficient controls on a Web page to establish a connection.

EmptyZoneTextStyle

Získá atributy stylu pro zástupný text v prázdné zóně.Gets the style attributes for the placeholder text in an empty zone.

(Zděděno od WebZone)
Enabled

Získá nebo nastaví hodnotu označující, jestli je povolený ovládací prvek webového serveru.Gets or sets a value indicating whether the Web server control is enabled.

(Zděděno od WebControl)
EnableTheming

Získá nebo nastaví hodnotu označující, jestli se pro tento ovládací prvek použijí motivy.Gets or sets a value indicating whether themes apply to this control.

(Zděděno od WebControl)
EnableViewState

Získává nebo nastavuje hodnotu, která označuje, jestli ovládací prvek serveru zachovává svůj stav zobrazení, a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Zděděno od Control)
ErrorStyle

Získá atributy stylu pro vykreslování chybové zprávy, která se zobrazí, pokud WebPart ovládací prvek nelze načíst nebo vytvořit.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(Zděděno od WebZone)
Events

Načte seznam delegátů obslužných rutin událostí pro ovládací prvek.Gets a list of event handler delegates for the control. Tato vlastnost je jen ke čtení.This property is read-only.

(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í pro existující připojení.Gets or sets the text of a message displayed in the connection user interface (UI) when there is an error or warning on an existing connection.

Font

Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru.Gets the font properties associated with the Web server control.

(Zděděno od WebControl)
FooterStyle

Získá atributy stylu pro obsah oblasti zápatí zóny.Gets the style attributes for the contents of a zone's footer area.

(Zděděno od WebZone)
ForeColor

Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(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ému poskytovateli, ze kterého příjemce načte data.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named provider from which a consumer will retrieve data.

GetText

Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), které předchází pojmenovanému spotřebiteli, který dostane data od poskytovatele.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named consumer that will receive data from a provider.

HasAttributes

Načte hodnotu, která označuje, zda má ovládací prvek nastavené atributy.Gets a value indicating whether the control has attributes set.

(Zděděno od WebControl)
HasChildViewState

Získá hodnotu, která označuje, zda mají podřízené ovládací prvky aktuálního ovládacího prvku serveru všechna uložená nastavení stavu zobrazení.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Zděděno od Control)
HasFooter

Načte hodnotu, která označuje, jestli má zóna oblast zápatí.Gets a value indicating whether a zone has a footer area.

(Zděděno od WebZone)
HasHeader

Načte hodnotu, která označuje, jestli má zóna oblast záhlaví.Gets a value indicating whether a zone has a header area.

(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.Gets a reference to the WebPartVerb object in the header of a ToolZone control that is used to close the control.

(Zděděno od ToolZone)
HeaderStyle

Získá atributy stylu pro obsah oblasti záhlaví zóny.Gets the style attributes for the contents of a zone's header area.

(Zděděno od WebZone)
HeaderText

Získá nebo nastaví text záhlaví, který se zobrazí v horní části uživatelského rozhraní (UI) připojení vytvořeného ConnectionsZone ovládacím prvkem.Gets or sets the header text that appears at the top of the connection user interface (UI) created by the ConnectionsZone control.

HeaderVerbStyle

Získá atributy stylu pro všechny operace hlaviček zobrazené v ToolZone ovládacím prvku.Gets the style attributes for all header verbs displayed in a ToolZone control.

(Zděděno od ToolZone)
Height

Získá nebo nastaví výšku ovládacího prvku webového serveru.Gets or sets the height of the Web server control.

(Zděděno od WebControl)
ID

Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru.Gets or sets the programmatic identifier assigned to the server control.

(Zděděno od Control)
IdSeparator

Získá znak použitý k oddělení identifikátorů ovládacího prvku.Gets the character used to separate control identifiers.

(Zděděno od Control)
InstructionText

Získá nebo nastaví text, který se použije 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í.Gets or set the text that is used for general instructions about the selected control in the section of the connection user interface (UI) for managing existing connections.

InstructionTextStyle

Získá atributy stylu pro návodový text, který se zobrazí v horní části ToolZone ovládacího prvku.Gets the style attributes for the instruction text that appears at the top of a ToolZone control.

(Zděděno od ToolZone)
InstructionTitle

Získá nebo nastaví text, který se použije pro obecný popis akce, kterou je možné provést na ovládacím prvku příjemce nebo poskytovatele v rámci uživatelského rozhraní připojení (UI) pro správu existujících připojení.Gets or sets the text that is used for a general description of the action that can be performed on the consumer or provider control, within the connection user interface (UI) for managing existing connections.

IsChildControlStateCleared

Získává hodnotu určující, zda ovládací prvky obsažené v rámci tohoto ovládacího prvku mají stav ovládacích prvků.Gets a value indicating whether controls contained within this control have control state.

(Zděděno od Control)
IsEnabled

Načte hodnotu, která označuje, jestli je ovládací prvek povolený.Gets a value indicating whether the control is enabled.

(Zděděno od WebControl)
IsTrackingViewState

Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny stavu zobrazení.Gets a value that indicates whether the server control is saving changes to its view state.

(Zděděno od Control)
IsViewStateEnabled

Načte hodnotu, která označuje, jestli je pro tento ovládací prvek povolený stav zobrazení.Gets a value indicating whether view state is enabled for this control.

(Zděděno od Control)
LabelStyle

Získá atributy stylu pro obsah popisků, které se zobrazují společně s ovládacími prvky pro úpravy v rámci ToolZone ovládacího prvku.Gets the style attributes for the contents of the labels that appear alongside the editing controls within a ToolZone control. Odvozené ToolZone ovládací prvky, například CatalogZone a EditorZone , aplikují styly na popisky.The derived ToolZone controls, such as CatalogZone and EditorZone, apply the styles to the labels.

(Zděděno od ToolZone)
LoadViewStateByID

Načte hodnotu, která označuje, zda se ovládací prvek účastní načítání jeho stavu zobrazení ID místo indexu.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Zděděno od Control)
NamingContainer

Získá odkaz na kontejner názvového serveru ovládacího prvku, který vytvoří jedinečný obor názvů pro odlišení ovládacích prvků serveru se stejnou ID hodnotou vlastnosti.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(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 pokusil vytvořit.Gets or sets the text of a message displayed in the connection user interface (UI) when there is an error or warning on a new connection that a user tries to create.

NoExistingConnectionInstructionText

Získá nebo nastaví návodový text, který se zobrazí v těle uživatelského rozhraní (UI) připojení, když ovládací prvek Webové části nemá žádné existující připojení.Gets or sets the instruction text that appears in the body of the connection user interface (UI) when a Web Parts control has no existing connection.

NoExistingConnectionTitle

Získá nebo nastaví text nadpisu, který se zobrazí v těle uživatelského rozhraní (UI) připojení, když ovládací prvek Webové části nemá žádné existující připojení.Gets or sets the title text that appears in the body of the connection user interface (UI) when a Web Parts control has no existing connection.

Padding

Získá nebo nastaví atributy odsazení buňky v tabulce, která obsahuje WebPart ovládací prvky v zóně.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(Zděděno od WebZone)
Page

Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek.Gets a reference to the Page instance that contains the server control.

(Zděděno od Control)
Parent

Získá odkaz na nadřazený ovládací prvek serveru ovládacího prvku v hierarchii ovládacích prvků stránky.Gets a reference to the server control's parent control in the page control hierarchy.

(Zděděno od Control)
PartChromePadding

Získá nebo nastaví vzdálenost mezi obsahem WebPart ovládacího prvku a ohraničením ovládacího prvku.Gets or sets the distance between the contents of a WebPart control and the border of the control.

(Zděděno od WebZone)
PartChromeStyle

Načte charakteristiky stylu, které se vztahují na ohraničení Webové částich ovládacích prvků obsažených v zóně.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(Zděděno od WebZone)
PartChromeType

Získá nebo nastaví typ ohraničení, které obsahuje snímky ovládacích prvků serveru obsažených v ConnectionsZone ovládacím prvku.Gets or sets the type of border that frames the server controls contained in a ConnectionsZone control.

PartStyle

Načte charakteristiky stylu, které se vztahují na ohraničení a obsah každého ovládacího prvku Webové části obsaženého v zóně.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(Zděděno od WebZone)
PartTitleStyle

Získá atributy stylu pro obsah záhlaví každého ovládacího prvku Webové části obsaženého v zóně.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(Zděděno od WebZone)
ProvidersInstructionText

Získá nebo nastaví instruktážní text zobrazený v části poskytovatelé uživatelského rozhraní (UI) připojení, když připojení již existuje.Gets or sets the instructional text shown in the providers section of the connection user interface (UI), when a connection already exists.

ProvidersTitle

Získá nebo nastaví název zobrazený nad oddílem Provider v uživatelském rozhraní (UI) připojení, když připojení již existuje.Gets or sets the title shown above the providers section of the connection user interface (UI), when a connection already exists.

RenderClientScript

Získá hodnotu, která označuje, zda se má vykreslovat skript klienta na stránce Webové části.Gets a value that indicates whether to render client script on a Web Parts page.

(Zděděno od WebZone)
RenderingCompatibility

Získá hodnotu, která určuje verzi ASP.NET, s jakou bude HTML vykresleno kompatibilní.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(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ému zprostředkovateli, který bude odesílat data příjemci.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named provider that will send data to a consumer.

SendToText

Získá nebo nastaví text zobrazený v části uživatelského rozhraní připojení (UI), které předchází pojmenovanému spotřebiteli, kterému bude poskytovatel odesílat data.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named consumer to which a provider will send data.

Site

Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku, když je vykreslen na návrhové ploše.Gets information about the container that hosts the current control when rendered on a design surface.

(Zděděno od Control)
SkinID

Získá nebo nastaví vzhled, který má být použit pro ovládací prvek.Gets or sets the skin to apply to the control.

(Zděděno od WebControl)
Style

Získá kolekci textových atributů, které budou vykresleny jako atribut style na vnější značce ovládacího prvku webového serveru.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(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 hodnotu Disabled, pokud IsEnabled je vlastnost ovládacího prvku false .Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Zděděno od CompositeControl)
TabIndex

Získá nebo nastaví index karty ovládacího prvku webového serveru.Gets or sets the tab index of the Web server control.

(Zděděno od WebControl)
TagKey

Získá HtmlTextWriterTag hodnotu, která odpovídá tomuto ovládacímu prvku webového serveru.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Tato vlastnost se používá hlavně při řízení vývojářů.This property is used primarily by control developers.

(Zděděno od WebZone)
TagName

Získá název značky ovládacího prvku.Gets the name of the control tag. Tato vlastnost se používá hlavně při řízení vývojářů.This property is used primarily by control developers.

(Zděděno od WebControl)
TemplateControl

Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek.Gets or sets a reference to the template that contains this control.

(Zděděno od Control)
TemplateSourceDirectory

Načte virtuální adresář Page nebo obsahující UserControl aktuální serverový ovládací prvek.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Zděděno od Control)
ToolTip

Získá nebo nastaví text, který se zobrazí, když ukazatel myši najede myší na ovládací prvek webového serveru.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Zděděno od WebControl)
UniqueID

Získá jedinečný a hierarchicky kvalifikovaný identifikátor pro serverový ovládací prvek.Gets the unique, hierarchically qualified identifier for the server control.

(Zděděno od Control)
ValidateRequestMode

Získává nebo nastavuje hodnotu, která indikuje, jestli ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Zděděno od Control)
VerbButtonType

Získá nebo nastaví typ tlačítka, který se používá k reprezentaci operací v zóně.Gets or sets what kind of button is used to represent verbs in a zone.

(Zděděno od WebZone)
VerbStyle

Získá atributy stylu pro slovesa uživatelského rozhraní (UI) přidružené k ovládacím prvkům Webové části v zóně.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Zděděno od Control)
ViewStateIgnoresCase

Načte hodnotu, která označuje, zda StateBag se v objektu nerozlišují velká a malá písmena.Gets a value that indicates whether the StateBag object is case-insensitive.

(Zděděno od Control)
ViewStateMode

Získá nebo nastaví režim stavu zobrazení tohoto ovládacího prvku.Gets or sets the view-state mode of this control.

(Zděděno od Control)
Visible

Získává nebo nastavuje hodnotu, která indikuje, jestli je serverový ovládací prvek vykreslený jako prvek uživatelského rozhraní (UI) na stránce.Gets or sets a value that indicates whether a server control is rendered as a user interface (UI) element on the page.

(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é části.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(Zděděno od WebZone)
WebPartToConnect

Získá aktuálně vybraný WebPart ovládací prvek, ke kterému se chcete připojit.Gets the currently selected WebPart control to connect to.

Width

Získá nebo nastaví šířku ovládacího prvku webového serveru.Gets or sets the width of the Web server control.

(Zděděno od WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Přidá atributy a styly HTML, které je nutné vykreslit do určeného HtmlTextWriterTag .Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Tato metoda se primárně používá pro řízení vývojářů.This method is used primarily by control developers.

(Zděděno od WebControl)
AddedControl(Control, Int32)

Volá se po přidání podřízeného ovládacího prvku do Controls kolekce Control objektu.Called after a child control is added to the Controls collection of the Control object.

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

Oznamuje ovládacímu prvku serveru, že došlo k analýze prvku, buď XML nebo HTML, a přidá prvek do objektu serverového ovládacího prvku ControlCollection .Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(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.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Tato metoda je primárně používána vývojářům ovládacích prvků.This method is primarily used by control developers.

(Zděděno od WebControl)
ApplyStyleSheetSkin(Page)

Aplikuje vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek.Applies the style properties defined in the page style sheet to the control.

(Zděděno od Control)
BeginRenderTracing(TextWriter, Object)

Spustí trasování dat pro vykreslování v době návrhu.Begins design-time tracing of rendering data.

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

Shromažďuje informace o ovládacím prvku serveru a poskytuje ho do Trace vlastnosti, která se zobrazí, pokud je pro stránku povoleno trasování.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

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

Nastaví hodnotu uloženou v mezipaměti ClientID na null .Sets the cached ClientID value to null.

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

Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serverového ovládacího prvku.Deletes the control-state information for the server control's child controls.

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

Odstraní informace o stavu zobrazení a stavu ovládacího prvku pro všechny podřízené ovládací prvky serverového ovládacího prvku.Deletes the view-state and control-state information for all the server control's child controls.

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

Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serverového ovládacího prvku.Deletes the view-state information for all the server control's child controls.

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

Nastaví ClientIDMode vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

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

Ukončí připojení uživatelského rozhraní (UI), které vytvořil ConnectionsZone ovládací prvek.Closes the connection user interface (UI) created by the ConnectionsZone control.

CopyBaseAttributes(WebControl)

Zkopíruje vlastnosti nezapouzdřené Style objektem 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.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Tato metoda se primárně používá pro řízení vývojářů.This method is used primarily by control developers.

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

Vytvoří všechny podřízené ovládací prvky obsažené v ConnectionsZone ovládacím prvku při přípravě pro odeslání zpátky na server nebo vykreslování.Creates all child controls contained in a ConnectionsZone control in preparation for posting back to the server or rendering.

CreateControlCollection()

Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku Server.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

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

Vytvoří objekt Style, který je interně používán WebControl třídou pro implementaci všech vlastností souvisejících s Style.Creates the style object that is used internally by the WebControl class to implement all style related properties. Tato metoda se primárně používá pro řízení vývojářů.This method is used primarily by control developers.

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

Váže zdroj dat ke CompositeControl všem jeho podřízeným ovládacím prvkům.Binds a data source to the CompositeControl and all its child controls.

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

Váže zdroj dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolání DataBinding události.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

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

Váže zdroj dat k podřízeným ovládacím prvkům serverového ovládacího prvku.Binds a data source to the server control's child controls.

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

Umožňuje serverový ovládací prvek provést finální vyčištění před jeho uvolněním z paměti.Enables a server control to perform final clean up before it is released from memory.

(Zděděno od Control)
EndRenderTracing(TextWriter, Object)

Ukončí trasování dat pro vykreslování v době návrhu.Ends design-time tracing of rendering data.

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

Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky.Determines whether the server control contains child controls. Pokud tomu tak není, vytvoří podřízené ovládací prvky.If it does not, it creates child controls.

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

Vytvoří identifikátor pro ovládací prvky, které nemají přiřazen identifikátor.Creates an identifier for controls that do not have an identifier assigned.

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

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

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

Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným id parametrem.Searches the current naming container for a server control with the specified id parameter.

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

Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným id a celočíselným pathOffset parametrem, který pomáhá hledání.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Tuto verzi metody byste neměli přepsat FindControl .You should not override this version of the FindControl method.

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

Nastaví fokus vstupu na ovládací prvek.Sets input focus to a control.

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

Načte data v době návrhu ovládacího prvku.Gets design-time data for a control.

(Zděděno od Control)
GetEffectiveChromeType(Part)

Vrátí skutečnou nebo platnou aktuální PartChromeType hodnotu WebPart ovládacího prvku s ohledem na PartChromeType vlastnost zóny a aktuální režim zobrazení stránky webové části.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

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

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetRouteUrl(Object)

Získá adresu URL, která odpovídá sadě parametrů trasy.Gets the URL that corresponds to a set of route parameters.

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

Získá adresu URL, která odpovídá sadě parametrů trasy.Gets the URL that corresponds to a set of route parameters.

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

Získá adresu URL, která odpovídá sadě parametrů směrování a názvu trasy.Gets the URL that corresponds to a set of route parameters and a route name.

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

Získá adresu URL, která odpovídá sadě parametrů směrování a názvu trasy.Gets the URL that corresponds to a set of route parameters and a route name.

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

Získá Type aktuální instanci.Gets the Type of the current instance.

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

Vrátí předem stanovenou část UniqueID vlastnosti určeného ovládacího prvku.Returns the prefixed portion of the UniqueID property of the specified control.

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

Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky.Determines if the server control contains any child controls.

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

Vrací hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky.Returns a value indicating whether events are registered for the control or any child controls.

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

Určuje, zda ovládací prvek Server obsahuje pouze literálový obsah.Determines if the server control holds only literal content.

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

Obnoví informace o stavu ovládacího prvku z požadavku předchozí stránky, který byl uložen SaveControlState() metodou.Restores control state information from a previous page request that was saved by the SaveControlState() method.

LoadViewState(Object)

Obnoví informace o stavu zobrazení z předchozí žádosti o stránku uložené SaveViewState() metodou.Restores view-state information from a previous page request that was saved by the SaveViewState() method.

MapPathSecure(String)

Načte fyzickou cestu, na kterou je namapována virtuální cesta, buď absolutní, nebo relativní.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

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

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current 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.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Tato metoda se primárně používá pro řízení vývojářů.This method is used primarily by control developers.

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

Určuje, zda je událost ovládacího prvku Server předána hierarchii ovládacích prvků serveru uživatelského rozhraní stránky.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Zděděno od Control)
OnDataBinding(EventArgs)

Vyvolá DataBinding událost.Raises the DataBinding event.

(Zděděno od Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Vyvolá DisplayModeChanged událost.Raises the DisplayModeChanged event.

OnInit(EventArgs)

Vyvolá Init událost.Raises the Init event.

OnLoad(EventArgs)

Vyvolá Load událost.Raises the Load event.

(Zděděno od Control)
OnPreRender(EventArgs)

Vyvolá PreRender událost.Raises the PreRender event.

(Zděděno od WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Vyvolá SelectedWebPartChanged událost.Raises the SelectedWebPartChanged event.

OnUnload(EventArgs)

Vyvolá Unload událost.Raises the Unload event.

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

Načte soubor, který Stream se použije ke čtení souboru.Gets a Stream used to read a file.

(Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)

Přiřadí všechny zdroje události a její informace nadřazenému ovládacímu prvku.Assigns any sources of the event and its information to the control's parent.

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

Vyvolá událost pro ConnectionsZone ovládací prvek, když formulář, který ho obsahuje, se odešle zpátky na server.Raises an event for the ConnectionsZone control when the form that contains it posts back to the server.

RecreateChildControls()

Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeném z CompositeControl .Recreates the child controls in a control derived from CompositeControl.

(Zděděno od CompositeControl)
RemovedControl(Control)

Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce Control objektu.Called after a child control is removed from the Controls collection of the Control object.

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

Vykreslí obsah ConnectionsZone ovládacího prvku k určenému HtmlTextWriter objektu.Renders the contents of the ConnectionsZone control to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Vykreslí otevření značky HTML ovládacího prvku zóny pro zadaný HtmlTextWriter objekt.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

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

Odesílá obsah ConnectionsZone oblasti textu ovládacího prvku do zadaného HtmlTextWriter objektu, který zapisuje obsah na webovou stránku.Sends the content of a ConnectionsZone control's body area to the specified HtmlTextWriter object, which writes the content to the Web page.

RenderChildren(HtmlTextWriter)

Vypíše obsah podřízených ovládacích prvků serveru do poskytnutého HtmlTextWriter objektu, který zapisuje obsah, který má být vykreslen na klientovi.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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

Vykreslí celý obsah ovládacího prvku zóny mezi počáteční a koncovou značkou pro zadaný HtmlTextWriter objekt.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

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

Vypíše obsah ovládacího prvku serveru na poskytnutý HtmlTextWriter objekt a uloží trasovací informace o ovládacím prvku, pokud je povoleno trasování.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

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

Vytvoří výstup obsahu ovládacího prvku serveru pro zadaný HtmlTextWriter objekt pomocí poskytnutého ControlAdapter objektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

Vykreslí ukončovací značku HTML ovládacího prvku do zadaného zapisovače.Renders the HTML closing tag of the control into the specified writer. Tato metoda se primárně používá pro řízení vývojářů.This method is used primarily by control developers.

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

Přepíše základní metodu pro vykreslení operací v zápatí ToolZone ovládacího prvku.Overrides the base method to render verbs in the footer of a ToolZone control.

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

Přepíše základní metodu pro poskytnutí specializovaného vykreslování pro oblast hlavičky, kterou vyžadují ToolZone ovládací prvky.Overrides the base method to provide specialized rendering for the header area required by ToolZone controls.

(Zděděno od ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Vykreslí jednotlivé operace s ToolZone ovládacím prvkem.Renders an individual verb with a ToolZone control.

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

Vykreslí příkazy na úrovni zóny pro ConnectionsZone ovládací prvek.Renders the zone-level verbs for a ConnectionsZone control.

ResolveAdapter()

Získá adaptér ovládacího prvku, který je zodpovědný za vykreslení zadaného ovládacího prvku.Gets the control adapter responsible for rendering the specified control.

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

Získá adresu URL, kterou může použít prohlížeč.Gets a URL that can be used by the browser.

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

Převede adresu URL na tu, která je použitelná na žádajícím klientovi.Converts a URL into one that is usable on the requesting client.

(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í chvíle, kdy byla stránka odeslána zpět na server.Saves any Web Parts control state changes that occurred since the last time the page was posted back to the server.

SaveViewState()

Uloží ConnectionsZone změny stavu zobrazení ovládacího prvku, ke kterým došlo od posledního odeslání stránky zpět na server.Saves a ConnectionsZone control's view-state changes that occurred since the page was last posted back to the server.

SetDesignModeState(IDictionary)

Nastaví data při návrhu ovládacího prvku.Sets design-time data for a control.

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

Přiřadí delegáta obslužné rutiny události, aby vykreslil serverový ovládací prvek a jeho obsah do svého nadřazeného ovládacího prvku.Assigns an event handler delegate to render the server control and its content into its parent control.

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

Nastaví data trasování pro trasování vykreslování dat při návrhu pomocí klíče dat trasování a hodnoty dat trasování.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

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

Nastaví data trasování pro trasování vykreslování dat při návrhu, pomocí sledovaného objektu, klíče trasování dat a hodnoty dat trasování.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

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

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
TrackViewState()

Sleduje změny stavu zobrazení ConnectionsZone v ovládacím prvku tak, aby bylo možné uložit změny do objektu ovládacího prvku StateBag .Tracks view-state changes to the ConnectionsZone control so the changes can be stored in the control's StateBag object.

Události

DataBinding

Nastane, pokud se serverový ovládací prvek váže ke zdroji dat.Occurs when the server control binds to a data source.

(Zděděno od Control)
Disposed

Nastane, pokud se serverový ovládací prvek uvolní z paměti, což je poslední fáze životního cyklu řízení serveru, když se požaduje stránka ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Zděděno od Control)
Init

Nastane při inicializaci ovládacího prvku serveru, který je prvním krokem v jeho životním cyklu.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Zděděno od Control)
Load

Nastane, pokud je serverový ovládací prvek načten do Page objektu.Occurs when the server control is loaded into the Page object.

(Zděděno od Control)
PreRender

Nastane po Control načtení objektu, ale před jeho vykreslením.Occurs after the Control object is loaded but prior to rendering.

(Zděděno od Control)
Unload

Vyvolá se v případě, že je serverový ovládací prvek uvolněn z paměti.Occurs when the server control is unloaded from memory.

(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.Gets an attribute of the Web control with the specified name.

(Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)

Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu.Sets an attribute of the Web control to the specified name and value.

(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í v době návrhu.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Zděděno od CompositeControl)
IControlBuilderAccessor.ControlBuilder

Popis tohoto člena naleznete v tématu ControlBuilder .For a description of this member, see ControlBuilder.

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

Popis tohoto člena naleznete v tématu GetDesignModeState() .For a description of this member, see GetDesignModeState().

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

Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

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

Popis tohoto člena naleznete v tématu SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

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

Popis tohoto člena naleznete v tématu UserData .For a description of this member, see UserData.

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

Popis tohoto člena naleznete v tématu DataBindings .For a description of this member, see DataBindings.

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

Popis tohoto člena naleznete v tématu HasDataBindings .For a description of this member, see HasDataBindings.

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

Popis tohoto člena naleznete v tématu Expressions .For a description of this member, see Expressions.

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

Popis tohoto člena naleznete v tématu HasExpressions .For a description of this member, see HasExpressions.

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

Popis tohoto člena naleznete v tématu AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

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

Implementuje RaisePostBackEvent(String) metodu.Implements the RaisePostBackEvent(String) method.

(Zděděno od ToolZone)

Metody rozšíření

FindDataSourceControl(Control)

Vrátí zdroj dat, který je přidružen k ovládacímu prvku dat pro určený ovládací prvek.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Vrátí šablonu pole pro zadaný sloupec v názvovém kontejneru zadaného ovládacího prvku.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Vrátí objekt meta objektu obsahujícího ovládací prvek dat.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Získá kolekci výchozích hodnot pro určený ovládací prvek dat.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Získá metadata tabulky pro určený ovládací prvek dat.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Nastaví metadata tabulky pro určený ovládací prvek dat.Sets the table metadata for the specified data control.

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

Nastaví metadata tabulky a mapování výchozích hodnot pro určený ovládací prvek dat.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Nastaví metadata tabulky a mapování výchozích hodnot pro určený ovládací prvek dat.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Určuje, zda jsou k dispozici metadata tabulky.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Povoluje chování dynamických dat pro určený ovládací prvek dat.Enables Dynamic Data behavior for the specified data control.

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

Povoluje chování dynamických dat pro určený ovládací prvek dat.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Povoluje chování dynamických dat pro určený ovládací prvek dat.Enables Dynamic Data behavior for the specified data control.

Platí pro

Viz také