DeclarativeCatalogPart Classe

Definizione

Consente agli sviluppatori di aggiungere un catalogo di controlli WebPart o di altri controlli server a una pagina Web nel formato dichiarativo (persistenza nella pagina).Enables developers to add a catalog of WebPart or other server controls to a Web page in the declarative, page persistence format. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class DeclarativeCatalogPart sealed : System::Web::UI::WebControls::WebParts::CatalogPart
public sealed class DeclarativeCatalogPart : System.Web.UI.WebControls.WebParts.CatalogPart
type DeclarativeCatalogPart = class
    inherit CatalogPart
Public NotInheritable Class DeclarativeCatalogPart
Inherits CatalogPart
Ereditarietà
DeclarativeCatalogPart

Esempi

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

  • Controllo utente che consente di modificare le modalità di visualizzazione in una pagina Web part.A user control that enables you to change display modes on a Web Parts page.

  • Pagina Web contenente un CatalogZone controllo e un DeclarativeCatalogPart controllo.A Web page that contains a CatalogZone control and a DeclarativeCatalogPart control.

  • Un file di codice sorgente che contiene due WebPart controlli personalizzati.A source code file that contains two custom WebPart controls.

  • Una spiegazione del funzionamento dell'esempio quando si carica la pagina in un browser.An explanation of how the example works when you load the page in a browser.

La prima parte di questo esempio di codice è il controllo utente che consente di modificare le modalità di visualizzazione nella pagina.The first part of this code example is the user control that enables you to change display modes on the 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 unapagina 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 di codice è la pagina Web.The second part of the code example is the Web page. Nella parte superiore della pagina sono presenti due Register direttive, una per il controllo utente e una per il componente compilato che contiene i due controlli WebPart personalizzati.At the top of the page are two Register directives, one for the user control and one for the compiled component that contains the two custom WebPart controls. Si noti che la pagina contiene un riferimento dichiarativo al DeclarativeCatalogPart controllo, annidato all'interno della gerarchia corretta di elementi dichiarativi, come descritto nella sezione Osservazioni di questo argomento.Notice that the page has a declarative reference to the DeclarativeCatalogPart control, nested within the proper hierarchy of declarative elements as described in the Remarks section of this topic. L' <asp:declarativecatalogpart> elemento contiene un <webpartstemplate> elemento, che a sua volta contiene i riferimenti per un Calendar controllo ASP.NET standard e i WebPart due controlli personalizzati, ovvero i controlli che gli utenti possono selezionare dal catalogo.The <asp:declarativecatalogpart> element contains a <webpartstemplate> element, which in turn contains references for a standard ASP.NET Calendar control and the two custom WebPart controls; these are the controls that users can select from the catalog. La pagina contiene inoltre la funzionalità di modifica, PropertyGridEditorPart con un controllo dichiarato nella pagina.The page also contains editing capability, with a PropertyGridEditorPart control declared on the page. Questo controllo consente agli utenti di modificare determinate proprietà nei controlli WebPart personalizzati dopo che sono stati aggiunti alla pagina e dopo che l'utente ha cambiato la pagina in modalità di modifica.This control enables users to edit certain properties on the custom WebPart controls after they have been added to the page, and after the user has switched the page to edit mode.

