ConnectionsZone Classe

Definizione

Fornisce un'interfaccia utente che consente agli utenti di creare connessioni tra WebPart e altri controlli server che si trovano all'interno di zone WebPartZoneBase.Provides a user interface (UI) that enables users to form connections between WebPart and other server controls that reside in WebPartZoneBase zones.

public ref class ConnectionsZone : System::Web::UI::WebControls::WebParts::ToolZone
public class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZone
type ConnectionsZone = class
    inherit ToolZone
Public Class ConnectionsZone
Inherits ToolZone
Ereditarietà

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il controllo ConnectionsZone in una pagina di Web part.The following code example demonstrates how to use the ConnectionsZone control on a Web Parts page. L'esempio è costituito da quattro parti:The example has four parts:

  • Controllo utente che consente di passare dalla modalità di visualizzazione alla pagina Web.A user control that enables you to switch display modes on the Web page.

  • Un file di origine che contiene il codice per un'interfaccia di codice postale e due WebPart controlli che agiscono come provider e consumer per una connessione.A source file that contains the code for a ZIP Code interface, and two WebPart controls acting as the provider and the consumer for a connection.

  • Una pagina Web in cui sono ospitati tutti i controlli, viene illustrato come dichiarare un elemento <asp:connectionszone> e come impostare un certo numero di proprietà nella zona connessioni in modo dichiarativo e a livello di codice.A Web page that hosts all the controls, demonstrates how to declare an <asp:connectionszone> element, and sets a number of properties on the connections zone declaratively and programmatically.

  • Spiegazione del funzionamento dell'esempio in un browser.An explanation of how the example works in a browser.

La prima parte di questo esempio di codice è il controllo utente che consente agli utenti di cambiare modalità di visualizzazione in una pagina Web.The first part of this code example is the user control that enables users to switch display modes on a Web page. Per informazioni dettagliate sulle modalità di visualizzazione e una descrizione del codice sorgente in questo controllo, vedere procedura dettagliata: modifica delle modalità di visualizzazione in una pagina Web part.For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

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

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

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

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

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

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

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

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

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

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

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

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

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

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

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

  End Sub

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

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

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

  End Sub

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

La seconda parte dell'esempio è il file di origine con l'interfaccia e i controlli personalizzati.The second part of the example is the source file with the interface and custom controls. Si noti che il controllo ZipCodeWebPart implementa l'interfaccia IZipCode, aggiungendo un attributo ConnectionProvider in modo che il controllo possa fungere da provider per una connessione.Notice that the ZipCodeWebPart control implements the IZipCode interface, adding a ConnectionProvider attribute so that the control can act as a provider for a connection. Il controllo WeatherWebPart dispone di un metodo contrassegnato con un attributo ConnectionConsumer, in cui utilizza l'interfaccia IZipCode, in modo che possa fungere da consumer in una connessione.The WeatherWebPart control has a method marked with a ConnectionConsumer attribute, where it consumes the IZipCode interface, so it can act as a consumer in a connection.

Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente.For the code example to run, you must compile this source code. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella bin del sito Web o nel Global Assembly Cache.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilata dinamicamente in fase di esecuzione.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. In questo esempio viene utilizzata la compilazione dinamica.This example uses dynamic compilation. Per una procedura dettagliata in cui viene illustrato come compilare, vedere procedura dettagliata: sviluppo e utilizzo di un controllo server Web personalizzato.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code Provider", "ZipCodeProvider")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code Provider", "ZipCodeProvider")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
                DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

