ConnectionsZone Classe

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Fournit une interface utilisateur qui permet aux utilisateurs d’établir des connexions entre WebPart et d’autres contrôles serveur qui résident dans des zones WebPartZoneBase.

public ref class ConnectionsZone : System::Web::UI::WebControls::WebParts::ToolZone

public class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZone

type ConnectionsZone = class
    inherit ToolZone

Public Class ConnectionsZone
Inherits ToolZone

Héritage

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Exemples

L’exemple de code suivant montre comment utiliser le ConnectionsZone contrôle sur une page de composants WebPart. L’exemple comporte quatre parties :

• Contrôle utilisateur qui vous permet de changer de mode d’affichage sur la page Web.

• Fichier source qui contient le code d’une interface de code postal et deux WebPart contrôles agissant en tant que fournisseur et consommateur pour une connexion.

• Une page Web qui héberge tous les contrôles, montre comment déclarer un <asp:connectionszone> élément et définit un certain nombre de propriétés sur la zone de connexions de manière déclarative et programmatique.

• Explication du fonctionnement de l’exemple dans un navigateur.

La première partie de cet exemple de code est le contrôle utilisateur qui permet aux utilisateurs de changer de mode d’affichage sur une page Web. Pour plus d’informations sur les modes d’affichage et une description du code source dans ce contrôle, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.

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

La deuxième partie de l’exemple est le fichier source avec l’interface et les contrôles personnalisés. Notez que le ZipCodeWebPart contrôle implémente l’interface IZipCode , en ajoutant un ConnectionProvider attribut afin que le contrôle puisse agir en tant que fournisseur pour une connexion. Le WeatherWebPart contrôle a une méthode marquée avec un ConnectionConsumer attribut, où il consomme l’interface IZipCode , de sorte qu’il peut agir en tant que consommateur dans une connexion.

Pour que l’exemple de code s’exécute, vous devez compiler ce code source. Vous pouvez le compiler explicitement et placer l’assembly résultant dans le dossier Bin de votre site web ou dans le Global Assembly Cache. Vous pouvez également placer le code source dans le dossier App_Code de votre site, où il sera compilé dynamiquement au moment de l’exécution. Cet exemple utilise la compilation dynamique. Pour obtenir une procédure pas à pas qui montre comment compiler, consultez Procédure pas à pas : développement et utilisation d’un contrôle serveur Web personnalisé.

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

La troisième partie de l’exemple de code est la page Web. Près de la partie supérieure se trouvent Register des directives pour le contrôle utilisateur et les contrôles personnalisés utilisés dans la connexion. Un <asp:connectionszone> élément est déclaré dans la page en tant qu’exemple d’utilisation du ConnectionsZone contrôle de manière déclarative. Dans l’élément, un certain nombre de propriétés sont définies de manière déclarative. Les autres propriétés de la zone connexions sont définies par programmation dans la <script> section de la 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>

Chargez la page Web dans un navigateur. Utilisez le contrôle de liste déroulante Mode d’affichage pour basculer la page en mode connexion. Dans le menu verbes du contrôle Fournisseur de code postal (le menu verbes est indiqué par la flèche vers le bas dans la barre de titre du contrôle), cliquez sur le verbe connecter. Un ConnectionsZone contrôle s’affiche. Notez que dans l’interface utilisateur de la connexion, un bouton Terminer la connexion s’affiche ; la connexion a déjà été déclarée dans le balisage de la page, de sorte que les contrôles sont déjà connectés. Cliquez sur Terminer la connexion, puis utilisez à nouveau le contrôle Mode d’affichage pour retourner la page en mode de navigation. Ensuite, retournez la page en mode connexion, cliquez sur le verbe de connexion sur l’un des contrôles et notez que l’interface utilisateur de connexion affiche désormais un lien hypertexte qui vous permet de former une connexion entre les contrôles. Cliquez sur le lien et utilisez l’interface utilisateur de connexion pour sélectionner des points de connexion et établir la connexion.

Remarques

