ConnectionsZone Klasa

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Udostępnia interfejs użytkownika, który umożliwia użytkownikom tworzenie połączeń między WebPart i innymi kontrolkami serwera, które znajdują się w WebPartZoneBase strefach.

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

Dziedziczenie

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Przykłady

W poniższym przykładzie kodu pokazano, jak używać kontrolki ConnectionsZone na stronie składników Web Part. Przykład zawiera cztery części:

• Kontrolka użytkownika, która umożliwia przełączanie trybów wyświetlania na stronie sieci Web.

• Plik źródłowy zawierający kod interfejsu kodu pocztowego i dwie WebPart kontrolki działające jako dostawca i odbiorca połączenia.

• Strona sieci Web, która hostuje wszystkie kontrolki, demonstruje sposób deklarowania <asp:connectionszone> elementu i ustawia szereg właściwości w strefie połączeń deklaratywnie i programowo.

• Wyjaśnienie działania przykładu w przeglądarce.

Pierwszą częścią tego przykładu kodu jest kontrolka użytkownika, która umożliwia użytkownikom przełączanie trybów wyświetlania na stronie sieci Web. Aby uzyskać szczegółowe informacje na temat trybów wyświetlania i opisu kodu źródłowego w tej kontrolce, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składników Web Part.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Drugą częścią przykładu jest plik źródłowy z interfejsem i kontrolkami niestandardowymi. Zwróć uwagę, że kontrolka ZipCodeWebPart implementuje IZipCode interfejs, dodając ConnectionProvider atrybut, aby kontrolka mogła działać jako dostawca połączenia. Kontrolka WeatherWebPart ma metodę oznaczoną atrybutem ConnectionConsumer , gdzie korzysta z interfejsu IZipCode , dzięki czemu może działać jako użytkownik w połączeniu.

Aby można było uruchomić przykładowy kod, należy skompilować ten kod źródłowy. Można je skompilować jawnie i umieścić wynikowy zestaw w folderze Bin witryny sieci Web lub globalnej pamięci podręcznej zestawów. Alternatywnie można umieścić kod źródłowy w folderze App_Code witryny, w którym będzie dynamicznie kompilowany w czasie wykonywania. W tym przykładzie użyto kompilacji dynamicznej. Aby zapoznać się z przewodnikiem, który pokazuje sposób kompilowania, zobacz Przewodnik: tworzenie i używanie niestandardowej kontrolki serwera sieci Web.

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

Trzecią częścią przykładowego kodu jest strona internetowa. W górnej części znajdują Register się dyrektywy dotyczące kontrolki użytkownika i kontrolek niestandardowych używanych w połączeniu. Element <asp:connectionszone> jest zadeklarowany na stronie jako przykład użycia kontrolki ConnectionsZone deklaratywnie. W elemecie wiele właściwości jest ustawianych deklaratywnie. Inne właściwości w strefie połączeń są ustawiane programowo w <script> sekcji strony.

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

Załaduj stronę internetową w przeglądarce. Użyj kontrolki listy rozwijanej Tryb wyświetlania , aby przełączyć stronę do trybu łączenia. W menu czasowników kontrolki Dostawca kodu POCZTOWEgo (menu czasowników jest wskazywane przez strzałkę w dół na pasku tytułu kontrolki), kliknij czasownik połącz. Zostanie wyświetlona kontrolka ConnectionsZone . Zwróć uwagę, że w interfejsie użytkownika połączenia zostanie wyświetlony przycisk Zakończ połączenie ; połączenie zostało już zadeklarowane na znacznikach strony, więc kontrolki są już połączone. Kliknij przycisk Zakończ połączenie, a następnie ponownie użyj kontrolki Tryb wyświetlania , aby powrócić do trybu przeglądania strony. Następnie ponownie zwróć stronę, aby połączyć tryb, kliknij czasownik połącz w jednej z kontrolek i zwróć uwagę, że interfejs użytkownika połączenia wyświetla teraz hiperlink, który umożliwia utworzenie połączenia między kontrolkami. Kliknij link i użyj interfejsu użytkownika połączenia, aby wybrać punkty połączenia i ustanowić połączenie.