La terza parte del codice di esempio è la pagina Web.The third part of the example code is the Web page. Nella parte superiore sono Register direttive per il controllo utente e i controlli personalizzati utilizzati nella connessione.Near the top are Register directives for the user control and the custom controls used in the connection. Un elemento <asp:connectionszone> viene dichiarato nella pagina come esempio di utilizzo del controllo ConnectionsZone in modo dichiarativo.An <asp:connectionszone> element is declared in the page as an example of using the ConnectionsZone control declaratively. All'interno dell'elemento, un numero di proprietà viene impostato in modo dichiarativo.Within the element, a number of properties are set declaratively. Altre proprietà nella zona connessioni vengono impostate a livello di codice nella sezione <script> della pagina.Other properties on the connections zone are set programmatically in the <script> section of the page.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuCS"
    src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_PreRender(object sender, EventArgs e)
  {
     // Set properties on verbs.
     connectionsZone1.CancelVerb.Description = 
       "Terminates the connection process";
     connectionsZone1.CloseVerb.Description = 
       "Closes the connections UI";
     connectionsZone1.ConfigureVerb.Description =
       "Configure the transformer for the connection";
     connectionsZone1.ConnectVerb.Description =
       "Connect two WebPart controls";
     connectionsZone1.DisconnectVerb.Description =
       "End the connection between two controls";
    
     // Set properties for UI text strings.
     connectionsZone1.ConfigureConnectionTitle = 
       "Configure";
     connectionsZone1.ConnectToConsumerInstructionText = 
       "Choose a consumer connection point";
     connectionsZone1.ConnectToConsumerText = 
       "Select a consumer for the provider to connect with";
     connectionsZone1.ConnectToConsumerTitle = 
       "Send data to this consumer";
     connectionsZone1.ConnectToProviderInstructionText =
       "Choose a provider connection point";
     connectionsZone1.ConnectToProviderText =
       "Select a provider for the consumer to connect with";
     connectionsZone1.ConnectToProviderTitle =
       "Get data from this provider";
     connectionsZone1.ConsumersInstructionText = 
       "WebPart controls that receive data from providers";
     connectionsZone1.ConsumersTitle = "Consumer Controls";
     connectionsZone1.GetFromText = "Receive from";
     connectionsZone1.GetText = "Retrieve";
     connectionsZone1.HeaderText = 
      "Create and Manage Connections";
     connectionsZone1.InstructionText = 
      "Manage connections for the selected WebPart control";
     connectionsZone1.InstructionTitle = 
       "Manage connections for consumers or providers";
     connectionsZone1.NoExistingConnectionInstructionText = 
       "No connections exist. Click the above link to create "
       + "a connection.";
     connectionsZone1.NoExistingConnectionTitle = 
       "No current connections";
     connectionsZone1.ProvidersInstructionText =
       "WebPart controls that send data to consumers";
     connectionsZone1.ProvidersTitle = "Provider controls";
     
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenucs id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider"  />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuVB"
    src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Set properties for verbs.
    connectionsZone1.CancelVerb.Description = _
      "Terminates the connection process"
    connectionsZone1.CloseVerb.Description = _
      "Closes the connections UI"
    connectionsZone1.ConfigureVerb.Description = _
      "Configure the transformer for the connection"
    connectionsZone1.ConnectVerb.Description = _
      "Connect two WebPart controls"
    connectionsZone1.DisconnectVerb.Description = _
      "End the connection between two controls"
    
    ' Set properties for UI text strings.
    connectionsZone1.ConfigureConnectionTitle = _
      "Configure a new connection"
    connectionsZone1.ConnectToConsumerInstructionText = _
      "Choose a consumer connection point"
    connectionsZone1.ConnectToConsumerText = _
      "Select a consumer for the provider to connect with"
    connectionsZone1.ConnectToConsumerTitle = _
      "Send data to this consumer"
    connectionsZone1.ConnectToProviderInstructionText = _
      "Choose a provider connection point"
    connectionsZone1.ConnectToProviderText = _
      "Select a provider for the consumer to connect with"
    connectionsZone1.ConnectToProviderTitle = _
      "Get data from this provider"
    connectionsZone1.ConsumersInstructionText = _
      "WebPart controls that receive data from providers"
    connectionsZone1.ConsumersTitle = "Consumer Controls"
    connectionsZone1.GetFromText = "Receive from"
    connectionsZone1.GetText = "Retrieve"
    connectionsZone1.HeaderText = _
      "Create and Manage Connections"
    connectionsZone1.InstructionText = _
      "Manage connections for the selected WebPart control"
    connectionsZone1.InstructionTitle = _
      "Manage connections for consumers or providers"
    connectionsZone1.NoExistingConnectionInstructionText = _
      "No connections exist. Click the above link to create " _
      & "a connection."
    connectionsZone1.NoExistingConnectionTitle = _
      "No current connections"
    connectionsZone1.ProvidersInstructionText = _
      "WebPart controls that send data to consumers"
    connectionsZone1.ProvidersTitle = "Provider controls"

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenuvb id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider" />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

Caricare la pagina Web in un browser.Load the Web page in a browser. Usare il controllo elenco a discesa modalità di visualizzazione per passare alla modalità di connessione della pagina.Use the Display Mode drop-down list control to switch the page to connect mode. Nel menu dei verbi del controllo del provider di codice postale (il menu dei verbi è indicato dalla freccia verso il basso nella barra del titolo del controllo), fare clic sul verbo di connessione.On the verbs menu of the ZIP Code Provider control (the verbs menu is indicated by the downward arrow in the control's title bar), click the connect verb. Viene visualizzato un controllo ConnectionsZone.A ConnectionsZone control appears. Si noti che nell'interfaccia utente della connessione viene visualizzato il pulsante Termina connessione . la connessione è già stata dichiarata nel markup della pagina, quindi i controlli sono già connessi.Note that in the connection UI, an End Connection button appears; the connection has already been declared in the markup of the page, so the controls are already connected. Fare clic su Termina connessione, quindi utilizzare di nuovo il controllo modalità di visualizzazione per tornare alla modalità Sfoglia della pagina.Click End Connection, and then use the Display Mode control again to return the page to browse mode. Quindi, riportare la pagina alla modalità di connessione, fare clic sul verbo Connect su uno dei controlli e notare che l'interfaccia utente della connessione ora Visualizza un collegamento ipertestuale che consente di creare una connessione tra i controlli.Next, return the page to connect mode again, click the connect verb on one of the controls, and note that the connection UI now displays a hyperlink that enables you to form a connection between the controls. Fare clic sul collegamento e utilizzare l'interfaccia utente di connessione per selezionare i punti di connessione e stabilire la connessione.Click the link, and use the connection UI to select connection points and establish the connection.

Commenti

Utilizzando il set di controllo Web part, è possibile abilitare due controlli server per formare una connessione e condividere i dati, con un controllo che funge da provider e l'altro che funge da consumer dei dati.Using the Web Parts control set, you can enable two server controls to form a connection and share data, with one control acting as the provider, and the other acting as the consumer of the data. I due controlli possono essere WebPart controlli o qualsiasi altro tipo di controllo server, purché siano progettati per gestire le connessioni e che si trovino in un'area WebPartZoneBase.The two controls can be WebPart controls or any other type of server control, provided that they are designed to handle connections, and that they are residing in a WebPartZoneBase zone. Per ulteriori informazioni sulle connessioni di Web part, vedere Cenni preliminarisulle classi WebPartConnection e ConnectionPoint, oltre a Web Part connessioni.To learn more about Web Parts connections, see the WebPartConnection and ConnectionPoint class overviews, as well as Web Parts Connections Overview.

A condizione che siano presenti i controlli e le condizioni necessari per formare una connessione Web part, è comunque necessario connettere effettivamente i controlli.Provided that the requisite controls and conditions exist to form a Web Parts connection, it is still necessary to actually connect the controls. Esistono tre modi per creare una connessione tra i controlli server: la dichiarazione di una connessione in una pagina Web, la creazione di una connessione nel codice o l'aggiunta di un controllo ConnectionsZone alla pagina in modo che gli utenti possano connettere i controlli su richiesta.There are three ways to form a connection between server controls: declaring a connection in a Web page, creating a connection in code, or adding a ConnectionsZone control to the page so that users can connect the controls on demand. Il controllo ConnectionsZone genera un'interfaccia utente che consente agli utenti di connettere o disconnettere i controlli server in una pagina che soddisfano le condizioni necessarie per creare una connessione.The ConnectionsZone control generates a UI that enables users to connect or disconnect any server controls on a page that meet the conditions necessary to form a connection. Si tratta di un controllo facoltativo che non è necessario per creare connessioni, ma è utile nel caso in cui si voglia concedere agli utenti il controllo sui controlli server connessi o disconnessi.It is an optional control that is not necessary to form connections, but is useful in the case where you want to give users control over which server controls are connected or disconnected.

Il controllo ConnectionsZone è uno dei controlli Web part area degli strumenti che ereditano dalla classe di base ToolZone.The ConnectionsZone control is one of the Web Parts tool zone controls that inherit from the ToolZone base class. Come area degli strumenti, il controllo ConnectionsZone è progettato per essere visibile solo quando la relativa pagina Web è in una determinata modalità di visualizzazione.As a tool zone, the ConnectionsZone control is designed to be visible only when its Web page is in a certain display mode. In questo caso, la modalità di visualizzazione è denominata modalità di connessione (una pagina è in questa modalità quando il WebPartManager controllo nella pagina ha il DisplayMode valore della proprietà impostato su ConnectDisplayMode).In this case, the display mode is named connect mode (a page is in this mode when the WebPartManager control on the page has its DisplayMode property value set to ConnectDisplayMode). Dopo che gli utenti hanno cambiato una pagina in modalità di connessione, devono fare clic su un verbo di connessione nel menu dei verbi di uno dei controlli server, quindi l'interfaccia utente di connessione diventa visibile.After users switch a page into connect mode, they must click a connect verb on the verbs menu of one of the server controls, and then the connection UI becomes visible.

Come controllo Web part zona, il controllo ConnectionsZone è un tipo di area di WebZone (che eredita dalla classe CompositeControl) progettata per contenere altri controlli.As a Web Parts zone control, the ConnectionsZone control is a type of WebZone zone (which inherits from the CompositeControl class) designed to contain other controls. In generale, una zona ConnectionsZone ha la maggior parte degli stessi elementi di altre Web part zone degli strumenti: un'intestazione, un'area del corpo o del contenuto e un piè di pagina.In general, a ConnectionsZone zone has most of the same elements as other Web Parts tool zones: a header, a body or contents area, and a footer. Per una descrizione completa dell'aspetto di una zona Web part e delle diverse parti di una zona, vedere la pagina relativa alla panoramica di WebZone classe.For a complete discussion of what a Web Parts zone is, and the different parts of a zone, see the WebZone class overview.

Importante

A differenza della maggior parte delle altre zone Web part, è importante notare che una zona ConnectionsZone non contiene un tipo univoco di controllo server associato.Unlike most other Web Parts zones, it is important to note that a ConnectionsZone zone does not contain a unique type of server control associated with it. Per un elenco delle zone e dei controlli associati che contengono, vedere il grafico nella panoramica della classe WebZone.For a list of zones and the associated controls they contain, see the chart in the WebZone class overview. Tuttavia, la zona ConnectionsZone non contiene controlli WebPartConnection.But the ConnectionsZone zone does not contain WebPartConnection controls. Viene invece utilizzato uno scopo molto limitato di fornire agli utenti un'interfaccia utente per la connessione o la disconnessione dei controlli server presenti in alcune WebPartZoneBase area della pagina.Instead, it serves a very limited purpose of providing a UI for users to connect or disconnect server controls that exist in some WebPartZoneBase zone on the page. Gli unici controlli contenuti in un controllo ConnectionsZone sono i controlli server ASP.NET standard che genera come parte dell'interfaccia utente per la creazione di connessioni.The only controls contained in a ConnectionsZone control are the standard ASP.NET server controls that it generates as part of its UI for forming connections.

Quando viene eseguito il rendering del controllo ConnectionsZone, viene generata un'interfaccia utente basata sui controlli server della pagina in grado di formare connessioni.When the ConnectionsZone control is rendered, it generates a UI based on the server controls on the page that are capable of forming connections. Il controllo ConnectionsZone determina quali controlli server nell'area WebPartZoneBase della pagina sono provider, ovvero consumer, quali punti di connessione sono disponibili e se i controlli server sono attualmente connessi o disconnessi, quindi genera l'interfaccia utente di conseguenza.The ConnectionsZone control determines which server controls in the WebPartZoneBase zone on the page are providers, which are consumers, which connection points are available, and whether the server controls are currently connected or disconnected, and then it generates the UI accordingly.

Si supponga, ad esempio, che sia presente un controllo WebPart in grado di essere un provider, che uno WebPart controllo in grado di essere un consumer, venga dichiarato in un WebPartZone nella pagina e sia attualmente disconnesso.For example, suppose there is one WebPart control capable of being a provider, one WebPart control capable of being a consumer, they are declared in a WebPartZone on the page, and they are currently disconnected. Quando un utente passa alla modalità di connessione e fa clic sul verbo di connessione su uno dei controlli, il controllo ConnectionsZone genera un'interfaccia utente con un collegamento che, se selezionato, Visualizza un modulo in cui gli utenti possono scegliere le opzioni per creare una connessione.When a user switches the page to connect mode and clicks the connect verb on one of the controls, the ConnectionsZone control generates a UI with a link that, when clicked, displays a form in which users can choose options to create a connection. Se i controlli erano connessi in precedenza, la visualizzazione iniziale presenta invece agli utenti un pulsante per disconnettere i controlli.(If the controls were previously connected, the initial view instead presents users with a button to disconnect the controls). Nell'interfaccia utente di connessione per la creazione di nuove connessioni, agli utenti viene mostrato quale controllo è un provider e quale controllo è un consumer.In the connection UI for creating new connections, users are shown which control is a provider, and which control is a consumer. Sotto ogni controllo server viene visualizzato un controllo elenco a discesa, che elenca gli oggetti ConnectionPoint disponibili per il controllo.A drop-down list control appears below each server control, listing the available ConnectionPoint objects for the control. Dagli elenchi a discesa rispettivi, gli utenti devono selezionare un oggetto ProviderConnectionPoint per il provider (per determinare l'interfaccia e i dati che verranno condivisi con i consumer) e un oggetto ConsumerConnectionPoint per ogni consumer (per determinare l'interfaccia e i dati che verranno utilizzati dal consumer) che saranno connessi al provider.From the respective drop-down lists, users must select one ProviderConnectionPoint object for the provider (to determine what interface and data will be shared with consumers), and one ConsumerConnectionPoint object for each consumer (to determine what interface and data the consumer will consume) that will be connected to the provider.

Nota

Nell'implementazione predefinita del set di controllo Web part, un provider può connettersi a molti consumer, ma un utente può avere un solo provider.In the Web Parts control set default implementation, one provider can connect to many consumers, but a consumer can have only one provider.

Per usare il controllo ConnectionsZone, è possibile dichiararlo all'interno dell'elemento <form> in una pagina Web, ma non annidato all'interno di un altro elemento Web part zone, usando l'elemento <asp:connectionszone> oppure è possibile aggiungerlo alla pagina a livello di codice.To use the ConnectionsZone control, you can declare it within the <form> element on a Web page (but not nested within another Web Parts zone element), using the <asp:connectionszone> element, or you can add it to the page programmatically. Se si dichiara l'elemento in una pagina, a differenza delle altre Web part zone, non è possibile dichiarare altri tipi di controlli server tra i tag dell'elemento <asp:connectionszone>.If you declare the element in a page, unlike the other Web Parts zones, you cannot declare any other type of server controls between the tags of the <asp:connectionszone> element. È possibile dichiarare elementi al suo interno correlati alle proprietà e ai dettagli di stile, ma è un elemento autonomo e non è un controllo del modello all'interno del quale possono essere dichiarati altri controlli server.You can declare elements within it that relate to its own properties and style details, but it is a standalone element and is not a template control within which other server controls can be declared.

Nota

Per migliorare l'accessibilità, il rendering del controllo ConnectionsZone viene eseguito all'interno di un elemento <fieldset>.To improve accessibility, the ConnectionsZone control is rendered within a <fieldset> element. L'elemento <fieldset> raggruppa il set correlato di controlli utilizzati per stabilire le connessioni nel controllo ConnectionsZone e facilita la navigazione a schede tra i controlli per gli agenti utente visivi (ad esempio, i Web browser ordinari) e gli agenti utente orientati alla voce, ad esempio il software per la lettura dello schermo.The <fieldset> element groups the related set of controls used for establishing connections in the ConnectionsZone control, and it facilitates tabbed navigation among those controls for both visual user agents (such as ordinary Web browsers) and speech-oriented user agents (such as screen-reading software).

Il controllo ConnectionsZone dispone di una serie di proprietà utilizzate per il rendering dell'interfaccia utente della connessione.The ConnectionsZone control has a number of properties it uses for rendering the connection UI. Un set di proprietà include diversi verbi, usati solo in relazione alle connessioni, che eseguono azioni nell'interfaccia utente: ConfigureVerb, ConnectVerbe DisconnectVerb.One set of properties includes several verbs--used only in relation to connections--that carry out actions in the UI: ConfigureVerb, ConnectVerb, and DisconnectVerb. Un ampio set di proprietà, usato in particolare per l'interfaccia utente della zona di connessione, è costituito da stringhe di testo visualizzate in varie posizioni (o in determinate situazioni, ad esempio quando si verificano errori) nell'interfaccia utente: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToConsumerText, ConnectToConsumerTitle, ConnectToProviderInstructionText, ConnectToProviderText, ConnectToProviderTitle, ConsumersInstructionText, ConsumersTitle, ExistingConnectionErrorMessage, GetFromText, GetText, InstructionTitle, NewConnectionErrorMessage, NoExistingConnectionInstructionText, NoExistingConnectionTitle, ProvidersInstructionText, ProvidersTitle, SendText, SendToTextA large set of properties, used especially for the connections zone UI, consists of text strings displayed at various places (or in certain situations, such as when errors occur) in the UI: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToConsumerText, ConnectToConsumerTitle, ConnectToProviderInstructionText, ConnectToProviderText, ConnectToProviderTitle, ConsumersInstructionText, ConsumersTitle, ExistingConnectionErrorMessage, GetFromText, GetText, InstructionTitle, NewConnectionErrorMessage, NoExistingConnectionInstructionText, NoExistingConnectionTitle, ProvidersInstructionText, ProvidersTitle, SendText, and SendToText. La classe ConnectionsZone contiene inoltre una serie di proprietà comuni presenti in altre aree Web part: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, InstructionTexte PartChromeType.The ConnectionsZone class also contains a number of common properties found in other Web Parts zones: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, InstructionText, and PartChromeType. Infine, la proprietà WebPartToConnect è univoca per la classe, facendo riferimento al controllo che avvia la connessione (si tratta del controllo su cui l'utente fa clic sul verbo di connessione nel menu dei verbi, che è anche il controllo a cui si fa riferimento nella proprietà SelectedWebPart del controllo WebPartManager).Finally, the WebPartToConnect property is unique to the class, referencing the control that initiates the connection (this is the control on which the user clicks the connect verb in its verbs menu, which is also the control referenced in the WebPartManager control's SelectedWebPart property).

La classe ConnectionsZone dispone inoltre di un numero di metodi, tutti ereditati e sottoposti a override dalle classi base e la maggior parte di essi provengono dalle classi di Web part di base.The ConnectionsZone class also has a number of methods, all of which are inherited and overridden from base classes, and most of them come from the base Web Parts zone classes. Per informazioni dettagliate, vedere i singoli metodi.For details, see the individual methods.

Note per gli eredi

È possibile estendere la classe ConnectionsZone se gli sviluppatori desiderano modificarne il comportamento o l'interfaccia utente predefinita che fornisce per l'utilizzo delle connessioni.The ConnectionsZone class can be extended, if developers want to change its behavior or the default UI that it provides for working with connections.

Costruttori

ConnectionsZone()

Inizializza una nuova istanza della classe ConnectionsZone.Initializes a new instance of the ConnectionsZone class.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Ereditato da WebControl)
Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(Ereditato da Control)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Ereditato da Control)
AssociatedDisplayModes

