Condividi tramite

CatalogZoneBase Classe

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Funge da classe base per tutti i controlli zona che fungono da cataloghi. I cataloghi contengono elenchi di WebPart controlli che gli utenti possono aggiungere a una pagina Web.

public ref class CatalogZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone, System::Web::UI::IPostBackDataHandler
public abstract class CatalogZoneBase : System.Web.UI.WebControls.WebParts.ToolZone, System.Web.UI.IPostBackDataHandler
type CatalogZoneBase = class
    inherit ToolZone
    interface IPostBackDataHandler
Public MustInherit Class CatalogZoneBase
Inherits ToolZone
Implements IPostBackDataHandler
Ereditarietà
Object
Control
WebControl
CompositeControl
WebZone
ToolZone
CatalogZoneBase
Derivato
Implementazioni
IPostBackDataHandler

Esempio

Nell'esempio di codice seguente vengono illustrati diversi usi dichiarativi e programmatici della CatalogZoneBase classe . Poiché la classe è astratta, gli esempi di codice usano la classe derivata CatalogZone fornita con il set di controlli Web part, dimostrando le proprietà e i metodi che eredita dalla CatalogZoneBase classe .

L'esempio di codice ha quattro parti:

  • Controllo utente che consente di modificare le modalità di visualizzazione nella pagina Web.

  • Pagina Web contenente un riferimento a un CatalogZone controllo e un codice che illustra l'utilizzo di alcuni membri della classe chiave CatalogZoneBase .

  • Controllo personalizzato WebPart aggiunto al controllo personalizzato CatalogZone .

  • Descrizione del funzionamento dell'esempio in un browser.

La prima parte di questo esempio di codice è il controllo utente che consente di modificare le modalità di visualizzazione nella pagina. Per informazioni dettagliate sulle modalità di visualizzazione e una descrizione del codice sorgente in questo controllo, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina web part.

<%@ 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 è una pagina Web che contiene un riferimento dichiarativo a un CatalogZone controllo . Nella parte superiore della pagina sono presenti due Register direttive: una per il controllo utente e una per il controllo personalizzato WebPart . Si noti che sotto l'elemento <asp:WebPartZone> è un <asp: CatalogZone> elemento che contiene riferimenti dichiarativi al controllo personalizzato WebPart e a un controllo ASP.NET Calendar . La zona include anche un'ampia gamma di tag e proprietà impostate per determinarne l'aspetto e il comportamento. Tra i <script> tag nella pagina è presente un'ampia gamma di codice di gestione degli eventi, la maggior parte dei quali illustra i vari usi programmatici dei CatalogZoneBase membri.