Uwagi

Za pomocą zestawu kontrolek składników Web Part można włączyć dwie kontrolki serwera w celu utworzenia połączenia i udostępnienia danych, z jedną kontrolką działającą jako dostawca, a drugą działającą jako odbiorca danych. Te dwie kontrolki mogą być WebPart kontrolkami lub dowolnym innym typem WebPartZoneBase kontroli serwera, pod warunkiem, że są one przeznaczone do obsługi połączeń i że znajdują się w strefie. Aby dowiedzieć się więcej na temat połączeń składników Web Part, zobacz WebPartConnection omówienie klas i ConnectionPoint oraz Omówienie połączeń składników Web Part.

Pod warunkiem, że istnieją wymagane kontrolki i warunki, aby utworzyć połączenie składników Web Part, nadal konieczne jest rzeczywiste połączenie kontrolek. Istnieją trzy sposoby tworzenia połączenia między kontrolkami serwera: deklarowanie połączenia na stronie sieci Web, tworzenie połączenia w kodzie lub dodawanie ConnectionsZone kontrolki do strony, aby użytkownicy mogli łączyć kontrolki na żądanie. Kontrolka ConnectionsZone generuje interfejs użytkownika, który umożliwia użytkownikom łączenie lub odłączanie wszelkich kontrolek serwera na stronie, które spełniają warunki niezbędne do utworzenia połączenia. Jest to opcjonalna kontrolka, która nie jest niezbędna do tworzenia połączeń, ale jest przydatna w przypadku, gdy chcesz dać użytkownikom kontrolę nad tym, które kontrolki serwera są połączone lub rozłączone.

Kontrolka ConnectionsZone jest jedną z kontrolek strefy narzędzi składników Web Part, które dziedziczą po klasie bazowej ToolZone . Jako strefa narzędzi kontrolka ConnectionsZone jest widoczna tylko wtedy, gdy jej strona sieci Web jest w określonym trybie wyświetlania. W takim przypadku tryb wyświetlania nosi nazwę tryb łączenia (strona jest w tym trybie, gdy WebPartManager kontrolka na stronie ma ustawioną DisplayModeConnectDisplayModewartość właściwości ). Gdy użytkownicy przełączą stronę w tryb połączenia, muszą kliknąć czasownik połączenia w menu czasowników jednego z kontrolek serwera, a następnie interfejs użytkownika połączenia staje się widoczny.

Jako kontrolka strefy składników WebZone Web Part kontrolka ConnectionsZone jest typem strefy (która dziedziczy po CompositeControl klasie), która ma zawierać inne kontrolki. Ogólnie rzecz biorąc, ConnectionsZone strefa ma większość tych samych elementów co inne strefy narzędzi składników Web Part: nagłówek, obszar treści lub zawartości i stopka. Aby zapoznać się z pełną dyskusją na temat strefy składników Web Part i różnych części strefy, zobacz WebZone omówienie klasy.

Ważne

W przeciwieństwie do większości innych stref składników Web Part należy pamiętać, że ConnectionsZone strefa nie zawiera unikatowego typu kontrolki serwera skojarzonej z nią. Aby uzyskać listę stref i skojarzonych kontrolek, które zawierają, zobacz wykres w przeglądzie WebZone klasy. ConnectionsZone Strefa nie zawiera WebPartConnection jednak kontrolek. Zamiast tego służy on do bardzo ograniczonego celu udostępniania interfejsu użytkownika do łączenia lub odłączania kontrolek serwera, które istnieją w niektórych WebPartZoneBase strefach na stronie. Jedynymi kontrolkami zawartymi w kontrolce ConnectionsZone są standardowe ASP.NET kontrolek serwera, które generuje jako część interfejsu użytkownika do tworzenia połączeń.