Ottiene l'insieme di oggetti WebPartDisplayMode associati a una particolare zona ToolZone.Gets the collection of WebPartDisplayMode objects that are associated with a particular ToolZone zone.

(Ereditato da ToolZone)
Attributes

Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.Gets or sets the background color of the Web server control.

(Ereditato da WebControl)
BackImageUrl

Ottiene o imposta l'URL di un'immagine di sfondo per una zona.Gets or sets the URL to a background image for a zone.

(Ereditato da WebZone)
BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.Gets or sets the border color of the Web control.

(Ereditato da WebControl)
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.Gets or sets the border style of the Web server control.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.Gets or sets the border width of the Web server control.

(Ereditato da WebControl)
CancelVerb

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di annullare il processo per stabilire una connessione.Gets a reference to a WebPartVerb object that enables end users to cancel the process of establishing a connection.

ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Ereditato da Control)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(Ereditato da Control)
CloseVerb

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di chiudere l'interfaccia utente di connessione creata dal controllo ConnectionsZone.Gets a reference to a WebPartVerb object that enables end users to close the connection user interface (UI) created by the ConnectionsZone control.

ConfigureConnectionTitle

Ottiene o imposta il testo visualizzato come titolo di una sottosezione dell'interfaccia utente di connessione creata da un controllo ConnectionsZone.Gets or sets the text displayed as the title of a subsection of the connection user interface (UI) created by a ConnectionsZone control.

