PageCatalogPart Classe

Definizione

Fornisce un catalogo che contiene riferimenti a tutti i controlli WebPart, e ad altri controlli server contenuti nelle zone WebPartZoneBase, che sono stati chiusi da un utente in una singola pagina Web part, consentendo così agli utenti di reinserire nella pagina i controlli chiusi.Provides a catalog that keeps references to all WebPart controls (and other server controls contained in WebPartZoneBase zones) that a user has closed on a single Web Parts page, which enables users to add the closed controls back to the page. Questa classe non può essere ereditata.This class cannot be inherited.

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

Esempi

Nell'esempio di codice riportato di seguito viene illustrato PageCatalogPart come utilizzare il controllo in modo dichiarativo in una pagina Web.The following code example demonstrates how to use the PageCatalogPart control declaratively on a Web page. Questo esempio è costituito da quattro parti:This 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, un PageCatalogPart controllo e un DeclarativeCatalogPart controllo.A Web page that contains a CatalogZone control, a PageCatalogPart 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 agli utenti di modificare le modalità di visualizzazione in una pagina Web.The first part of this code example is the user control that enables users to change display modes on a Web page. Per informazioni dettagliate sulle modalità di visualizzazione e una descrizione del codice sorgente in questo controllo, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in 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 PageCatalogPart 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 PageCatalogPart control, nested within the proper hierarchy of declarative elements as described in the Remarks section of this topic. Esiste anche un <asp:declarativecatalogpart> elemento, che contiene i riferimenti per un controllo ASP.NET Calendar standard e i due controlli WebPart personalizzati, che sono tutti i controlli che gli utenti possono selezionare dal catalogo.There is also an <asp:declarativecatalogpart> element, which contains references for a standard ASP.NET Calendar control and the two custom WebPart controls, all of which are the controls that users can select from the catalog.

<%@ 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>
      PageCatalogPart 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:PageCatalogPart ID="PageCatalogPart1" runat="server" 
            Title="My Page Catalog" 
            ChromeType="Titleonly" />
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            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>
    </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 id="Head1" runat="server">
    <title>
      PageCatalogPart 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:PageCatalogPart ID="PageCatalogPart1" runat="server" 
            Title="My Page Catalog" 
            ChromeType="TitleOnly" />
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            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>
    </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. 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 uno dei controlli, quindi usare il controllo elenco a discesa modalità di visualizzazione per tornare alla modalità di visualizzazione della pagina.Add one of the controls, then use the Display Mode drop-down list control to return the page to browse mode. Fare clic sul menu dei verbi (freccia verso il basso) nella barra del titolo di uno dei controlli, quindi fare clic su Chiudi per chiudere il controllo.Click the verbs menu (the downward arrow) in the title bar of one of the controls, and click Close to close the control. Ripristinare la pagina in modalità catalogo. si noti che il controllo chiuso ora viene visualizzato nel catalogo della pagina ed è disponibile per essere aggiunto di nuovo alla pagina.Return the page to catalog mode, and notice that the control you closed now appears in the page catalog, and is available to be added back to the page.

Commenti

La PageCatalogPart classe serve uno scopo molto specifico in una pagina di Web part: funge da catalogo della pagina per mantenere tutti i controlli aggiunti in precedenza alla pagina che un utente ha chiuso, in modo che l'utente possa aggiungerli nuovamente alla pagina.The PageCatalogPart class serves one very specific purpose on a Web Parts page: it acts as a page catalog to maintain any controls previously added to the page that a user has closed, so that the user can add them back to the page. Questo controllo è visibile solo quando una pagina Web è in modalità di visualizzazione del catalogo, una vista speciale che consente agli utenti di aggiungere e rimuovere controlli nella pagina.This control is visible only when a Web page is in catalog display mode, a special view that enables users to add and remove controls on the page. Aggiungere un PageCatalogPart controllo alla pagina se si desidera fornire agli utenti la flessibilità di chiudere e riaprire i controlli.Add a PageCatalogPart control to your page if you want to provide users with the flexibility of closing and reopening controls. Se la pagina non consente agli utenti di chiudere i controlli, non è necessario aggiungere un PageCatalogPart controllo alla pagina.If your page does not allow users to close controls at all, there is no need to add a PageCatalogPart control to your page.