<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="UserInfoWebPartCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      DeclarativeCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink"
            Title="Favorites">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </zonetemplate>
      </asp:webpartzone> 
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            Title="Web Parts Catalog"
            ChromeType="TitleOnly" 
            Description="Contains a user control with Web Parts and 
              an ASP.NET Calendar control.">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" 
                Description="ASP.NET Calendar control used as a personal calendar." />
              <aspSample:UserInfoWebPart 
                runat="server"   
                id="userinfo1" 
                title = "User Information WebPart"
                Description ="Contains custom, editable user information 
                  for display on a page." />
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="TextDisplayWebPart1" 
                title = "Text Display WebPart" 
                Description="Contains a label that users can dynamically update." />
            </WebPartsTemplate>              
          </asp:DeclarativeCatalogPart>
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
      <ZoneTemplate>
        <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" runat="server" />
      </ZoneTemplate>
      </asp:EditorZone> 
    </form>
  </body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="UserInfoWebPartVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      DeclarativeCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink"
            Title="Favorites">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </zonetemplate>
      </asp:webpartzone> 
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            Title="Web Parts Catalog"
            ChromeType="TitleOnly" 
            Description="Contains a user control with Web Parts and 
              an ASP.NET Calendar control.">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" 
                Description="ASP.NET Calendar control used as a personal calendar." />
              <aspSample:UserInfoWebPart 
                runat="server"   
                id="userinfo1" 
                title = "User Information WebPart"
                Description ="Contains custom, editable user information 
                  for display on a page." />
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="TextDisplayWebPart1" 
                title = "Text Display WebPart" 
                Description="Contains a label that users can dynamically update." />
            </WebPartsTemplate>              
          </asp:DeclarativeCatalogPart>
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
      <ZoneTemplate>
        <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" runat="server" />
      </ZoneTemplate>
      </asp:EditorZone> 
    </form>
  </body>
</html>