À l’aide du jeu de contrôles WebPart, vous pouvez autoriser deux contrôles serveur à former une connexion et à partager des données, avec un contrôle agissant en tant que fournisseur et l’autre en tant que consommateur des données. Les deux contrôles peuvent être WebPart des contrôles ou tout autre type de contrôle serveur, à condition qu’ils soient conçus pour gérer les connexions et qu’ils résident dans une WebPartZoneBase zone. Pour en savoir plus sur les connexions de composants WebPart, consultez les vues d’ensemble de la WebPartConnection classe et ConnectionPoint ainsi que Vue d’ensemble des connexions WebPart.

Si les contrôles et conditions nécessaires existent pour former une connexion de composants WebPart, il est toujours nécessaire de connecter réellement les contrôles. Il existe trois façons de créer une connexion entre les contrôles serveur : déclarer une connexion dans une page Web, créer une connexion dans le code ou ajouter un ConnectionsZone contrôle à la page afin que les utilisateurs puissent connecter les contrôles à la demande. Le ConnectionsZone contrôle génère une interface utilisateur qui permet aux utilisateurs de se connecter ou de déconnecter tous les contrôles serveur sur une page qui remplissent les conditions nécessaires pour établir une connexion. Il s’agit d’un contrôle facultatif qui n’est pas nécessaire pour établir des connexions, mais qui est utile dans le cas où vous souhaitez donner aux utilisateurs le contrôle sur les contrôles serveur qui sont connectés ou déconnectés.

Le ConnectionsZone contrôle est l’un des contrôles de zone d’outil WebPart qui héritent de la ToolZone classe de base. En tant que zone d’outils, le ConnectionsZone contrôle est conçu pour être visible uniquement lorsque sa page Web est en mode d’affichage spécifique. Dans ce cas, le mode d’affichage est nommé mode de connexion (une page est dans ce mode lorsque la valeur de propriété DisplayMode du WebPartManager contrôle de la page est définie ConnectDisplayModesur ). Une fois que les utilisateurs basculent une page en mode connexion, ils doivent cliquer sur un verbe de connexion dans le menu verbes de l’un des contrôles serveur, puis l’interface utilisateur de connexion devient visible.

En tant que contrôle de zone WebPart, le ConnectionsZone contrôle est un type de WebZone zone (qui hérite de la CompositeControl classe ) conçu pour contenir d’autres contrôles. En général, une ConnectionsZone zone a la plupart des mêmes éléments que d’autres zones d’outil WebPart : un en-tête, une zone de corps ou de contenu et un pied de page. Pour une présentation complète de ce qu’est une zone de composants WebPart et des différentes parties d’une zone, consultez la vue d’ensemble de la WebZone classe.

Important

Contrairement à la plupart des autres zones de composants WebPart, il est important de noter qu’une ConnectionsZone zone ne contient pas de type unique de contrôle serveur qui lui est associé. Pour obtenir la liste des zones et les contrôles associés qu’elles contiennent, consultez le graphique dans la vue d’ensemble de la WebZone classe. Mais la ConnectionsZone zone ne contient pas de WebPartConnection contrôles. Au lieu de cela, il sert un objectif très limité de fournir une interface utilisateur pour permettre aux utilisateurs de connecter ou de déconnecter des contrôles serveur qui existent dans une WebPartZoneBase zone de la page. Les seuls contrôles contenus dans un ConnectionsZone contrôle sont les contrôles standard ASP.NET serveur qu’il génère dans le cadre de son interface utilisateur pour former des connexions.

Lorsque le ConnectionsZone contrôle est rendu, il génère une interface utilisateur basée sur les contrôles serveur de la page qui sont capables de former des connexions. Le ConnectionsZone contrôle détermine quels contrôles serveur dans la WebPartZoneBase zone sur la page sont des fournisseurs, qui sont des consommateurs, quels points de connexion sont disponibles, et si les contrôles serveur sont actuellement connectés ou déconnectés, puis il génère l’interface utilisateur en conséquence.