Solo i controlli chiusi vengono aggiunti al catalogo della pagina.Only closed controls are added to the page catalog. Un controllo chiuso presenta diversi attributi:A closed control has several attributes:

  • Non è visibile nella pagina.It is not visible on the page.

  • Il rendering non viene eseguito nella pagina.It is not rendered on the page.

  • Non partecipa alle fasi del ciclo di vita della pagina.It does not participate in page life-cycle phases.

La chiusura di un controllo è diversa dall'eliminazione, che la rimuove definitivamente dalla pagina.Closing a control is different from deleting it, which permanently removes it from the page. Un utente può riaprire un'istanza di controllo chiusa da un catalogo di pagine, ma dopo che un utente ha eliminato un controllo, non può mai recuperare tale istanza specifica.A user can reopen a closed control instance from a page catalog, but after a user deletes a control, he or she can never recover that specific instance.

Il modo più comune e pratico per aggiungere un PageCatalogPart controllo a una pagina è dichiararlo nel formato di persistenza della pagina.The most common and convenient way to add a PageCatalogPart control to a page is by declaring it in page persistence format. Come per qualsiasi controllo CatalogPart dichiarativo PageCatalogPart , un controllo deve essere dichiarato all'interno del contesto appropriato degli elementi di markup ASP.NET in una pagina Web.As with any declarative CatalogPart control, a PageCatalogPart control must be declared within the proper context of ASP.NET markup elements on a Web page. Per un esempio di codice funzionante su come dichiarare un PageCatalogPart controllo in una pagina Web, vedere la sezione esempio di questo argomento.For a working code example of how to declare a PageCatalogPart control in a Web page, see the Example section of this topic. È necessario aggiungere la sequenza di elementi dichiarativi seguente alla pagina:You must add the following sequence of declarative elements to the page:

  1. È <asp:catalogzone> necessario dichiarare un elemento e aggiungervi un <zonetemplate> elemento figlio in modo che contenga tutti CatalogPart i controlli dichiarati nella zona.An <asp:catalogzone> element must be declared, and a child <zonetemplate> element must be added to it to contain any CatalogPart controls declared in the zone.

  2. È <asp:pagecatalogpart> necessario aggiungere un elemento come figlio <zonetemplate> dell'elemento.An <asp:pagecatalogpart> element must be added as a child of the <zonetemplate> element. Potrebbero essere presenti anche altri CatalogPart controlli dichiarati come elementi figlio <zonetemplate> dell'elemento, DeclarativeCatalogPart inclusi ImportCatalogPart i controlli o.There might also be other CatalogPart controls declared as child elements of the <zonetemplate> element, including DeclarativeCatalogPart or ImportCatalogPart controls.

La PageCatalogPart classe dispone di una sola proprietà utilizzabile Title , ovvero la proprietà, che esegue l'override della proprietà di base in modo che sia possibile fornire un titolo predefinito per il catalogo della pagina se non viene fornito alcun valore.The PageCatalogPart class has only one usable property, the Title property, which overrides the base property so that a default title can be provided for the page catalog if no value is supplied.

Le proprietà rimanenti per PageCatalogPart la classe eseguono l'override delle proprietà ereditate, ma non vengono effettivamente utilizzate per il rendering del controllo.The remaining properties for the PageCatalogPart class override the inherited properties, but are not actually used for rendering the control. 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.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, because 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 PageCatalogPart classe dispone inoltre di alcuni metodi importanti.The PageCatalogPart class also has several important methods. Il GetAvailableWebPartDescriptions metodo recupera un WebPartDescription oggetto per ogni WebPart controllo nel catalogo della pagina, che consente a PageCatalogPart un controllo di visualizzare informazioni su ogni controllo server senza dover creare un'istanza di tale controllo.The GetAvailableWebPartDescriptions method retrieves a WebPartDescription object for each WebPart control in the page catalog, which enables a PageCatalogPart control to display information about each server control without having to create an instance of that control. 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.

AccessibilitàAccessibility

Il markup di cui è stato eseguito il rendering per impostazione predefinita per questo controllo potrebbe non essere conforme agli standard di accessibilità quali le linee guida per l'accessibilità del contenuto Web 1,0 (WCAG).The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. Per informazioni dettagliate sul supporto per l'accessibilità per questo controllo, vedere controlli e accessibilità di ASP.NET.For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Costruttori

PageCatalogPart()

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 PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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 PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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)
Width

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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

Questa proprietà ereditata non è utilizzata dall'insieme di controlli Web part quando viene eseguito il rendering di un controllo PageCatalogPart.This inherited property is not used by the Web Parts control set when rendering a PageCatalogPart 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