Gdy kontrolka ConnectionsZone jest renderowana, generuje interfejs użytkownika na podstawie kontrolek serwera na stronie, które mogą tworzyć połączenia. Kontrolka ConnectionsZone określa, które kontrolki serwera w WebPartZoneBase strefie na stronie są dostawcami, którzy są konsumentami, które punkty połączenia są dostępne, oraz czy kontrolki serwera są aktualnie połączone lub rozłączone, a następnie generuje odpowiednio interfejs użytkownika.

Załóżmy na przykład, że istnieje jedna WebPart kontrolka, która może być dostawcą, jedna WebPart kontrolka zdolna do bycia konsumentem, jest zadeklarowana na WebPartZone stronie i jest obecnie rozłączona. Gdy użytkownik przełączy stronę w tryb połączenia i kliknie czasownik połączenia w jednej z kontrolek, ConnectionsZone kontrolka generuje interfejs użytkownika z linkiem, który po kliknięciu wyświetla formularz, w którym użytkownicy mogą wybrać opcje tworzenia połączenia. (Jeśli kontrolki zostały wcześniej połączone, w widoku początkowym zostanie wyświetlony przycisk umożliwiający odłączenie kontrolek). W interfejsie użytkownika połączenia do tworzenia nowych połączeń użytkownicy są wyświetlani, którzy kontrolki są dostawcą i które kontrolki są konsumentami. Kontrolka listy rozwijanej jest wyświetlana poniżej każdej kontrolki serwera z listą dostępnych ConnectionPoint obiektów dla kontrolki. Na odpowiednich listach rozwijanych użytkownicy muszą wybrać jeden ProviderConnectionPoint obiekt dostawcy (aby określić, jaki interfejs i dane będą udostępniane konsumentom), oraz jeden ConsumerConnectionPoint obiekt dla każdego konsumenta (aby określić, jaki interfejs i dane będą używane przez użytkownika), który zostanie połączony z dostawcą.

Uwaga

W kontrolce składników Web Part ustawiono domyślną implementację, jeden dostawca może łączyć się z wieloma użytkownikami, ale użytkownik może mieć tylko jednego dostawcę.

Aby użyć kontrolki ConnectionsZone , można zadeklarować ją w elemecie <form> na stronie sieci Web (ale nie zagnieżdżone w innym elemecie strefy składników Web Part), za pomocą <asp:connectionszone> elementu lub dodać go do strony programowo. W przypadku deklarowania elementu na stronie, w przeciwieństwie do innych stref składników Web Part, nie można zadeklarować żadnego innego typu kontrolek serwera między tagami <asp:connectionszone> elementu. Można zadeklarować elementy, które odnoszą się do własnych właściwości i szczegółów stylu, ale jest to element autonomiczny i nie jest kontrolką szablonu, w ramach której można zadeklarować inne kontrolki serwera.

Uwaga

Aby zwiększyć dostępność, kontrolka ConnectionsZone jest renderowana w elemecie <fieldset> . Element <fieldset> grupuje powiązany zestaw kontrolek używanych do nawiązywania połączeń w kontrolce ConnectionsZone i ułatwia nawigację kartami między tymi kontrolkami zarówno dla agentów użytkownika wizualnego (takich jak zwykłe przeglądarki sieci Web) i agentów użytkowników zorientowanych na mowę (takich jak oprogramowanie do czytania ekranu).