ConfigureVerb

Ottiene un riferimento a un oggetto WebPartVerb utilizzato per aprire la visualizzazione configurazione nell'interfaccia utente di connessione.Gets a reference to a WebPartVerb object used to open the configuration view in the connection user interface (UI).

ConnectToConsumerInstructionText

Ottiene o imposta il testo informativo visualizzato nella sezione dell'interfaccia utente di connessione quando gli utenti selezionano un punto di connessione consumer a cui si connetterà il provider.Gets or sets the instructional text displayed in the section of the connection user interface (UI) where users select a consumer connection point that the provider will connect to.

ConnectToConsumerText

Ottiene o imposta il testo di un collegamento ipertestuale su cui gli utenti possono fare clic per aprire una visualizzazione in cui scegliere un controllo consumer per una connessione.Gets or sets the text of a hyperlink that users click to open a view in which they can choose a consumer control for a connection.

ConnectToConsumerTitle

Ottiene o imposta il testo del titolo della sezione dell'interfaccia utente di connessione in cui gli utenti possono selezionare un consumer specifico a cui connettersi.Gets or sets the title text of the section in the connection user interface (UI) in which users can select a specific consumer to connect with.

ConnectToProviderInstructionText

Ottiene o imposta il testo informativo visualizzato nella sezione dell'interfaccia utente di connessione quando gli utenti selezionano un punto di connessione provider a cui si connetterà il consumer.Gets or sets the instructional text displayed in the section of the connection user interface (UI) where users select a provider connection point that the consumer will connect to.