La terza parte dell'esempio di codice è il codice sorgente per i due WebPart controlli.The third part of the code example is the source code for the two WebPart controls. Si noti che alcune proprietà di questi controlli sono contrassegnate WebBrowsable con l'attributo.Notice that some properties on these controls are marked with the WebBrowsable attribute. Ciò consente al PropertyGridEditorPart controllo di generare dinamicamente l'interfaccia utente (UI) per consentire a un utente di modificare tali proprietà quando i controlli sono in modalità di modifica.This enables the PropertyGridEditorPart control to dynamically generate the user interface (UI) for a user to edit those properties when the controls are in edit mode. Anche le proprietà sono contrassegnate con WebDisplayName un attributo, per specificare il testo dell'etichetta visualizzata accanto a ogni controllo nell'interfaccia utente di modifica.The properties are also marked with a WebDisplayName attribute, to specify the text of the label that appears next to each control in the editing UI.

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à compilato 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. Per una procedura dettagliata in cui vengono illustrati entrambi i metodi di compilazione, vedere Procedura dettagliata: Sviluppo e utilizzo di un controlloserver Web personalizzato.For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class UserInfoWebPart : WebPart
  {
    HttpServerUtility server = HttpContext.Current.Server;
    private String _userNickName = "Add a nickname.";
    private String _userPetName = "Add a pet's name.";
    private DateTime _userSpecialDate = DateTime.Now;
    private Boolean _userIsCurrent = true;
    private JobTypeName _userJobType = JobTypeName.Unselected;
    public enum JobTypeName
    {
      Unselected = 0,
      Support = 1,
      Service = 2,
      Professional = 3, 
      Technical = 4,
      Manager = 5,
      Executive = 6
    }
    Label NickNameLabel;
    Label PetNameLabel;
    Label SpecialDateLabel;
    CheckBox IsCurrentCheckBox;
    Label JobTypeLabel;

    // Add the Personalizable and WebBrowsable attributes to the  
    // public properties, so that users can save property values  
    // and edit them with a PropertyGridEditorPart control.
    [Personalizable(), WebBrowsable, WebDisplayName("Nickname")]
    public String NickName
    {
      get 
      { 
        object o = ViewState["NickName"];
        if (o != null)
          return (string)o;
        else
          return _userNickName;        
      } 

      set { _userNickName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable, WebDisplayName("Pet Name")]
    public String PetName
    {
      get 
      { 
        object o = ViewState["PetName"];
        if (o != null)
          return (string)o;
        else
          return _userPetName;        
      }

      set { _userPetName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Special Day")]
    public DateTime SpecialDay
    {
      get
      {
        object o = ViewState["SpecialDay"];
        if (o != null)
          return (DateTime)o;
        else
          return _userSpecialDate;
        
      }

      set { _userSpecialDate = value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Job Type")]
    public JobTypeName UserJobType
    {
      get
      {
        object o = ViewState["UserJobType"];
        if (o != null)
          return (JobTypeName)o;
        else
          return _userJobType;
      }

      set { _userJobType = (JobTypeName)value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Is Current")]
    public Boolean IsCurrent
    {
      get
      {
        object o = ViewState["IsCurrent"];
        if (o != null)
          return (Boolean)o;
        else
          return _userIsCurrent;
      }

      set { _userIsCurrent = value; }
    }


    protected override void CreateChildControls()
    {
      Controls.Clear();

      NickNameLabel = new Label();
      NickNameLabel.Text = this.NickName;
      SetControlAttributes(NickNameLabel);

      PetNameLabel = new Label();
      PetNameLabel.Text = this.PetName;
      SetControlAttributes(PetNameLabel);

      SpecialDateLabel = new Label();
      SpecialDateLabel.Text = this.SpecialDay.ToShortDateString();
      SetControlAttributes(SpecialDateLabel);

      IsCurrentCheckBox = new CheckBox();
      IsCurrentCheckBox.Checked = this.IsCurrent;
      SetControlAttributes(IsCurrentCheckBox);

      JobTypeLabel = new Label();
      JobTypeLabel.Text = this.UserJobType.ToString();
      SetControlAttributes(JobTypeLabel);

      ChildControlsCreated = true;

    }

    private void SetControlAttributes(WebControl ctl)
    {
      ctl.BackColor = Color.White;
      ctl.BorderWidth = 1;
      ctl.Width = 200;
      this.Controls.Add(ctl);
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
      writer.Write("Nickname:");
      writer.WriteBreak();
      NickNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Pet Name:");
      writer.WriteBreak();
      PetNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Special Date:");
      writer.WriteBreak();
      SpecialDateLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Job Type:");
      writer.WriteBreak();
      JobTypeLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Current:");
      writer.WriteBreak();
      IsCurrentCheckBox.RenderControl(writer);
    }
  }


  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);

    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }

  }

}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
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 Class UserInfoWebPart
    Inherits WebPart
    Private server As HttpServerUtility = HttpContext.Current.Server
    Private _userNickName As String = "Add a nickname."
    Private _userPetName As String = "Add a pet's name."
    Private _userSpecialDate As DateTime = DateTime.Now
    Private _userIsCurrent As [Boolean] = True
    Private _userJobType As JobTypeName = JobTypeName.Unselected

    Public Enum JobTypeName
      Unselected = 0
      Support = 1
      Service = 2
      Professional = 3
      Technical = 4
      Manager = 5
      Executive = 6
    End Enum

    Private NickNameLabel As Label
    Private PetNameLabel As Label
    Private SpecialDateLabel As Label
    Private IsCurrentCheckBox As CheckBox
    Private JobTypeLabel As Label

    ' Add the Personalizable and WebBrowsable attributes to the  
    ' public properties, so that users can save property values  
    ' and edit them with a PropertyGridEditorPart control.

    <Personalizable(), WebBrowsable(), WebDisplayName("Nickname")> _
    Public Property NickName() As String
      Get
        Dim o As Object = ViewState("NickName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userNickName
        End If
      End Get
      Set(ByVal value As String)
        _userNickName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Pet Name")> _
    Public Property PetName() As String
      Get
        Dim o As Object = ViewState("PetName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userPetName
        End If
      End Get
      Set(ByVal value As String)
        _userPetName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Special Day")> _
    Public Property SpecialDay() As DateTime
      Get
        Dim o As Object = ViewState("SpecialDay")
        If Not (o Is Nothing) Then
          Return CType(o, DateTime)
        Else
          Return _userSpecialDate
        End If
      End Get

      Set(ByVal value As DateTime)
        _userSpecialDate = value
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Job Type")> _
    Public Property UserJobType() As JobTypeName
      Get
        Dim o As Object = ViewState("UserJobType")
        If Not (o Is Nothing) Then
          Return CType(o, JobTypeName)
        Else
          Return _userJobType
        End If
      End Get
      Set(ByVal value As JobTypeName)
        _userJobType = CType(value, JobTypeName)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Is Current")> _
    Public Property IsCurrent() As [Boolean]
      Get
        Dim o As Object = ViewState("IsCurrent")
        If Not (o Is Nothing) Then
          Return CType(o, [Boolean])
        Else
          Return _userIsCurrent
        End If
      End Get
      Set(ByVal value As [Boolean])
        _userIsCurrent = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      NickNameLabel = New Label()
      NickNameLabel.Text = Me.NickName
      SetControlAttributes(NickNameLabel)

      PetNameLabel = New Label()
      PetNameLabel.Text = Me.PetName
      SetControlAttributes(PetNameLabel)

      SpecialDateLabel = New Label()
      SpecialDateLabel.Text = Me.SpecialDay.ToShortDateString()
      SetControlAttributes(SpecialDateLabel)

      IsCurrentCheckBox = New CheckBox()
      IsCurrentCheckBox.Checked = Me.IsCurrent
      SetControlAttributes(IsCurrentCheckBox)

      JobTypeLabel = New Label()
      JobTypeLabel.Text = Me.UserJobType.ToString()
      SetControlAttributes(JobTypeLabel)

      ChildControlsCreated = True

    End Sub

    Private Sub SetControlAttributes(ByVal ctl As WebControl)
      ctl.BackColor = Color.White
      ctl.BorderWidth = 1
      ctl.Width = 200
      Me.Controls.Add(ctl)
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
      writer.Write("Nickname:")
      writer.WriteBreak()
      NickNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Pet Name:")
      writer.WriteBreak()
      PetNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Special Date:")
      writer.WriteBreak()
      SpecialDateLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Job Type:")
      writer.WriteBreak()
      JobTypeLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Current:")
      writer.WriteBreak()
      IsCurrentCheckBox.RenderControl(writer)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

Quando si carica la pagina in un browser, selezionare modalità catalogo nel controllo elenco a discesa modalità di visualizzazione per passare alla modalità catalogo.When you load the page in a browser, select Catalog Mode in the Display Mode drop-down list control to switch to catalog mode. In modalità catalogo è possibile visualizzare i controlli che sono disponibili per essere aggiunti alla pagina.In catalog mode, you can see the controls that are available to be added to the page. Aggiungere tutti e tre i controlli, quindi utilizzare l'elenco a discesa modalità di visualizzazione per tornare alla modalità Sfoglia della pagina.Add all three controls, and then use the Display Mode drop-down list to return the page to browse mode. I tre controlli vengono visualizzati nella pagina.The three controls appear on the page. Se si usa l'elenco a discesa modalità di visualizzazione e si passa alla modalità di modifica della pagina, è possibile fare clic sul menu dei verbi (la freccia verso il basso) nella barra del titolo del controllo WebPart informazioni utente e fare clic su modifica per modificare il controllo.If you use the Display Mode drop-down list and switch the page to edit mode, you can click the verbs menu (the downward arrow) in the title bar of the User Information WebPart control, and click Edit to edit the control. Quando l'interfaccia utente di modifica è visibile, è possibile PropertyGridEditorPart visualizzare il controllo.When the editing UI is visible, you can see the PropertyGridEditorPart control. Si noti che viene eseguito il rendering di un controllo per ogni proprietà UserInfoWebPart della classe contrassegnata con l' WebBrowsable attributo.Notice that a control is rendered for each of the properties of the UserInfoWebPart class that was marked with the WebBrowsable attribute. Se si apportano alcune modifiche nell'interfaccia utente di modifica e si fa clic sul pulsante applica , è possibile usare l'elenco a discesa modalità di visualizzazione per tornare alla modalità Sfoglia e visualizzare l'effetto completo delle modifiche apportate alla modifica.If you make some changes in the editing UI and click the Apply button, you can use the Display Mode drop-down list to return the page to browse mode and see the full effect of the editing changes.

Commenti

Così come sono presenti zone orientate agli strumenti nel set di controlli Web part (per informazioni dettagliate, ToolZone vedere la panoramica della classe), sono presenti Part controlli orientati agli strumenti e ognuno di questi controlli deve risiedere in un determinato tipo di area degli strumenti.Just as there are tool-oriented zones in the Web Parts control set (for details, see the ToolZone class overview), there are tool-oriented Part controls, and each of these controls must reside in a certain type of tool zone. I controlli di parte orientati agli strumenti nel set di controlli Web part hanno due caratteristiche distintive:Tool-oriented part controls in the Web Parts control set have two distinguishing characteristics:

  • Si tratta di controlli helper che consentono agli utenti finali di personalizzare i controlli in una pagina Web part.They are helper controls that enable end users to personalize controls on a Web Parts page.

  • Sono visibili solo in determinate modalità di visualizzazione.They are visible only in certain display modes.

DeclarativeCatalogPartè un controllo parte che deve risiedere in CatalogZoneBase un tipo di zona, ad esempio CatalogZone la zona fornita con il set di controlli Web part.DeclarativeCatalogPart is a part control that must reside in a CatalogZoneBase type of zone, such as the CatalogZone zone provided with the Web Parts control set. Il DeclarativeCatalogPart controllo diventa visibile solo quando una pagina Web è in modalità di visualizzazione del catalogo.The DeclarativeCatalogPart control becomes visible only when a Web page is in catalog display mode.

Il DeclarativeCatalogPart controllo consente agli sviluppatori di aggiungere un set di controlli server in modo dichiarativo a un catalogo in una pagina Web.The DeclarativeCatalogPart control provides a way for developers to add a set of server controls declaratively to a catalog on a Web page. Un catalogo, nel set di controlli di Web part, è semplicemente un elenco WebPart di o altri controlli server visibili quando una pagina è in modalità di visualizzazione del catalogo.A catalog, in the Web Parts control set, is simply a list of WebPart or other server controls that is visible when a page is in catalog display mode. Un utente può selezionare i controlli dall'elenco e aggiungerli alla pagina Web, in modo da consentire agli utenti di modificare il set di controlli e le funzionalità in una pagina.A user can select controls from the list and add them to the Web page, which effectively gives users the ability to change the set of controls and the functionality on a page.

Nota

Gli utenti possono aggiungere più istanze dello stesso controllo in un catalogo a una pagina Web.Users can add multiple instances of the same control in a catalog to a Web page.

Un vantaggio dell'uso di DeclarativeCatalogPart un controllo per creare un catalogo di controlli server è che non richiede alcuna codifica.An advantage of using a DeclarativeCatalogPart control to create a catalog of server controls is that it does not require any coding. Gli sviluppatori di pagine possono utilizzare il controllo interamente nel formato dichiarativo (o persistenza della pagina), quindi il nome del controllo.Page developers can work with the control entirely in the declarative (or page persistence) format, hence the name of the control.

Il DeclarativeCatalogPart controllo ha una proprietà utile che consente agli sviluppatori di configurare un catalogo di controlli che possono essere usati in un intero sito.The DeclarativeCatalogPart control has a useful property that allows developers to set up a catalog of controls that can be used throughout an entire site. Anziché dichiarare singoli controlli server all'interno di DeclarativeCatalogPart un controllo, uno sviluppatore può impostare WebPartsListUserControlPath il valore della proprietà sul percorso di un controllo utente che contiene l'elenco dei controlli server che devono trovarsi nel catalogo.Rather than declare individual server controls within a DeclarativeCatalogPart control, a developer can set the WebPartsListUserControlPath property value to the path of a user control that contains the list of server controls that should be in the catalog. In fase di esecuzione, i controlli server a cui viene fatto riferimento nel controllo utente vengono caricati nel catalogo.At run time, the server controls referenced in the user control are loaded in the catalog. In questo modo, è possibile che più pagine o siti facciano riferimento allo stesso controllo utente per la creazione di un catalogo.In this way, multiple pages or sites could reference the same user control to create a catalog. Quando l'elenco dei controlli server del controllo utente viene aggiornato, aggiorna tutti i cataloghi in base al controllo utente.When the user control's list of server controls is updated, it would update all catalogs based on the user control.

La DeclarativeCatalogPart classe dispone di un numero di proprietà pubbliche che eseguono l'override delle proprietà ereditate.The DeclarativeCatalogPart class has a number of public properties that override the inherited properties. La maggior parte di queste proprietà non viene effettivamente utilizzata per il rendering del controllo; ne viene eseguito l'override solo in modo che sia possibile impostare attributi di codice speciali per nasconderli dagli strumenti di Microsoft Visual Studio 2005Microsoft Visual Studio 2005progettazione come.Most of these properties are not actually used for rendering the control; they are overridden only so that special code attributes can be set on them to hide them from design tools like Microsoft Visual Studio 2005Microsoft Visual Studio 2005. Non usare queste proprietà nascoste, perché non hanno effetto sul rendering.You should not use these hidden properties, as they have no effect on rendering. Il fatto che siano nascosti da IntelliSense e il riquadro Proprietà in Visual Studio consente agli sviluppatori di evitare di usarli per errore.The fact that they are hidden from IntelliSense and the Properties pane in Visual Studio helps developers avoid using them by mistake. Tutte queste proprietà nascoste sono indicate come tali nei rispettivi argomenti della guida.All these hidden properties are noted as such in their respective Help topics.

La DeclarativeCatalogPart classe dispone inoltre di diversi metodi.The DeclarativeCatalogPart class also has several methods. Il GetAvailableWebPartDescriptions metodo recupera un WebPartDescription oggetto per ogni WebPart controllo nel catalogo, che consente a un DeclarativeCatalogPart controllo di visualizzare informazioni su ogni controllo server senza doverne creare un'istanza.The GetAvailableWebPartDescriptions method retrieves a WebPartDescription object for each WebPart control in the catalog, which enables a DeclarativeCatalogPart control to display information about each server control without having to create an instance of it. Un altro metodo è GetWebPart il metodo.Another method is the GetWebPart method. Questo metodo ottiene un'istanza di un controllo WebPart specifico, in base alla descrizione passata al metodo.This method gets an instance of a particular WebPart control, based on the description passed to the method.

Nota

Per migliorare l'accessibilità DeclarativeCatalogPart , viene eseguito il rendering <fieldset> del controllo all'interno di un elemento.To improve accessibility, the DeclarativeCatalogPart control is rendered within a <fieldset> element. L' <fieldset> elemento raggruppa il set correlato di controlli utilizzati per la DeclarativeCatalogPart modifica nel controllo 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 al riconoscimento vocale ( come il software per la lettura dello schermo).The <fieldset> element groups the related set of controls used for editing in the DeclarativeCatalogPart 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).

Costruttori

DeclarativeCatalogPart()

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

Proprietà

AccessKey

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo DeclarativeCatalogPart.This inherited property is not used by the Web Parts control set when rendering a DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
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

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

BackImageUrl

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo DeclarativeCatalogPart.This inherited property is not used by the Web Parts control set when rendering a DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

BorderStyle

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

BorderWidth

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
ChromeState

Ottiene o imposta un controllo di parte in stato normale o ridotto a icona.Gets or sets whether a part control is in a minimized or normal state.

(Ereditato da Part)
ChromeType

Ottiene o imposta il tipo di bordo che delimita un controllo Web part.Gets or sets the type of border that frames a Web Parts control.

(Ereditato da Part)
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)
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 contiene i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that contains the child controls for a specified server control in the user interface hierarchy.

(Ereditato da Part)
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

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
DefaultButton

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

Description

Ottiene o imposta una breve frase che riepiloga la funzione del controllo di parte da utilizzare nelle descrizioni comando e nei cataloghi dei controlli di parte.Gets or sets a brief phrase that summarizes what the part control does, for use in ToolTips and catalogs of part controls.

(Ereditato da Part)
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)
Direction

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

DisplayTitle

Ottiene una stringa che contiene il titolo corrente effettivo di un controllo CatalogPart.Gets a string that contains the actual current title of a CatalogPart control.

(Ereditato da CatalogPart)
Enabled

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

EnableTheming

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
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)
Font

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

ForeColor

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

GroupingText

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
Height

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

HorizontalAlign

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
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)
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)
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)
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)
ScrollBars

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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 Panel)
TabIndex

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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 WebControl)
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)
Title