Kontrolka ConnectionsZone ma wiele właściwości używanych do renderowania interfejsu użytkownika połączenia. Jeden zestaw właściwości zawiera kilka czasowników używanych tylko w odniesieniu do połączeń — które wykonują akcje w interfejsie użytkownika: ConfigureVerb, ConnectVerbi DisconnectVerb. Duży zestaw właściwości, używany szczególnie w przypadku interfejsu użytkownika strefy połączeń, składa się z ciągów tekstowych wyświetlanych w różnych miejscach (lub w niektórych sytuacjach, takich jak wystąpienia błędów) w interfejsie użytkownika: ConfigureConnectionTitle, ConnectToConsumerTextNoExistingConnectionTitleConnectToConsumerInstructionTextConnectToConsumerTitleExistingConnectionErrorMessageConsumersTitleGetFromTextConsumersInstructionTextGetTextConnectToProviderTitleInstructionTitleNewConnectionErrorMessageConnectToProviderTextConnectToProviderInstructionTextProvidersInstructionTextProvidersTitleNoExistingConnectionInstructionTextSendTexti .SendToText Klasa ConnectionsZone zawiera również wiele typowych właściwości znalezionych w innych strefach składników Web Part: CancelVerb, , DisplayCloseVerb, EmptyZoneTextHeaderText, , InstructionText, i PartChromeType. WebPartToConnect Na koniec właściwość jest unikatowa dla klasy, odwołując się do kontrolki, która inicjuje połączenie (jest to kontrolka, na której użytkownik klika czasownik connect w menu zleceń, do którego odwołuje się również kontrolka we WebPartManager właściwości kontrolkiSelectedWebPart).

Klasa ConnectionsZone ma również wiele metod, z których wszystkie są dziedziczone i zastępowane z klas bazowych, a większość z nich pochodzi z podstawowych klas stref składników Web Part. Aby uzyskać szczegółowe informacje, zobacz poszczególne metody.

Uwagi dotyczące dziedziczenia

Klasę ConnectionsZone można rozszerzyć, jeśli deweloperzy chcą zmienić jego zachowanie lub domyślny interfejs użytkownika, który zapewnia do pracy z połączeniami.

Konstruktory

ConnectionsZone()

Inicjuje nowe wystąpienie klasy ConnectionsZone.

Właściwości