ConnectToProviderText

Ottiene o imposta il testo di un collegamento ipertestuale su cui gli utenti possono fare clic per aprire una visualizzazione in cui scegliere un controllo provider per una connessione.Gets or sets the text of a hyperlink that users click to open a view in which they can choose a provider control for a connection.

ConnectToProviderTitle

Ottiene o imposta il testo del titolo della sezione dell'interfaccia utente di connessione in cui gli utenti possono selezionare un provider specifico a cui connettersi.Gets or sets the title text of the section in the connection user interface (UI) in which users can select a specific provider to connect with.

ConnectVerb

Ottiene un riferimento a un oggetto WebPartVerb che consente a due controlli WebPart di stabilire una connessione.Gets a reference to a WebPartVerb object that enables two WebPart controls to establish a connection.

ConsumersInstructionText

Ottiene o imposta il testo informativo visualizzato nella sezione dei consumer dell'interfaccia utente di connessione quando è già disponibile una connessione.Gets or sets the instructional text shown in the consumers section of the connection user interface (UI), when a connection already exists.

ConsumersTitle

Ottiene o imposta il titolo visualizzato sopra la sezione dei consumer dell'interfaccia utente di connessione quando è già disponibile una connessione.Gets or sets the title shown above the consumers section of the connection user interface (UI), when a connection already exists.

Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl.Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Ereditato da CompositeControl)
ControlStyle