Par exemple, supposons qu’il existe un WebPart contrôle capable d’être un fournisseur, un WebPart contrôle capable d’être un consommateur, qu’ils sont déclarés dans un WebPartZone sur la page et qu’ils sont actuellement déconnectés. Lorsqu’un utilisateur bascule la page en mode connexion et clique sur le verbe de connexion sur l’un des contrôles, le ConnectionsZone contrôle génère une interface utilisateur avec un lien qui, lorsqu’on clique dessus, affiche un formulaire dans lequel les utilisateurs peuvent choisir des options pour créer une connexion. (Si les contrôles étaient précédemment connectés, la vue initiale présente plutôt aux utilisateurs un bouton pour déconnecter les contrôles). Dans l’interface utilisateur de connexion pour la création de nouvelles connexions, les utilisateurs indiquent quel contrôle est un fournisseur et quel contrôle est un consommateur. Un contrôle de liste déroulante apparaît sous chaque contrôle serveur, répertoriant les objets disponibles ConnectionPoint pour le contrôle. Dans les listes déroulantes respectives, les utilisateurs doivent sélectionner un ProviderConnectionPoint objet pour le fournisseur (afin de déterminer l’interface et les données qui seront partagées avec les consommateurs) et un ConsumerConnectionPoint objet pour chaque consommateur (pour déterminer l’interface et les données que le consommateur utilisera) qui seront connectées au fournisseur.

Notes

Dans l’implémentation par défaut du jeu de contrôles WebPart, un fournisseur peut se connecter à de nombreux consommateurs, mais un consommateur ne peut avoir qu’un seul fournisseur.

Pour utiliser le ConnectionsZone contrôle, vous pouvez le déclarer dans l’élément <form> sur une page Web (mais pas imbriqué dans un autre élément de zone WebPart), à l’aide de l’élément <asp:connectionszone> , ou vous pouvez l’ajouter à la page par programmation. Si vous déclarez l’élément dans une page, contrairement aux autres zones de composants WebPart, vous ne pouvez pas déclarer d’autres types de contrôles serveur entre les balises de l’élément <asp:connectionszone> . Vous pouvez déclarer des éléments en son sein qui se rapportent à ses propres propriétés et détails de style, mais il s’agit d’un élément autonome et n’est pas un contrôle de modèle dans lequel d’autres contrôles serveur peuvent être déclarés.

Notes

Pour améliorer l’accessibilité, le ConnectionsZone contrôle est affiché dans un <fieldset> élément . L’élément <fieldset> regroupe l’ensemble de contrôles associé utilisé pour établir des connexions dans le contrôle, et facilite la ConnectionsZone navigation par onglets entre ces contrôles pour les agents utilisateur visuels (tels que les navigateurs Web ordinaires) et les agents utilisateur orientés voix (tels que les logiciels de lecture d’écran).

Le ConnectionsZone contrôle a un certain nombre de propriétés qu’il utilise pour afficher l’interface utilisateur de connexion. Un ensemble de propriétés comprend plusieurs verbes(utilisés uniquement par rapport aux connexions) qui effectuent des actions dans l’interface utilisateur : ConfigureVerb, ConnectVerbet DisconnectVerb. Un grand ensemble de propriétés, utilisé en particulier pour l’interface utilisateur de la zone de connexions, se compose de chaînes de texte affichées à différents emplacements (ou dans certaines situations, telles que lorsque des erreurs se produisent) dans l’interface utilisateur : ConfigureConnectionTitle, NoExistingConnectionTitleNoExistingConnectionInstructionTextConnectToConsumerInstructionTextConnectToConsumerTextConsumersTitleConsumersInstructionTextExistingConnectionErrorMessageConnectToProviderTitleGetFromTextConnectToProviderTextGetTextInstructionTitleConnectToProviderInstructionTextConnectToConsumerTitleProvidersInstructionTextProvidersTitleNewConnectionErrorMessageSendTextet .SendToText La ConnectionsZone classe contient également un certain nombre de propriétés communes trouvées dans d’autres zones de composants WebPart : CancelVerb, CloseVerb, DisplayEmptyZoneText, HeaderText, InstructionTextet PartChromeType. Enfin, la WebPartToConnect propriété est propre à la classe, en référençant le contrôle qui lance la connexion (il s’agit du contrôle sur lequel l’utilisateur clique sur le verbe de connexion dans son menu de verbes, qui est également le contrôle référencé dans la WebPartManager propriété du SelectedWebPart contrôle).