Ottiene o imposta il titolo che viene visualizzato sulla barra del titolo del controllo.Gets or sets the title that appears in the control's title bar.

ToolTip

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

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)
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

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

WebPartManager

Ottiene un riferimento all'istanza corrente della classe WebPartManager.Gets a reference to the current instance of the WebPartManager class.

(Ereditato da CatalogPart)
WebPartsListUserControlPath

Ottiene o imposta il percorso di un controllo utente contenente un elenco di controlli WebPart o altri controlli server per il catalogo.Gets or sets the path to a user control that contains a list of WebPart or other server controls for the catalog.

WebPartsTemplate

Ottiene o imposta un riferimento a un modello che contiene i controlli WebPart dichiarati in un catalogo.Gets or sets a reference to a template that contains the WebPart controls declared in a catalog.

Width

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

Wrap

La proprietà ereditata non viene utilizzata dal controllo DeclarativeCatalogPart.This inherited property is not used by the DeclarativeCatalogPart control. L'override della proprietà viene eseguito solo allo scopo di impedirne la visualizzazione negli strumenti di progettazione di Microsoft Visual Studio 2005Microsoft Visual Studio 2005.The property is overridden only for the purpose of preventing it from appearing in Microsoft Visual Studio 2005Microsoft Visual Studio 2005 designer tools.