Ottiene lo stile del controllo server Web.Gets the style of the Web server control. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.This property is primarily used by control developers.

(Ereditato da WebControl)
CssClass

Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Ereditato da Control)
DisconnectVerb

Ottiene un riferimento a un oggetto WebPartVerb che consente a un utente di disconnettere due controlli WebPart connessi.Gets a reference to a WebPartVerb object that enables a user to disconnect two connected WebPart controls.

Display

Ottiene un valore che indica se il controllo ToolZone è o meno visualizzato.Gets a value that indicates whether a ToolZone control is currently displayed.

EditUIStyle

Ottiene gli attributi di stile per i controlli modificabili contenuti in un controllo ToolZone.Gets the style attributes for the editable controls contained in a ToolZone control.

(Ereditato da ToolZone)
EmptyZoneText

Ottiene o imposta un messaggio di testo visualizzato in un controllo ConnectionsZone vuoto se in una pagina Web non sono disponibili controlli sufficienti per stabilire una connessione.Gets or sets a text message that is displayed in an empty ConnectionsZone control if there are insufficient controls on a Web page to establish a connection.

EmptyZoneTextStyle

Ottiene gli attributi di stile per il testo segnaposto in una zona vuota.Gets the style attributes for the placeholder text in an empty zone.

(Ereditato da WebZone)
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.Gets or sets a value indicating whether the Web server control is enabled.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se al controllo vengono applicati i temi.Gets or sets a value indicating whether themes apply to this control.

(Ereditato da WebControl)
EnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Ereditato da Control)
ErrorStyle

Ottiene gli attributi di stile per il rendering del messaggio di errore visualizzato se non è possibile caricare o creare un controllo WebPart.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(Ereditato da WebZone)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Ereditato da Control)
ExistingConnectionErrorMessage

Ottiene o imposta il testo di un messaggio visualizzato nell'interfaccia utente di connessione quando viene generato un errore o un avviso in una connessione esistente.Gets or sets the text of a message displayed in the connection user interface (UI) when there is an error or warning on an existing connection.

Font

Ottiene le proprietà del carattere associate al controllo server Web.Gets the font properties associated with the Web server control.

(Ereditato da WebControl)
FooterStyle

Ottiene gli attributi di stile per il contenuto dell'area di piè di pagina di una zona.Gets the style attributes for the contents of a zone's footer area.

(Ereditato da WebZone)
ForeColor

Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Ereditato da WebControl)
GetFromText

Ottiene o imposta il testo visualizzato nella sezione dell'interfaccia utente di connessione che precede il provider specificato da cui un consumer recupererà i dati.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named provider from which a consumer will retrieve data.

GetText

Ottiene o imposta il testo visualizzato nella sezione dell'interfaccia utente di connessione che precede il consumer specificato che riceverà i dati da un provider.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named consumer that will receive data from a provider.

HasAttributes

Ottiene un valore che indica se sono impostati attributi per il controllo.Gets a value indicating whether the control has attributes set.

(Ereditato da WebControl)
HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Ereditato da Control)
HasFooter

Ottiene un valore che indica se una zona comprende o meno un'area di piè di pagina.Gets a value indicating whether a zone has a footer area.

(Ereditato da WebZone)
HasHeader

Ottiene un valore che indica se una zona comprende un'area di intestazione.Gets a value indicating whether a zone has a header area.

(Ereditato da WebZone)
HeaderCloseVerb

Ottiene un riferimento all'oggetto WebPartVerb nell'intestazione di un controllo ToolZone utilizzato per chiudere il controllo.Gets a reference to the WebPartVerb object in the header of a ToolZone control that is used to close the control.

(Ereditato da ToolZone)
HeaderStyle

Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona.Gets the style attributes for the contents of a zone's header area.

(Ereditato da WebZone)
HeaderText

Ottiene o imposta il testo dell'intestazione visualizzato nella parte superiore dell'interfaccia utente di connessione creata dal controllo ConnectionsZone.Gets or sets the header text that appears at the top of the connection user interface (UI) created by the ConnectionsZone control.

HeaderVerbStyle

Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un controllo ToolZone.Gets the style attributes for all header verbs displayed in a ToolZone control.

(Ereditato da ToolZone)
Height

Ottiene o imposta l'altezza del controllo server Web.Gets or sets the height of the Web server control.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

(Ereditato da Control)
InstructionText

Ottiene o imposta il testo utilizzato per le istruzioni generali sul controllo selezionato nella sezione dell'interfaccia utente di connessione per la gestione delle connessioni esistenti.Gets or set the text that is used for general instructions about the selected control in the section of the connection user interface (UI) for managing existing connections.

InstructionTextStyle

Ottiene gli attributi di stile per il testo di istruzioni che appare nella parte superiore di un controllo ToolZone.Gets the style attributes for the instruction text that appears at the top of a ToolZone control.