La ConnectionsZone classe a également un certain nombre de méthodes, qui sont toutes héritées et remplacées à partir des classes de base, et la plupart d’entre elles proviennent des classes de zone WebPart de base. Pour plus d’informations, consultez les méthodes individuelles.

Notes pour les héritiers

La ConnectionsZone classe peut être étendue si les développeurs souhaitent modifier son comportement ou l’interface utilisateur par défaut qu’elle fournit pour l’utilisation des connexions.

Constructeurs

ConnectionsZone()

Initialise une nouvelle instance de la classe ConnectionsZone.

Propriétés

AccessKey	Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl)
Adapter	Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control)
AssociatedDisplayModes	Obtient la collection d'objets WebPartDisplayMode qui sont associés à une zone ToolZone particulière. (Hérité de ToolZone)
Attributes	Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl)
BackColor	Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl)
BackImageUrl	Obtient ou définit l'URL vers une image d'arrière-plan pour une zone. (Hérité de WebZone)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
BorderColor	Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl)
BorderStyle	Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl)
BorderWidth	Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl)
CancelVerb	Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final d'annuler le processus d'établissement d'une connexion.
ChildControlsCreated	Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control)
CloseVerb	Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de fermer l'interface utilisateur de connexion créée par le contrôle ConnectionsZone.
ConfigureConnectionTitle	Obtient ou définit le texte affiché en tant que titre d'une sous-section de l'interface utilisateur de connexion créée par un contrôle ConnectionsZone.
ConfigureVerb	Apporte une référence à un objet WebPartVerb utilisé pour ouvrir l'affichage de configuration dans l'interface utilisateur de connexion.
ConnectToConsumerInstructionText	Obtient ou définit le texte d'instructions affiché dans la section de l'interface utilisateur de connexion où les utilisateurs sélectionnent un point de connexion consommateur auquel le fournisseur se connectera.
ConnectToConsumerText	Obtient ou définit le texte d'un lien hypertexte sur lequel les utilisateurs peuvent cliquer pour ouvrir une vue dans laquelle ils peuvent choisir un contrôle consommateur pour une connexion.
ConnectToConsumerTitle	Obtient ou définit le texte du titre de la section dans l'interface utilisateur de connexion dans laquelle les utilisateurs peuvent sélectionner un consommateur spécifique auquel se connecter.
ConnectToProviderInstructionText	Obtient ou définit le texte d'instructions affiché dans la section de l'interface utilisateur de connexion où les utilisateurs sélectionnent un point de connexion fournisseur auquel le consommateur se connectera.
ConnectToProviderText	Obtient ou définit le texte d'un lien hypertexte sur lequel les utilisateurs peuvent cliquer pour ouvrir une vue dans laquelle ils peuvent choisir un contrôle fournisseur pour une connexion.
ConnectToProviderTitle	Obtient ou définit le texte du titre de la section dans l'interface utilisateur de connexion dans laquelle les utilisateurs peuvent sélectionner un fournisseur spécifique auquel se connecter.
ConnectVerb	Obtient une référence à un objet WebPartVerb qui permet à deux contrôles WebPart d'établir une connexion.
ConsumersInstructionText	Obtient ou définit le texte d'instructions affiché dans la section consommateurs de l'interface utilisateur de connexion, lorsqu'une connexion existe déjà.
ConsumersTitle	Obtient ou définit le titre affiché au-dessus de la section consommateurs de l'interface utilisateur de connexion, lorsqu'une connexion existe déjà.
Context	Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control)
Controls	Obtient un objet ControlCollection qui représente les contrôles enfants de CompositeControl. (Hérité de CompositeControl)
ControlStyle	Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItemContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control)
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control)
DisconnectVerb	Obtient une référence à un objet WebPartVerb qui permet à un utilisateur de déconnecter deux contrôles WebPart connectés.
Display	Obtient une valeur qui indique si un contrôle ToolZone est actuellement affiché.
EditUIStyle	Obtient les attributs de style pour les contrôles modifiables contenus dans un contrôle ToolZone. (Hérité de ToolZone)
EmptyZoneText	Obtient ou définit un message texte qui est affiché dans un contrôle ConnectionsZone vide si le nombre de contrôles sur une page Web est insuffisant pour établir une connexion.
EmptyZoneTextStyle	Obtient les attributs de style pour le texte d'espace réservé dans une zone vide. (Hérité de WebZone)
Enabled	Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
ErrorStyle	Obtient les attributs de style pour restituer le message d'erreur qui est affiché si un contrôle WebPart ne peut pas être chargé ou créé. (Hérité de WebZone)
Events	Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control)
ExistingConnectionErrorMessage	Obtient ou définit le texte d'un message affiché dans l'interface utilisateur de connexion lorsqu'une erreur ou un avertissement se produisent sur une connexion existante.
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
FooterStyle	Obtient les attributs de style pour le contenu de la zone de pied de page d'une zone. (Hérité de WebZone)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl)
GetFromText	Obtient ou définit le texte affiché dans la section de l'interface utilisateur de connexion qui précède le fournisseur nommé duquel un consommateur récupérera des données.
GetText	Obtient ou définit le texte affiché dans la section de l'interface utilisateur de connexion qui précède le consommateur nommé qui recevra des données d'un fournisseur.
HasAttributes	Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control)
HasFooter	Obtient une valeur indiquant si une zone a une zone de pied de page. (Hérité de WebZone)
HasHeader	Obtient une valeur indiquant si une zone a une zone d'en-tête. (Hérité de WebZone)
HeaderCloseVerb	Obtient une référence à l'objet WebPartVerb dans l'en-tête d'un contrôle ToolZone qui est utilisé pour fermer le contrôle. (Hérité de ToolZone)
HeaderStyle	Obtient les attributs de style pour le contenu de la zone d'en-tête d'une zone. (Hérité de WebZone)
HeaderText	Obtient ou définit le texte d'en-tête qui apparaît en haut de l'interface utilisateur de connexion créé par le contrôle ConnectionsZone.
HeaderVerbStyle	Obtient les attributs de style pour tous les verbes d'en-tête affichés dans un contrôle ToolZone. (Hérité de ToolZone)
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
ID	Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control)
InstructionText	Obtient ou définit le texte qui est utilisé pour les instructions générales à propos du contrôle sélectionné dans la section de l'interface utilisateur de connexion pour gérer des connexions existantes.
InstructionTextStyle	Obtient les attributs de style pour le texte d'instruction qui apparaît en haut d'un contrôle ToolZone. (Hérité de ToolZone)
InstructionTitle	Obtient ou définit le texte qui est utilisé pour une description générale de l'action qui peut être exécutée sur le contrôle consommateur ou fournisseur, dans l'interface utilisateur de connexion pour gérer des connexions existantes.
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control)
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control)
IsViewStateEnabled	Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control)
LabelStyle	Obtient les attributs de style pour le contenu des étiquettes qui apparaissent avec les contrôles d'édition dans un contrôle ToolZone. Les contrôles ToolZone dérivés, tels que CatalogZone et EditorZone, appliquent les styles aux étiquettes. (Hérité de ToolZone)
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control)
NamingContainer	Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control)
NewConnectionErrorMessage	Obtient ou définit le texte d'un message affiché dans l'interface utilisateur de connexion lorsqu'une erreur ou un avertissement se produisent sur une connexion qu'un utilisateur essaie de créer.
NoExistingConnectionInstructionText	Obtient ou définit le texte d'instruction qui apparaît dans le corps de l'interface utilisateur de connexion lorsqu'un contrôle WebPart ne possède aucune connexion existante.
NoExistingConnectionTitle	Obtient ou définit le texte de titre qui apparaît dans le corps de l'interface utilisateur de connexion lorsqu'un contrôle WebPart ne possède aucune connexion existante.
Padding	Obtient ou définit les attributs de marge intérieure des cellules sur la table qui contient les contrôles WebPart dans une zone. (Hérité de WebZone)
Page	Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control)
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control)
PartChromePadding	Obtient ou définit la distance entre le contenu d'un contrôle WebPart et la bordure du contrôle. (Hérité de WebZone)
PartChromeStyle	Obtient des caractéristiques de style qui s'appliquent aux bordures des contrôles WebPart contenus dans une zone. (Hérité de WebZone)
PartChromeType	Obtient ou définit le type de bordure qui encadre les contrôles serveur contenus dans un contrôle ConnectionsZone.
PartStyle	Obtient des caractéristiques de style qui s'appliquent à la bordure et au contenu de chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone)
PartTitleStyle	Obtient des attributs de style pour le contenu de la barre de titre de chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone)
ProvidersInstructionText	Obtient ou définit le texte d'instructions affiché dans la section fournisseurs de l'interface utilisateur de connexion, lorsqu'une connexion existe déjà.
ProvidersTitle	Obtient ou définit le titre affiché au-dessus de la section fournisseurs de l'interface utilisateur de connexion, lorsqu'une connexion existe déjà.
RenderClientScript	Obtient une valeur indiquant s'il faut restituer le script client sur une page WebPart. (Hérité de WebZone)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control)
SendText	Obtient ou définit le texte affiché dans la section de l'interface utilisateur de connexion qui précède le fournisseur nommé qui enverra des données à un consommateur.
SendToText	Obtient ou définit le texte affiché dans la section de l'interface utilisateur de connexion qui précède le consommateur nommé auquel un fournisseur enverra des données.
Site	Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control)
SkinID	Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl)
SupportsDisabledAttribute	Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false. (Hérité de CompositeControl)
TabIndex	Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl)
TagKey	Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebZone)
TagName	Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control)
ToolTip	Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control)
VerbButtonType	Obtient ou définit le genre de bouton utilisé pour représenter des verbes dans une zone. (Hérité de WebZone)
VerbStyle	Obtient les attributs de style pour les verbes d'interface utilisateur associés aux contrôles WebPart dans une zone. (Hérité de WebZone)
ViewState	Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control)
ViewStateMode	Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control)
Visible	Obtient ou définit une valeur indiquant si un contrôle serveur est rendu sous la forme d'un élément d'interface utilisateur sur la page. (Hérité de ToolZone)
WebPartManager	Obtient une référence au contrôle WebPartManager associé à une instance de contrôle WebZone sur une page WebPart. (Hérité de WebZone)
WebPartToConnect	Obtient le contrôle WebPart actuellement sélectionné auquel se connecter.
Width	Obtient ou définit la largeur du contrôle serveur web. (Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
AddedControl(Control, Int32)	Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control)
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le traçage au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control)
ClearChildControlState()	Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control)
Close()	Ferme l'interface utilisateur de connexion créée par le contrôle ConnectionsZone.
CopyBaseAttributes(WebControl)	Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
CreateChildControls()	Crée tous les contrôles enfants contenus dans un contrôle ConnectionsZone en préparation pour la publication vers un serveur ou pour l'affichage.
CreateControlCollection()	Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control)
CreateControlStyle()	Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
DataBind()	Lie une source de données au CompositeControl et à tous ses contrôles enfants. (Hérité de CompositeControl)
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control)
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control)
Dispose()	Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au traçage au moment du design des données de rendu. (Hérité de Control)
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control)
EnsureID()	Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindControl(String)	Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control)
FindControl(String, Int32)	Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control)
Focus()	Affecte le focus d'entrée à un contrôle. (Hérité de Control)
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetEffectiveChromeType(Part)	Retourne la valeur PartChromeType actuelle réelle ou effective d'un contrôle WebPart, étant donné la propriété PartChromeType de la zone et le mode d'affichage actuel de la page WebPart. (Hérité de WebZone)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().
LoadViewState(Object)	Restaure les informations d’état d’affichage d’une précédente requête de page enregistrées par la méthode SaveViewState().
MapPathSecure(String)	Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control)
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Déclenche l’événement DisplayModeChanged.
OnInit(EventArgs)	Déclenche l’événement Init.
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l’événement PreRender. (Hérité de WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Déclenche l’événement SelectedWebPartChanged.
OnUnload(EventArgs)	Déclenche l’événement Unload. (Hérité de Control)
OpenFile(String)	Obtient un Stream utilisé pour lire un fichier. (Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)	Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control)
RaisePostBackEvent(String)	Déclenche un événement pour le contrôle ConnectionsZone lorsque le formulaire qui le contient publie au serveur.
RecreateChildControls()	Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl)
RemovedControl(Control)	Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control)
Render(HtmlTextWriter)	Génère le rendu du contenu du contrôle ConnectionsZone via l'objet HtmlTextWriter spécifié.
RenderBeginTag(HtmlTextWriter)	Génère le rendu de la balise d'ouverture HTML du contrôle de zone via l'objet HtmlTextWriter spécifié. (Hérité de WebZone)
RenderBody(HtmlTextWriter)	Envoie le contenu d'un corps de contrôle ConnectionsZone à l'objet HtmlTextWriter spécifié qui écrit le contenu dans la page Web.
RenderChildren(HtmlTextWriter)	Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Génère le rendu de tout le contenu d'un contrôle de zone entre les balises de début et de fin à l'objet via HtmlTextWriter spécifié. (Hérité de WebZone)
RenderControl(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control)
RenderEndTag(HtmlTextWriter)	Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
RenderFooter(HtmlTextWriter)	Substitue la méthode de base pour restituer des verbes dans le pied de page d'un contrôle ToolZone. (Hérité de ToolZone)
RenderHeader(HtmlTextWriter)	Substitue la méthode de base pour fournir le rendu spécialisé pour la zone d'en-tête requis par les contrôles ToolZone. (Hérité de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Génère le rendu d'un verbe individuel avec un contrôle ToolZone. (Hérité de ToolZone)
RenderVerbs(HtmlTextWriter)	Génère le rendu des verbes de niveau de zone pour un contrôle ConnectionsZone.
ResolveAdapter()	Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control)
SaveControlState()	Enregistre les modifications apportées à l'état du contrôle WebPart depuis la dernière publication de la page sur le serveur.
SaveViewState()	Enregistre les modifications apportées à l'état d'affichage d'un contrôle ConnectionsZone depuis la dernière publication de la page sur le serveur.
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TrackViewState()	Suit les modifications d'état d'affichage apportées au contrôle ConnectionsZone afin que les modifications puissent être stockées dans l'objet StateBag du contrôle.

Événements

DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Disposed	Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control)
Init	Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control)
Load	Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control)
PreRender	Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control)
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permet à un concepteur de recréer dans l'environnement au moment du design la collection du contrôle composite de contrôles enfants. (Hérité de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implémente la méthode RaisePostBackEvent(String). (Hérité de ToolZone)

Méthodes d’extension

FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l'objet Metatable pour le contrôle de données conteneur.
GetDefaultValues(INamingContainer)	Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.
GetMetaTable(INamingContainer)	Obtient les métadonnées de table pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable)	Définit les métadonnées de table pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, Object)	Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.
TryGetMetaTable(INamingContainer, MetaTable)	Détermine si des métadonnées de table sont disponibles.
EnableDynamicData(INamingContainer, Type)	Active le comportement Dynamic Data pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Active le comportement Dynamic Data pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, Object)	Active le comportement Dynamic Data pour le contrôle de données spécifié.

Voir aussi

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• contrôles webPart ASP.NET
• Vue d’ensemble des connexions webPart