Zone

Ottiene un riferimento alla zona CatalogZoneBase che contiene un controllo CatalogPart.Gets a reference to the CatalogZoneBase zone that contains a CatalogPart control.

(Ereditato da CatalogPart)

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge all'elenco degli attributi di cui eseguire il rendering informazioni sull'immagine di sfondo, l'allineamento, il ritorno a capo e la direzione.Adds information about the background image, alignment, wrap, and direction to the list of attributes to render.

(Ereditato da Panel)
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)
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()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Ereditato da Control)
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 un oggetto stile usato internamente dal controllo Panel per implementare tutte le proprietà correlate allo stile.Creates a style object that is used internally by the Panel control to implement all style related properties.

(Ereditato da Panel)
DataBind()

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

(Ereditato da Part)
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)
GetAvailableWebPartDescriptions()

Restituisce un insieme di descrizioni dei controlli WebPart disponibili in un catalogo.Returns a collection of descriptions of the available WebPart controls in a catalog.

GetDesignModeState()

Recupera lo stato corrente della zona padre di un controllo CatalogPart.Retrieves the current state of a CatalogPart control's parent zone.

(Ereditato da CatalogPart)
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)
GetWebPart(WebPartDescription)

Restituisce un riferimento a un controllo WebPart basato sul valore della descrizione passata al metodo.Returns a reference to a WebPart control based on the value of the description passed into the method.

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.