<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenucs.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="TextDisplayWebPartCS" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  WebPartManager manager;

  protected void WebPartManager1_DisplayModeChanged(object sender,
    WebPartDisplayModeEventArgs e)
  {
    if (e.OldDisplayMode.Name != "Catalog")
      Panel1.Visible = true;
    else
      Panel1.Visible = false;
  }
  
  // <snippet3>
  protected void Button1_Click(object sender, EventArgs e)
  {
    if (CatalogZone1.AddVerb.Enabled)
    {
      CatalogZone1.AddVerb.Enabled = false;
      CatalogZone1.CloseVerb.Enabled = false;
    }
    else
    {
      CatalogZone1.AddVerb.Enabled = true;
      CatalogZone1.CloseVerb.Enabled = true;
    }
  }
  // </snippet3>

  // <snippet4>
  protected void Button2_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h3>CatalogPart List</h3>";
    foreach(CatalogPart part in CatalogZone1.CatalogParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet4>

  // <snippet5>
  protected void Button3_Click(object sender, EventArgs e)
  {
    CatalogZone1.SelectTargetZoneText = "Add to zone";
    CatalogZone1.EmptyZoneText = "Zone is empty";
    CatalogZone1.HeaderText = "My Updated Header";
    CatalogZone1.InstructionText = "My Updated Instructions";
  }
  // </snippet5>

  // <snippet6>
  protected void Button4_Click(object sender, EventArgs e)
  {
    Label1.Text = CatalogZone1.SelectedCatalogPartID;
  }
  // </snippet6>

  // <snippet7>
  protected void Button5_Click(object sender, EventArgs e)
  {
    CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
    CatalogZone1.SelectedPartLinkStyle.ForeColor = 
      System.Drawing.Color.Blue;
  }
  // </snippet7>

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <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"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

<%@ page language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuvb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="TextDisplayWebPartVB" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">


  Dim manager As WebPartManager


  Protected Sub WebPartManager1_DisplayModeChanged(ByVal sender _
    As Object, ByVal e As WebPartDisplayModeEventArgs)
    If e.OldDisplayMode.Name <> "Catalog" Then
      Panel1.Visible = True
    Else
      Panel1.Visible = False
    End If

  End Sub
   
  ' <snippet3>
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    If CatalogZone1.AddVerb.Enabled Then
      CatalogZone1.AddVerb.Enabled = False
      CatalogZone1.CloseVerb.Enabled = False
    Else
      CatalogZone1.AddVerb.Enabled = True
      CatalogZone1.CloseVerb.Enabled = True
    End If

  End Sub
  ' </snippet3>
  
  ' <snippet4>
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = "<h3>CatalogPart List</h3>"
    Dim part As CatalogPart
    For Each part In CatalogZone1.CatalogParts
      Label1.Text += part.ID + "<br />"
    Next part

  End Sub
  ' </snippet4>
  
  ' <snippet5>
  Protected Sub Button3_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.SelectTargetZoneText = "Add to zone"
    CatalogZone1.EmptyZoneText = "Zone is empty"
    CatalogZone1.HeaderText = "My Updated Header"
    CatalogZone1.InstructionText = "My Updated Instructions"
  End Sub
  ' </snippet5>
  
  ' <snippet6>
  Protected Sub Button4_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = CatalogZone1.SelectedCatalogPartID
  End Sub
  ' </snippet6>
  
  ' <snippet7>
  Protected Sub Button5_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.PartLinkStyle.ForeColor = _
      System.Drawing.Color.Red
    CatalogZone1.SelectedPartLinkStyle.ForeColor = _
      System.Drawing.Color.Blue
  End Sub
  ' </snippet7>
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <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"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

La terza parte dell'esempio di codice è il controllo personalizzato WebPart denominato TextDisplayWebPart. Viene dichiarata all'interno della zona e un utente finale può aggiungerlo dal catalogo alla pagina. Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella Bin del sito Web o nella Global Assembly Cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato in modo dinamico in fase di esecuzione. Per una dimostrazione di entrambi i metodi di compilazione, vedere Procedura dettagliata: sviluppo e uso di un controllo server Web personalizzato.

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

Si noti che per il funzionamento dell'esempio di codice è necessario aggiungere un'impostazione nel file Web.config per consentire l'esportazione di file di descrizione web part. Assicurarsi di disporre di un file Web.config nella stessa directory della pagina Web per questo esempio di codice. All'interno della <system.web> sezione verificare che sia presente un elemento con un <webParts>enableExport attributo impostato su true, come nel markup seguente.

<webParts enableExport="true">

...

</webParts>

Quando si carica la pagina in un browser, è possibile selezionare Catalogo dalla casella di riepilogo a discesa per passare alla modalità di visualizzazione del catalogo. Quando il catalogo è visibile, è possibile visualizzare i due controlli server che possono essere aggiunti dal catalogo alla pagina ed è anche possibile notare nell'interfaccia utente gli effetti degli usi dichiarativi e programmatici dei membri della CatalogZoneBase classe.

Commenti

La CatalogZoneBase classe è una classe base che eredita dalla ToolZone classe . Fornisce un set di comportamenti di base per le zone derivate.

La CatalogZoneBase classe fornisce un'interfaccia utente univoca che consente agli utenti di aggiungere WebPart controlli e altri controlli server alle pagine Web. I controlli che derivano dalla CatalogZoneBase classe , ad esempio CatalogZone, sono i controlli effettivamente posizionati nelle pagine Web. Fungono da contenitori per altri controlli, noti come CatalogPart controlli, che creano elenchi di controlli server che gli utenti possono aggiungere a una pagina. Le zone che derivano dalla CatalogZoneBase classe possono essere visualizzate solo quando la pagina è in modalità di visualizzazione del catalogo.

Annotazioni

Una CatalogZoneBase zona può contenere solo CatalogPart controlli e viceversa i CatalogPart controlli possono risiedere solo nelle CatalogZoneBase zone.

Il meccanismo per l'aggiunta di controlli server a un catalogo è il set seguente di tre controlli che derivano dalla classe base CatalogPart .

Controllo Descrizione
PageCatalogPart Gestisce i riferimenti ai controlli chiusi in una pagina. Questi controlli possono essere riaperti (aggiunti di nuovo alla pagina) dagli utenti.
DeclarativeCatalogPart Contiene riferimenti ai controlli dichiarati in un catalogo web part nel markup di una pagina Web. Questi controlli possono essere aggiunti a una pagina Web dagli utenti.
ImportCatalogPart Fornisce l'interfaccia utente per consentire a un utente di caricare un file di definizione in un catalogo in modo che il controllo possa essere aggiunto a una pagina Web. I file di definizione sono file XML con un oggetto . Estensione del nome file WebPart che importa le impostazioni per un controllo. Il controllo deve essere presente nel server prima che il file di definizione possa essere importato.

La CatalogZoneBase classe ha una serie di proprietà utili per la visualizzazione di cataloghi di WebPart controlli. La AddVerb proprietà fa riferimento al verbo che aggiunge un controllo selezionato dal catalogo alla pagina, mentre la CloseVerb proprietà fa riferimento a un verbo che chiude il catalogo e restituisce la modalità di visualizzazione della pagina per la modalità di esplorazione. La CatalogParts proprietà fa riferimento all'insieme di tutti i CatalogPart controlli nella zona. Diverse proprietà orientate al testo, ad esempio EmptyZoneText, HeaderTexte InstructionText, sostituiscono le proprietà di base per fornire il testo predefinito appropriato per i cataloghi. La SelectTargetZoneText proprietà contiene il testo accanto al controllo elenco a discesa che consente agli utenti di scegliere la zona a cui verrà aggiunto un controllo.

Nella classe sono incluse CatalogZoneBase diverse altre proprietà. La SelectedCatalogPartID proprietà è un identificatore di stringa univoco per il controllo attualmente selezionato CatalogPart . La ShowCatalogIcons proprietà indica se visualizzare le icone che possono essere associate ai controlli impostando la CatalogIconImageUrl proprietà su un WebPart controllo .

La PartLinkStyle proprietà contiene attributi di stile per i collegamenti ai CatalogPart controlli che non sono attualmente selezionati nella zona. Al contrario, la SelectedPartLinkStyle proprietà contiene attributi di stile per un collegamento al CatalogPart controllo attualmente selezionato dall'utente nella zona.

Oltre alle proprietà, nella classe sono disponibili anche alcuni metodi CatalogZoneBase , oltre ai metodi standard di gestione e rendering degli eventi ereditati da altri controlli di base, progettati in modo univoco per la gestione dei cataloghi di controlli. Il CreateCatalogPartChrome metodo crea il riquadro (elementi dell'interfaccia utente periferica, ad esempio un bordo, verbi, icone e un titolo) che circonda ogni CatalogPart controllo nella zona e gestisce anche il rendering per i controlli. Il CreateCatalogParts metodo è un metodo astratto. Le classi derivate ne eseguono l'override per creare istanze di tutti i CatalogPart controlli contenuti nella zona. Il InvalidateCatalogParts metodo può essere chiamato da una classe derivata se la raccolta di CatalogPart controlli nella zona cambia per qualche motivo programmatico e la classe derivata deve ricreare la raccolta. Il LoadPostData metodo carica lo stato esistente in precedenza per le caselle di controllo accanto ai WebPart controlli nel catalogo, ogni volta che la pagina viene reinsediata nel server. Al contrario, il SaveControlState metodo salva lo stato delle caselle di controllo. Infine, il RenderCatalogPartLinks metodo fornisce tutto il rendering per i collegamenti a ogni CatalogPart controllo contenuto nella zona.

Note per gli implementatori

Se si vuole sviluppare una zona personalizzata per i controlli di hosting CatalogPart , è necessario determinare se si vuole fornire il supporto dei modelli di zona. Un modello di zona viene creato da tipi che implementano l'interfaccia ITemplate ed è necessario se si desidera consentire agli sviluppatori di pagine di usare la zona personalizzata per fare riferimento CatalogPart ai controlli all'interno della zona nel markup dichiarativo di una pagina Web. Se è necessario il supporto dei modelli di zona, è necessario ereditare dalla CatalogZone classe . Al contrario, se la zona personalizzata e i relativi CatalogPart controlli saranno indipendenti e verranno creati a livello di codice senza alcuna opzione per gli sviluppatori di pagine per specificare i controlli in modo dichiarativo in un modello di zona, è possibile ereditare direttamente dalla CatalogZoneBase classe . Se si eredita dalla CatalogZoneBase classe , è necessario eseguire l'override del CreateCatalogParts() metodo e aggiungere i WebPart controlli server o altri controlli desiderati nel catalogo a un CatalogPartCollection oggetto .

Costruttori

Nome Descrizione
CatalogZoneBase()

Inizializza la classe per l'uso da parte di un'istanza della classe ereditata. Questo costruttore può essere chiamato solo da una classe ereditata.

Proprietà

Nome Descrizione
AccessKey

Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web.

(Ereditato da WebControl)
Adapter

Ottiene l'adattatore specifico del browser per il controllo .

(Ereditato da Control)
AddVerb

Ottiene un riferimento a un WebPartVerb oggetto che consente agli utenti finali di aggiungere controlli da un catalogo a una pagina web part.
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo.

(Ereditato da Control)
AssociatedDisplayModes

Ottiene la raccolta di WebPartDisplayMode oggetti associati a una determinata ToolZone zona.

(Ereditato da ToolZone)
Attributes

Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.

(Ereditato da WebControl)
BackImageUrl

Ottiene o imposta l'URL di un'immagine di sfondo per una zona.

(Ereditato da WebZone)
BindingContainer

Ottiene il controllo che contiene il data binding di questo controllo.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.

(Ereditato da WebControl)
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.

(Ereditato da WebControl)
CatalogPartChrome

Ottiene un riferimento all'istanza della CatalogPartChrome classe associata alla CatalogZoneBase zona.
CatalogParts

Ottiene una raccolta di tutti i CatalogPart controlli contenuti in una CatalogZoneBase zona.
ChildControlsCreated

Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà .

(Ereditato da Control)
ClientIDSeparator

Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà .

(Ereditato da Control)
CloseVerb

Ottiene un riferimento a un WebPartVerb oggetto che consente agli utenti finali di chiudere l'interfaccia utente del catalogo e restituire la pagina alla modalità di esplorazione normale.
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.

(Ereditato da Control)
Controls

Ottiene un ControlCollection oggetto che rappresenta i controlli figlio in un oggetto CompositeControl.

(Ereditato da CompositeControl)
ControlStyle

Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CssClass

Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.

(Ereditato da Control)
Display

Ottiene un valore che indica se un ToolZone controllo è attualmente visualizzato.

(Ereditato da ToolZone)
EditUIStyle

Ottiene gli attributi di stile per i controlli modificabili contenuti in un ToolZone controllo .

(Ereditato da ToolZone)
EmptyZoneText

Ottiene o imposta un messaggio visualizzato quando una zona non contiene controlli.
EmptyZoneTextStyle

Ottiene gli attributi di stile per il testo segnaposto in una zona vuota.

(Ereditato da WebZone)
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se i temi si applicano a questo controllo.

(Ereditato da WebControl)
EnableViewState

Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente.

(Ereditato da Control)
ErrorStyle

Ottiene gli attributi di stile per il rendering del messaggio di errore visualizzato se non è possibile caricare o creare un WebPart controllo.

(Ereditato da WebZone)
Events

Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura.

(Ereditato da Control)
Font

Ottiene le proprietà del tipo di carattere associate al controllo server Web.

(Ereditato da WebControl)
FooterStyle

Ottiene gli attributi di stile per il contenuto dell'area piè di pagina di una zona.

(Ereditato da WebZone)
ForeColor

Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web.

(Ereditato da WebControl)
HasAttributes

Ottiene un valore che indica se il controllo dispone di attributi impostati.

(Ereditato da WebControl)
HasChildViewState

Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate.

(Ereditato da Control)
HasFooter

Ottiene un valore che indica se una zona ha un'area piè di pagina.

(Ereditato da WebZone)
HasHeader

Ottiene un valore che indica se una zona ha un'area di intestazione.

(Ereditato da WebZone)
HeaderCloseVerb

Ottiene un riferimento all'oggetto nell'intestazione WebPartVerb di un ToolZone controllo utilizzato per chiudere il controllo.

(Ereditato da ToolZone)
HeaderStyle

Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona.

(Ereditato da WebZone)
HeaderText

Ottiene o imposta il testo per l'area di intestazione di una zona.
HeaderVerbStyle

Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un ToolZone controllo .

(Ereditato da ToolZone)
Height

Ottiene o imposta l'altezza del controllo server Web.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore programmatico assegnato al controllo server.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.

(Ereditato da Control)
InstructionText

Ottiene o imposta il testo in una zona che fornisce indicazioni per gli utenti finali.
InstructionTextStyle

Ottiene gli attributi di stile per il testo dell'istruzione visualizzato nella parte superiore di un ToolZone controllo.

(Ereditato da ToolZone)
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo.

(Ereditato da Control)
LabelStyle

Ottiene gli attributi di stile per il contenuto delle etichette visualizzate insieme ai controlli di modifica all'interno di un ToolZone controllo . I controlli derivati ToolZone , ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette.

(Ereditato da ToolZone)
LoadViewStateByID

Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice.

(Ereditato da Control)
NamingContainer

Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà.

(Ereditato da Control)
Padding

Ottiene o imposta gli attributi di riempimento delle celle nella tabella che contiene i WebPart controlli in una zona.

(Ereditato da WebZone)
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina.

(Ereditato da Control)
PartChromePadding

Ottiene o imposta la distanza tra il contenuto di un WebPart controllo e il bordo del controllo.

(Ereditato da WebZone)
PartChromeStyle

Ottiene le caratteristiche di stile che si applicano ai bordi dei controlli Web part contenuti in una zona.

(Ereditato da WebZone)
PartChromeType

Ottiene o imposta il tipo di bordo che incornicia i controlli Web part contenuti in una zona.

(Ereditato da WebZone)
PartLinkStyle

Ottiene un oggetto che contiene attributi di stile per i CatalogPart controlli che non sono attualmente selezionati nella zona.
PartStyle

Ottiene le caratteristiche di stile che si applicano al bordo e al contenuto di ogni controllo Web part contenuto da una zona.

(Ereditato da WebZone)
PartTitleStyle

Ottiene gli attributi di stile per il contenuto della barra del titolo per ogni controllo Web part contenuto in una zona.

(Ereditato da WebZone)
RenderClientScript

Ottiene un valore che indica se eseguire il rendering dello script client in una pagina web part.

(Ereditato da WebZone)
RenderingCompatibility

Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile.

(Ereditato da Control)
SelectedCatalogPartID

Ottiene o imposta una stringa come identificatore per il controllo attualmente selezionato CatalogPart in una zona.
SelectedPartLinkStyle

Ottiene un oggetto che contiene attributi di stile per il CatalogPart controllo attualmente selezionato nella zona.
SelectTargetZoneText

Ottiene o imposta il testo insieme al controllo nell'interfaccia utente del catalogo che consente agli utenti di scegliere a quale zona aggiungere i controlli selezionati.
ShowCatalogIcons

Ottiene o imposta un valore che indica se i controlli server nel catalogo visualizzano le icone associate nel catalogo.
Site

Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia da applicare al controllo.

(Ereditato da WebControl)
Style

Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento disabled HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è false.

(Ereditato da CompositeControl)
TabIndex

Ottiene o imposta l'indice della scheda del controllo server Web.

(Ereditato da WebControl)
TagKey

Ottiene il HtmlTextWriterTag valore che corrisponde a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebZone)
TagName

Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene questo controllo.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente.

(Ereditato da Control)
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server.

(Ereditato da Control)
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi.

(Ereditato da Control)
VerbButtonType

Ottiene o imposta il tipo di pulsante utilizzato per rappresentare i verbi in una zona.

(Ereditato da WebZone)
VerbStyle

Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part in una zona.

(Ereditato da WebZone)
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come elemento dell'interfaccia utente nella pagina.

(Ereditato da ToolZone)
WebPartManager

Ottiene un riferimento al controllo associato a un'istanza WebPartManagerWebZone del controllo in una pagina web part.

(Ereditato da WebZone)
Width

Ottiene o imposta la larghezza del controllo server Web.

(Ereditato da WebControl)

Metodi

Nome Descrizione
AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML di cui è necessario eseguire il rendering nell'oggetto specificato HtmlTextWriterTag. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control .

(Ereditato da Control)
AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica le proprietà di stile definite nel foglio di stile della pagina al controllo .

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella ClientID cache su null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.

(Ereditato da Control)
Close()

Passa la pagina Web dalla modalità di visualizzazione del catalogo alla modalità di esplorazione normale.
CopyBaseAttributes(WebControl)

Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateCatalogPartChrome()

Crea un'istanza di un CatalogPartChrome oggetto utilizzato per eseguire il rendering degli elementi dell'interfaccia utente periferica per CatalogPart i controlli in una zona.
CreateCatalogParts()

Fornisce una dichiarazione di metodo di base che le zone derivate possono eseguire l'override per gestire i dettagli della creazione dei CatalogPart controlli contenuti in una zona.
CreateChildControls()

Crea il set di controlli figlio associati a una CatalogZoneBase zona.
CreateControlCollection()

Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server.

(Ereditato da Control)
CreateControlStyle()

Crea l'oggetto stile utilizzato internamente dalla WebControl classe per implementare tutte le proprietà correlate allo stile. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
DataBind()

Associa un'origine CompositeControl dati a e a tutti i relativi controlli figlio.

(Ereditato da CompositeControl)
DataBind(Boolean)

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding .

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati ai controlli figlio del controllo server.

(Ereditato da Control)
Dispose()

Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato un identificatore.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato id e un numero intero, specificato nel pathOffset parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo .

(Ereditato da Control)
FindControl(String)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato id .

(Ereditato da Control)
Focus()

Imposta lo stato attivo dell'input su un controllo .

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati in fase di progettazione per un controllo .

(Ereditato da Control)
GetEffectiveChromeType(Part)

Restituisce il valore corrente PartChromeType effettivo o effettivo di un WebPart controllo, in base alla PartChromeType proprietà dell'area e alla modalità di visualizzazione corrente della pagina Web part.

(Ereditato da WebZone)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL che corrisponde a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.

(Ereditato da Control)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato.

(Ereditato da Control)
HasControls()

Determina se il controllo server contiene controlli figlio.

(Ereditato da Control)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio.

(Ereditato da Control)
InvalidateCatalogParts()

Elimina definitivamente la raccolta di CatalogPart controlli associati a una CatalogZoneBase zona.
IsLiteralContent()

Determina se il controllo server contiene solo contenuto letterale.

(Ereditato da Control)
LoadControlState(Object)

Carica lo stato da una richiesta di pagina precedente per le proprietà del controllo che devono essere mantenute tra i postback anche quando lo stato di visualizzazione è disabilitato nel controllo.
LoadPostData(String, NameValueCollection)

Elabora lo stato delle caselle di controllo che corrispondono ai WebPart controlli nel catalogo, quando la pagina viene pubblicata nuovamente nel server.
LoadViewState(Object)

Carica le informazioni sullo stato salvate in precedenza per una zona.
MapPathSecure(String)

Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MergeStyle(Style)

Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.

(Ereditato da Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Fornisce una dichiarazione di metodo di base che i controlli derivati ToolZone possono eseguire l'override per gestire i dettagli delle modalità di visualizzazione delle pagine modificate per una zona specializzata.

(Ereditato da ToolZone)
OnInit(EventArgs)

Registra l'oggetto pagina in modo che la pagina richieda lo stato del controllo.
OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento e registra l'oggetto PreRender pagina in modo che richieda postback.
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Fornisce una dichiarazione di metodo di base che i controlli derivati ToolZone possono eseguire l'override per gestire l'evento di modifica del controllo web part selezionato all'interno di una zona specializzata.

(Ereditato da ToolZone)
OnUnload(EventArgs)

Genera l'evento Unload.

(Ereditato da Control)
OpenFile(String)

Ottiene un Stream oggetto utilizzato per leggere un file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo.

(Ereditato da Control)
RaisePostBackEvent(String)

Esegue le azioni associate a uno dei verbi di zona o genera un evento che esegue il postback al server.
RecreateChildControls()

Ricrea i controlli figlio in un controllo derivato da CompositeControl.

(Ereditato da CompositeControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control .

(Ereditato da Control)
Render(HtmlTextWriter)

Esegue il rendering della zona nell'oggetto specificato HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto specificato HtmlTextWriter .

(Ereditato da WebZone)
RenderBody(HtmlTextWriter)

Esegue l'override del metodo di base per eseguire il rendering dell'area del corpo di una zona derivata dalla CatalogZoneBase classe .
RenderCatalogPartLinks(HtmlTextWriter)

Esegue il rendering dei collegamenti ai singoli CatalogPart controlli in una CatalogZoneBase zona.
RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering dell'intero contenuto di un controllo zona tra i tag iniziali e finali nell'oggetto specificato HtmlTextWriter .

(Ereditato da WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter .

(Ereditato da Control)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderFooter(HtmlTextWriter)

Esegue il rendering dell'area piè di pagina per una CatalogZoneBase zona.
RenderHeader(HtmlTextWriter)

Esegue l'override del metodo di base per fornire rendering specializzato per l'area di intestazione richiesta dai ToolZone controlli.

(Ereditato da ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Esegue il rendering di un singolo verbo con un ToolZone controllo .

(Ereditato da ToolZone)
RenderVerbs(HtmlTextWriter)

Esegue il rendering dei verbi nell'area piè di pagina di una CatalogZoneBase zona.
ResolveAdapter()

Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un URL utilizzabile nel client richiedente.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche apportate allo stato di un CatalogZoneBase controllo dopo la pubblicazione della pagina Web nel server.
SaveViewState()

Salva tutte le modifiche dello stato di visualizzazione apportate dopo il postback di una pagina al server.
SetDesignModeState(IDictionary)

Imposta i dati in fase di progettazione per un controllo .

(Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.

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

Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TrackViewState()

Tiene traccia delle modifiche apportate allo stato di visualizzazione di un controllo di zona.

Eventi

Nome Descrizione
DataBinding

Si verifica quando il controllo server viene associato a un'origine dati.

(Ereditato da Control)
Disposed

Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET.

(Ereditato da Control)
Init

Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita.

(Ereditato da Control)
Load

Si verifica quando il controllo server viene caricato nell'oggetto Page .

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering.

(Ereditato da Control)
Unload

Si verifica quando il controllo server viene scaricato dalla memoria.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.

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

Imposta un attributo del controllo Web sul nome e sul valore specificati.

(Ereditato da WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Consente a una finestra di progettazione di ricreare la raccolta di controlli figlio del controllo composito nell'ambiente in fase di progettazione.

(Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).

(Ereditato da Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementa il LoadPostData(String, NameValueCollection) metodo chiamando il LoadPostData(String, NameValueCollection) metodo della CatalogZoneBase classe .
IPostBackDataHandler.RaisePostDataChangedEvent()

Per una descrizione di questo membro, vedere RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa il RaisePostBackEvent(String) metodo .

(Ereditato da ToolZone)

Metodi di estensione

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

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type, Object)

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type)

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)

Restituisce l'oggetto metatable per il controllo dati contenitore.
GetDefaultValues(INamingContainer)

Ottiene la raccolta dei valori predefiniti per il controllo dati specificato.
GetMetaTable(INamingContainer)

Ottiene i metadati della tabella per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, Object)

Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable)

Imposta i metadati della tabella per il controllo dati specificato.
TryGetMetaTable(INamingContainer, MetaTable)

Determina se i metadati della tabella sono disponibili.

Si applica a

Vedi anche