(Ereditato da ToolZone)
InstructionTitle

Ottiene o imposta il testo utilizzato per una descrizione generale dell'azione che può essere eseguita nel controllo consumer o provider con l'interfaccia utente di connessione per la gestione delle connessioni esistenti.Gets or sets the text that is used for a general description of the action that can be performed on the consumer or provider control, within the connection user interface (UI) for managing existing connections.

IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.Gets a value indicating whether the control is enabled.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(Ereditato da Control)
LabelStyle

Ottiene gli attributi di stile per il contenuto delle etichette che appaiono accanto ai controlli di modifica all'interno di un controllo ToolZone.Gets the style attributes for the contents of the labels that appear alongside the editing controls within a ToolZone control. I controlli ToolZone derivati, ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette.The derived ToolZone controls, such as CatalogZone and EditorZone, apply the styles to the labels.

(Ereditato da ToolZone)
LoadViewStateByID

Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Ereditato da Control)
NamingContainer

Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Ereditato da Control)
NewConnectionErrorMessage

Ottiene o imposta il testo di un messaggio visualizzato nell'interfaccia utente di connessione quando viene generato un errore o un avviso in una nuova connessione che un utente sta tentando di creare.Gets or sets the text of a message displayed in the connection user interface (UI) when there is an error or warning on a new connection that a user tries to create.

NoExistingConnectionInstructionText

Ottiene o imposta il testo informativo visualizzato nel corpo dell'interfaccia utente di connessione quando per un controllo Web part non è disponibile alcuna connessione esistente.Gets or sets the instruction text that appears in the body of the connection user interface (UI) when a Web Parts control has no existing connection.

NoExistingConnectionTitle

Ottiene o imposta il testo del titolo visualizzato nel corpo dell'interfaccia utente di connessione quando per un controllo Web part non è disponibile alcuna connessione esistente.Gets or sets the title text that appears in the body of the connection user interface (UI) when a Web Parts control has no existing connection.

Padding

Ottiene o imposta gli attributi di spaziatura interna delle celle sulla tabella che contiene i controlli WebPart in una zona.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(Ereditato da WebZone)
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(Ereditato da Control)
PartChromePadding

Ottiene o imposta la distanza tra il contenuto di un controllo WebPart e il bordo del controllo.Gets or sets the distance between the contents of a WebPart control and the border of the control.

(Ereditato da WebZone)
PartChromeStyle

Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(Ereditato da WebZone)
PartChromeType

Ottiene o imposta il tipo di bordo che delimita i controlli server contenuti in un controllo ConnectionsZone.Gets or sets the type of border that frames the server controls contained in a ConnectionsZone control.

PartStyle

Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(Ereditato da WebZone)
PartTitleStyle

Ottiene gli attributi di stile relativi al contenuto della barra del titolo per ogni controllo Web part contenuto in una zona.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(Ereditato da WebZone)
ProvidersInstructionText

Ottiene o imposta il testo informativo visualizzato nella sezione dei provider dell'interfaccia utente di connessione quando è già disponibile una connessione.Gets or sets the instructional text shown in the providers section of the connection user interface (UI), when a connection already exists.

ProvidersTitle

Ottiene o imposta il titolo visualizzato sopra la sezione dei provider dell'interfaccia utente di connessione quando è già disponibile una connessione.Gets or sets the title shown above the providers section of the connection user interface (UI), when a connection already exists.

RenderClientScript

Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part.Gets a value that indicates whether to render client script on a Web Parts page.

(Ereditato da WebZone)
RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Ereditato da Control)
SendText

Ottiene o imposta il testo visualizzato nella sezione dell'interfaccia utente di connessione che precede il provider specificato che invierà i dati a un consumer.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named provider that will send data to a consumer.

SendToText

Ottiene o imposta il testo visualizzato nella sezione dell'interfaccia utente di connessione che precede il consumer specificato a cui un provider invierà i dati.Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named consumer to which a provider will send data.

Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.Gets or sets the skin to apply to the control.

(Ereditato da WebControl)
Style

Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Ereditato da CompositeControl)
TabIndex

Ottiene o imposta l'indice di tabulazione del controllo server Web.Gets or sets the tab index of the Web server control.

(Ereditato da WebControl)
TagKey

Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebZone)
TagName

Ottiene il nome del tag del controllo.Gets the name of the control tag. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Ereditato da Control)
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.Gets the unique, hierarchically qualified identifier for the server control.

(Ereditato da Control)
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Ereditato da Control)
VerbButtonType

Ottiene o imposta il tipo di pulsante da utilizzare per rappresentare i verbi in una zona.Gets or sets what kind of button is used to represent verbs in a zone.

(Ereditato da WebZone)
VerbStyle

Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part di una zona.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(Ereditato da WebZone)
ViewState

Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se un controllo server viene o meno sottoposto a rendering come elemento dell'interfaccia utente nella pagina.Gets or sets a value that indicates whether a server control is rendered as a user interface (UI) element on the page.

(Ereditato da ToolZone)
WebPartManager

Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(Ereditato da WebZone)
WebPartToConnect

Ottiene il controllo WebPart selezionato a cui eseguire la connessione.Gets the currently selected WebPart control to connect to.

Width

Ottiene o imposta la larghezza del controllo server Web.Gets or sets the width of the Web server control.

(Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.Called after a child control is added to the Controls collection of the Control object.

(Ereditato da Control)
AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is primarily used by control developers.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.Applies the style properties defined in the page style sheet to the control.

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(Ereditato da Control)
BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Ereditato da Control)
Close()