(Ereditato da Control)
LoadViewState(Object)

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

(Ereditato da WebControl)
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)
OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

(Ereditato da Control)
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 CatalogPart)
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)
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 controllo nel writer HTML specificato.Renders the control to the specified HTML writer.

(Ereditato da WebControl)
RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo Panel nel writer specificato.Renders the HTML opening tag of the Panel control to the specified writer.

(Ereditato da Panel)
RenderChildren(HtmlTextWriter)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul 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 del contenuto del controllo nel writer specificato.Renders the contents of the control to the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
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 Panel nel writer specificato.Renders the HTML closing tag of the Panel control into the specified writer.

(Ereditato da Panel)
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 tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Ereditato da Control)
SaveViewState()

Salva qualsiasi stato modificato dopo la chiamata del metodo TrackViewState().Saves any state that was modified after the TrackViewState() method was invoked.

(Ereditato da WebControl)
SetDesignModeState(IDictionary)

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

(Ereditato da CatalogPart)
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()

Forza il controllo a tenere traccia dello modifiche apportate allo stato di visualizzazione in modo che vengano archiviate nella proprietà ViewState dell'oggetto.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Ereditato da WebControl)

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 allo sviluppatore di una finestra di progettazione per un controllo di parte composito di creare nuovamente i controlli figlio sull'area di progettazione.Allows the developer of a designer for a composite part control to recreate the control's child controls on the design surface.

(Ereditato da Part)
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)

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