AccessKey	Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl)
Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
AssociatedDisplayModes	Pobiera kolekcję obiektów skojarzonych WebPartDisplayMode z określoną ToolZone strefą. (Odziedziczone po ToolZone)
Attributes	Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl)
BackColor	Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BackImageUrl	Pobiera lub ustawia adres URL na obraz tła strefy. (Odziedziczone po WebZone)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control)
BorderColor	Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl)
BorderStyle	Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BorderWidth	Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
CancelVerb	Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym anulowanie procesu nawiązywania połączenia.
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control)
ClientIDMode	Pobiera lub ustawia algorytm używany do generowania ClientID wartości właściwości. (Odziedziczone po Control)
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control)
CloseVerb	Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zamknięcie interfejsu użytkownika połączenia utworzonego przez kontrolkę ConnectionsZone .
ConfigureConnectionTitle	Pobiera lub ustawia tekst wyświetlany jako tytuł podsekcji interfejsu użytkownika połączenia utworzonego przez kontrolkę ConnectionsZone .
ConfigureVerb	Pobiera odwołanie do obiektu używanego WebPartVerb do otwierania widoku konfiguracji w interfejsie użytkownika połączenia.
ConnectToConsumerInstructionText	Pobiera lub ustawia tekst instruktażowy wyświetlany w sekcji interfejsu użytkownika połączenia, z którym użytkownicy wybierają punkt połączenia klienta, z którym dostawca będzie się łączyć.
ConnectToConsumerText	Pobiera lub ustawia tekst hiperlinku, który użytkownik klika, aby otworzyć widok, w którym mogą wybrać kontrolkę konsumenta dla połączenia.
ConnectToConsumerTitle	Pobiera lub ustawia tekst tytułu sekcji w interfejsie użytkownika połączenia, z którym użytkownicy mogą wybrać określonego konsumenta do nawiązania połączenia.
ConnectToProviderInstructionText	Pobiera lub ustawia tekst instruktażowy wyświetlany w sekcji interfejsu użytkownika połączenia, z którym użytkownicy wybierają punkt połączenia dostawcy, z którym użytkownik będzie się łączyć.
ConnectToProviderText	Pobiera lub ustawia tekst hiperlinku, który użytkownik klika, aby otworzyć widok, w którym mogą wybrać kontrolę dostawcy dla połączenia.
ConnectToProviderTitle	Pobiera lub ustawia tekst tytułu sekcji w interfejsie użytkownika połączenia, z którym użytkownicy mogą wybrać określonego dostawcę do nawiązania połączenia.
ConnectVerb	Pobiera odwołanie do WebPartVerb obiektu, który umożliwia nawiązanie połączenia z dwoma WebPart kontrolkami.
ConsumersInstructionText	Pobiera lub ustawia tekst instrukcji wyświetlany w sekcji konsumentów interfejsu użytkownika połączenia, gdy połączenie już istnieje.
ConsumersTitle	Pobiera lub ustawia tytuł wyświetlany powyżej sekcji konsumentów interfejsu użytkownika połączenia, gdy połączenie już istnieje.
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne w obiekcie CompositeControl. (Odziedziczone po CompositeControl)
ControlStyle	Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ControlStyleCreated	Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości . Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CssClass	Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl)
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
DisconnectVerb	Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikowi rozłączenie dwóch połączonych WebPart kontrolek.
Display	Pobiera wartość wskazującą, czy kontrolka jest obecnie wyświetlana ToolZone .
EditUIStyle	Pobiera atrybuty stylu dla kontrolek edytowalnych zawartych w kontrolce ToolZone . (Odziedziczone po ToolZone)
EmptyZoneText	Pobiera lub ustawia komunikat tekstowy wyświetlany w pustej ConnectionsZone kontrolce, jeśli na stronie sieci Web nie ma wystarczających kontrolek w celu nawiązania połączenia.
EmptyZoneTextStyle	Pobiera atrybuty stylu dla tekstu zastępczego w pustej strefie. (Odziedziczone po WebZone)
Enabled	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl)
EnableTheming	Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl)
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie. (Odziedziczone po Control)
ErrorStyle	Pobiera atrybuty stylu do renderowania komunikatu o błędzie wyświetlanego, jeśli WebPart nie można załadować ani utworzyć kontrolki. (Odziedziczone po WebZone)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
ExistingConnectionErrorMessage	Pobiera lub ustawia tekst komunikatu wyświetlanego w interfejsie użytkownika połączenia w przypadku wystąpienia błędu lub ostrzeżenia dotyczącego istniejącego połączenia.
Font	Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl)
FooterStyle	Pobiera atrybuty stylu zawartości obszaru stopki strefy. (Odziedziczone po WebZone)
ForeColor	Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl)
GetFromText	Pobiera lub ustawia tekst wyświetlany w sekcji interfejsu użytkownika połączenia, który poprzedza nazwanego dostawcę, z którego użytkownik pobierze dane.
GetText	Pobiera lub ustawia tekst wyświetlany w sekcji interfejsu użytkownika połączenia, który poprzedza nazwanego konsumenta, który będzie odbierał dane od dostawcy.
HasAttributes	Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl)
HasChildViewState	Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control)
HasFooter	Pobiera wartość wskazującą, czy strefa ma obszar stopki. (Odziedziczone po WebZone)
HasHeader	Pobiera wartość wskazującą, czy strefa ma obszar nagłówka. (Odziedziczone po WebZone)
HeaderCloseVerb	Pobiera odwołanie do WebPartVerb obiektu w nagłówku kontrolki ToolZone używanej do zamykania kontrolki. (Odziedziczone po ToolZone)
HeaderStyle	Pobiera atrybuty stylu zawartości obszaru nagłówka strefy. (Odziedziczone po WebZone)
HeaderText	Pobiera lub ustawia tekst nagłówka wyświetlany w górnej części interfejsu użytkownika połączenia utworzonego przez kontrolkę ConnectionsZone .
HeaderVerbStyle	Pobiera atrybuty stylu dla wszystkich czasowników nagłówka wyświetlanych w kontrolce ToolZone . (Odziedziczone po ToolZone)
Height	Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
InstructionText	Pobiera lub ustawia tekst używany do ogólnych instrukcji dotyczących wybranej kontrolki w sekcji interfejsu użytkownika połączenia do zarządzania istniejącymi połączeniami.
InstructionTextStyle	Pobiera atrybuty stylu tekstu instrukcji wyświetlanego u góry kontrolki ToolZone . (Odziedziczone po ToolZone)
InstructionTitle	Pobiera lub ustawia tekst, który jest używany do ogólnego opisu akcji, którą można wykonać na kontroli konsumenta lub dostawcy, w interfejsie użytkownika połączenia na potrzeby zarządzania istniejącymi połączeniami.
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsEnabled	Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsViewStateEnabled	Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control)
LabelStyle	Pobiera atrybuty stylu zawartości etykiet, które pojawiają się obok kontrolek edycji w kontrolce ToolZone . ToolZone Pochodne kontrolki, takie jak CatalogZone i EditorZone, stosują style do etykiet. (Odziedziczone po ToolZone)
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control)
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
NewConnectionErrorMessage	Pobiera lub ustawia tekst komunikatu wyświetlanego w interfejsie użytkownika połączenia w przypadku wystąpienia błędu lub ostrzeżenia dotyczącego nowego połączenia, które użytkownik próbuje utworzyć.
NoExistingConnectionInstructionText	Pobiera lub ustawia tekst instrukcji wyświetlany w treści interfejsu użytkownika połączenia, gdy kontrolka składników Web Part nie ma istniejącego połączenia.
NoExistingConnectionTitle	Pobiera lub ustawia tekst tytułu wyświetlany w treści interfejsu użytkownika połączenia, gdy kontrolka składników Web Part nie ma istniejącego połączenia.
Padding	Pobiera lub ustawia atrybuty uzupełniania komórek w tabeli zawierającej kontrolki WebPart w strefie. (Odziedziczone po WebZone)
Page	Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control)
PartChromePadding	Pobiera lub ustawia odległość między zawartością WebPart kontrolki a obramowaniem kontrolki. (Odziedziczone po WebZone)
PartChromeStyle	Pobiera cechy stylu, które mają zastosowanie do obramowań kontrolek składników Web Part zawartych w strefie. (Odziedziczone po WebZone)
PartChromeType	Pobiera lub ustawia typ obramowania, który zawiera kontrolki serwera zawarte w kontrolce ConnectionsZone .
PartStyle	Pobiera charakterystykę stylu, która ma zastosowanie do obramowania i zawartości każdej kontrolki składników Web Part zawartych w strefie. (Odziedziczone po WebZone)
PartTitleStyle	Pobiera atrybuty stylu dla zawartości paska tytułu dla każdej kontrolki składników Web Part zawartej w strefie. (Odziedziczone po WebZone)
ProvidersInstructionText	Pobiera lub ustawia tekst instrukcji wyświetlany w sekcji dostawców interfejsu użytkownika połączenia, gdy połączenie już istnieje.
ProvidersTitle	Pobiera lub ustawia tytuł wyświetlany powyżej sekcji dostawców interfejsu użytkownika połączenia, gdy połączenie już istnieje.
RenderClientScript	Pobiera wartość wskazującą, czy skrypt klienta ma być renderowany na stronie składników Web Part. (Odziedziczone po WebZone)
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
SendText	Pobiera lub ustawia tekst wyświetlany w sekcji interfejsu użytkownika połączenia, który poprzedza nazwanego dostawcę, który będzie wysyłać dane do konsumenta.
SendToText	Pobiera lub ustawia tekst wyświetlany w sekcji interfejsu użytkownika połączenia, który poprzedza nazwanego konsumenta, do którego dostawca będzie wysyłać dane.
Site	Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera lub ustawia skórę do zastosowania w kontrolce. (Odziedziczone po WebControl)
Style	Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu w zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl)
SupportsDisabledAttribute	Pobiera wartość wskazującą, czy kontrolka powinna ustawić disabled atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled ma wartość false. (Odziedziczone po CompositeControl)
TabIndex	Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl)
TagKey	Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontrolce serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebZone)
TagName	Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
ToolTip	Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl)
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
VerbButtonType	Pobiera lub ustawia rodzaj przycisku używanego do reprezentowania czasowników w strefie. (Odziedziczone po WebZone)
VerbStyle	Pobiera atrybuty stylu dla czasowników interfejsu użytkownika skojarzonych z kontrolkami składników Web Part w strefie. (Odziedziczone po WebZone)
ViewState	Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako element interfejsu użytkownika na stronie. (Odziedziczone po ToolZone)
WebPartManager	Pobiera odwołanie do kontrolki WebPartManager skojarzonej z wystąpieniem WebZone kontrolki na stronie składników Web Part. (Odziedziczone po WebZone)
WebPartToConnect	Pobiera aktualnie wybraną WebPart kontrolkę do nawiązania połączenia.
Width	Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)	Dodaje atrybuty i style HTML, które należy renderować do określonego HtmlTextWriterTagelementu . Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
AddedControl(Control, Int32)	Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control)
AddParsedSubObject(Object)	Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control)
ApplyStyle(Style)	Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control)
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control)
ClearCachedClientID()	Ustawia wartość buforowanej ClientID na nullwartość . (Odziedziczone po Control)
ClearChildControlState()	Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildState()	Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control)
Close()	Zamyka interfejs użytkownika połączenia utworzony przez kontrolkę ConnectionsZone .
CopyBaseAttributes(WebControl)	Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CreateChildControls()	Tworzy wszystkie kontrolki podrzędne zawarte w kontrolce ConnectionsZone w ramach przygotowania do publikowania z powrotem na serwerze lub renderowaniu.
CreateControlCollection()	Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera. (Odziedziczone po Control)
CreateControlStyle()	Tworzy obiekt stylu używany wewnętrznie przez klasę WebControl do implementowania wszystkich właściwości pokrewnych stylu. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
DataBind()	Wiąże źródło danych ze wszystkimi CompositeControl kontrolkami podrzędnymi i . (Odziedziczone po CompositeControl)
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control)
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control)
Dispose()	Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)	Kończy śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control)
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control)
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru. (Odziedziczone po Control)
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody . (Odziedziczone po Control)
Focus()	Ustawia fokus danych wejściowych na kontrolkę. (Odziedziczone po Control)
GetDesignModeState()	Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
GetEffectiveChromeType(Part)	Zwraca rzeczywistą lub obowiązującą bieżącą PartChromeTypeWebPart wartość kontrolki, biorąc pod uwagę PartChromeType właściwość strefy i bieżący tryb wyświetlania strony składników Web Part. (Odziedziczone po WebZone)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control)
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control)
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control)
IsLiteralContent()	Określa, czy kontrolka serwera przechowuje tylko zawartość literału. (Odziedziczone po Control)
LoadControlState(Object)	Przywraca informacje o stanie sterowania z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() .
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MergeStyle(Style)	Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control)
OnDataBinding(EventArgs)	DataBinding Zgłasza zdarzenie. (Odziedziczone po Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	DisplayModeChanged Zgłasza zdarzenie.
OnInit(EventArgs)	Init Zgłasza zdarzenie.
OnLoad(EventArgs)	Load Zgłasza zdarzenie. (Odziedziczone po Control)
OnPreRender(EventArgs)	PreRender Zgłasza zdarzenie. (Odziedziczone po WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	SelectedWebPartChanged Zgłasza zdarzenie.
OnUnload(EventArgs)	Unload Zgłasza zdarzenie. (Odziedziczone po Control)
OpenFile(String)	Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control)
RaisePostBackEvent(String)	Zgłasza zdarzenie dla kontrolki ConnectionsZone , gdy formularz zawierający go publikuje z powrotem na serwerze.
RecreateChildControls()	Odtwarza kontrolki podrzędne w kontrolce pochodzącej z CompositeControlelementu . (Odziedziczone po CompositeControl)
RemovedControl(Control)	Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control)
Render(HtmlTextWriter)	Renderuje zawartość kontrolki ConnectionsZone do określonego HtmlTextWriter obiektu.
RenderBeginTag(HtmlTextWriter)	Renderuje otwierający tag HTML kontrolki strefy do określonego HtmlTextWriter obiektu. (Odziedziczone po WebZone)
RenderBody(HtmlTextWriter)	Wysyła zawartość ConnectionsZone obszaru treści kontrolki do określonego HtmlTextWriter obiektu, który zapisuje zawartość na stronie sieci Web.
RenderChildren(HtmlTextWriter)	Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderContents(HtmlTextWriter)	Renderuje całą zawartość kontrolki strefy między znacznikami początkowymi i końcowymi określonego HtmlTextWriter obiektu. (Odziedziczone po WebZone)
RenderControl(HtmlTextWriter)	Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)	Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
RenderFooter(HtmlTextWriter)	Zastępuje metodę podstawową w celu renderowania czasowników w stopce kontrolki ToolZone . (Odziedziczone po ToolZone)
RenderHeader(HtmlTextWriter)	Zastępuje metodę podstawową w celu zapewnienia wyspecjalizowanego renderowania dla obszaru nagłówka wymaganego przez ToolZone kontrolki. (Odziedziczone po ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Renderuje pojedyncze zlecenie z kontrolką ToolZone . (Odziedziczone po ToolZone)
RenderVerbs(HtmlTextWriter)	Renderuje czasowniki na poziomie strefy dla kontrolki ConnectionsZone .
ResolveAdapter()	Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control)
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control)
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control)
SaveControlState()	Zapisuje zmiany stanu kontrolek składników Web Part, które wystąpiły od czasu ostatniego opublikowania strony z powrotem na serwerze.
SaveViewState()	ConnectionsZone Zapisuje zmiany stanu widoku kontrolki, które wystąpiły od czasu ostatniego opublikowania strony z powrotem na serwerze.
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej. (Odziedziczone po Control)
SetTraceData(Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Śledzi zmiany stanu widoku w kontrolce ConnectionsZone , aby zmiany mogły być przechowywane w obiekcie kontrolki StateBag .

Zdarzenia

DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
Disposed	Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET. (Odziedziczone po Control)
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)	Pobiera atrybut kontrolki sieci Web o określonej nazwie. (Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)	Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Umożliwia projektantowi ponowne utworzenie kolekcji kontrolek podrzędnych kontrolki złożonej w środowisku czasu projektowania. (Odziedziczone po CompositeControl)
IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego członka, zobacz ControlBuilder. (Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego członka, zobacz SetOwnerControl(Control). (Odziedziczone po Control)
IControlDesignerAccessor.UserData	Aby uzyskać opis tego członka, zobacz UserData. (Odziedziczone po Control)
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego członka, zobacz DataBindings. (Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego członka, zobacz HasDataBindings. (Odziedziczone po Control)
IExpressionsAccessor.Expressions	Aby uzyskać opis tego członka, zobacz Expressions. (Odziedziczone po Control)
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego członka, zobacz HasExpressions. (Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego członka, zobacz AddParsedSubObject(Object). (Odziedziczone po Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementuje metodę RaisePostBackEvent(String) . (Odziedziczone po ToolZone)

Metody rozszerzania

FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.
GetDefaultValues(INamingContainer)	Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych.
GetMetaTable(INamingContainer)	Pobiera metadane tabeli dla określonej kontrolki danych.
SetMetaTable(INamingContainer, MetaTable)	Ustawia metadane tabeli dla określonej kontrolki danych.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych.
SetMetaTable(INamingContainer, MetaTable, Object)	Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych.
TryGetMetaTable(INamingContainer, MetaTable)	Określa, czy metadane tabeli są dostępne.
EnableDynamicData(INamingContainer, Type)	Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.
EnableDynamicData(INamingContainer, Type, Object)	Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.

Zobacz też

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• kontrolki składników Web Part ASP.NET
• Omówienie połączeń składników Web Part