Chiude l'interfaccia utente di connessione creata dal controllo ConnectionsZone.Closes the connection user interface (UI) created by the ConnectionsZone control.

CopyBaseAttributes(WebControl)

Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
CreateChildControls()

Crea tutti i controlli figlio contenuti in un controllo ConnectionsZone in preparazione per il postback al server o il rendering.Creates all child controls contained in a ConnectionsZone control in preparation for posting back to the server or rendering.

CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Ereditato da Control)
CreateControlStyle()

Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile.Creates the style object that is used internally by the WebControl class to implement all style related properties. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
DataBind()

Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio.Binds a data source to the CompositeControl and all its child controls.

(Ereditato da CompositeControl)
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.Enables a server control to perform final clean up before it is released from memory.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.Searches the current naming container for a server control with the specified id parameter.

(Ereditato da Control)
FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input su un controllo.Sets input focus to a control.

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

(Ereditato da Control)
GetEffectiveChromeType(Part)

Restituisce il valore PartChromeType corrente effettivo di un controllo WebPart, una volta specificate la proprietà PartChromeType della zona e la modalità di visualizzazione corrente della pagina Web part.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

(Ereditato da WebZone)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

(Ereditato da Control)
HasControls()

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

(Ereditato da Control)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

(Ereditato da Control)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().Restores control state information from a previous page request that was saved by the SaveControlState() method.

LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente salvata dal metodo SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MergeStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Ereditato da Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Genera l'evento DisplayModeChanged.Raises the DisplayModeChanged event.

OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Ereditato da WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Genera l'evento SelectedWebPartChanged.Raises the SelectedWebPartChanged event.

OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Ereditato da Control)
OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.Assigns any sources of the event and its information to the control's parent.

(Ereditato da Control)
RaisePostBackEvent(String)

Genera un evento per il controllo ConnectionsZone quando il form che lo contiene esegue il postback al server.Raises an event for the ConnectionsZone control when the form that contains it posts back to the server.

RecreateChildControls()

Ricrea i controlli figlio in un controllo derivato da CompositeControl.Recreates the child controls in a control derived from CompositeControl.

(Ereditato da CompositeControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.Called after a child control is removed from the Controls collection of the Control object.

(Ereditato da Control)
Render(HtmlTextWriter)

Esegue il rendering del contenuto del controllo ConnectionsZone sull'oggetto HtmlTextWriter specificato.Renders the contents of the ConnectionsZone control to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

(Ereditato da WebZone)
RenderBody(HtmlTextWriter)

Invia il contenuto dell'area del corpo di un controllo ConnectionsZone all'oggetto HtmlTextWriter specificato, che scrive il contenuto nella pagina Web.Sends the content of a ConnectionsZone control's body area to the specified HtmlTextWriter object, which writes the content to the Web page.

RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering dell'intero contenuto di un controllo zona compreso tra il tag di inizio e quello di fine sull'oggetto HtmlTextWriter specificato.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

(Ereditato da WebZone)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato.Renders the HTML closing tag of the control into the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
RenderFooter(HtmlTextWriter)

Esegue l'override del metodo base per il rendering dei verbi nel piè di pagina di un controllo ToolZone.Overrides the base method to render verbs in the footer of a ToolZone control.

(Ereditato da ToolZone)
RenderHeader(HtmlTextWriter)

Esegue l'override del metodo base per fornire il rendering specializzato per l'area di intestazione richiesto dai controlli ToolZone.Overrides the base method to provide specialized rendering for the header area required by ToolZone controls.

(Ereditato da ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Esegue il rendering di un singolo verbo con un controllo ToolZone.Renders an individual verb with a ToolZone control.

(Ereditato da ToolZone)
RenderVerbs(HtmlTextWriter)

Esegue il rendering dei verbi a livello di zona per un controllo ConnectionsZone.Renders the zone-level verbs for a ConnectionsZone control.

ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Ereditato da Control)
SaveControlState()

Salva le modifiche apportate allo stato di qualsiasi controllo Web part dall'ultima volta in cui è stato eseguito il postback della pagina al server.Saves any Web Parts control state changes that occurred since the last time the page was posted back to the server.

SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione di un controllo ConnectionsZone dall'ultima volta che è stato eseguito il postback della pagina al server.Saves a ConnectionsZone control's view-state changes that occurred since the page was last posted back to the server.

SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

(Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.Assigns an event handler delegate to render the server control and its content into its parent control.

(Ereditato da Control)
SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Ereditato da Control)
SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TrackViewState()

Tiene traccia delle modifiche apportate allo stato di visualizzazione del controllo ConnectionsZone, affinché le modifiche possano essere memorizzate nell'oggetto StateBag del controllo.Tracks view-state changes to the ConnectionsZone control so the changes can be stored in the control's StateBag object.

Eventi

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(Ereditato da Control)
Disposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Ereditato da Control)
Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Ereditato da Control)
Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.Gets an attribute of the Web control with the specified name.

(Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)

Imposta un attributo del controllo Web sul nome e il valore specificati.Sets an attribute of the Web control to the specified name and value.

(Ereditato da WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Consente a uno strumento di progettazione di ricreare l'insieme di controlli figlio del controllo composito nell'ambiente di progettazione.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Ereditato da Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa il metodo RaisePostBackEvent(String).Implements the RaisePostBackEvent(String) method.

(Ereditato da ToolZone)

Metodi di estensione

FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Ottiene i metadati della tabella per il controllo dei dati specificato.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Imposta i metadati della tabella per il controllo dei dati specificato.Sets the table metadata for the specified data control.

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

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se sono disponibili i metadati della tabella.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

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

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

Si applica a

Vedi anche