CatalogZoneBase Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Serve da classe base per tutti i controlli di zona che fungono da cataloghi. I cataloghi contengono elenchi di controlli WebPart che gli utenti possono aggiungere a una pagina Web.
public ref class CatalogZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone, System::Web::UI::IPostBackDataHandlerpublic abstract class CatalogZoneBase : System.Web.UI.WebControls.WebParts.ToolZone, System.Web.UI.IPostBackDataHandlertype CatalogZoneBase = class
inherit ToolZone
interface IPostBackDataHandlerPublic MustInherit Class CatalogZoneBase
Inherits ToolZone
Implements IPostBackDataHandler- Ereditarietà
- Derivato
- Implementazioni
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, illustrando le proprietà e i metodi ereditati dalla CatalogZoneBase classe.
L'esempio di codice include 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 aggiunto al controllo personalizzato WebPartCatalogZone .
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=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _
_manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
La seconda parte dell'esempio di codice è una pagina Web che contiene un riferimento dichiarativo a un CatalogZone controllo. Nella parte superiore della pagina sono 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 determinare l'aspetto e il comportamento. Tra i <script> tag nella pagina è 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 dichiarato 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 dinamicamente 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 abilitare l'esportazione di file di descrizione web part. Assicurarsi di avere un file Web.config nella stessa directory della pagina Web per questo esempio di codice. All'interno della <system.web> sezione assicurarsi 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 e si può notare anche nell'interfaccia utente gli effetti degli usi dichiarativi e programmatici dei CatalogZoneBase membri della classe.
Commenti
La CatalogZoneBase classe è una classe di 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 inseriti nelle pagine Web. Fungono da contenitori per altri controlli, noti come CatalogPart controlli, che creano elenchi di controlli server per gli utenti da aggiungere a una pagina. Le zone derivate dalla classe possono essere visualizzate solo quando la CatalogZoneBase pagina è in modalità di visualizzazione del catalogo.
Nota
Una CatalogZoneBase zona può contenere solo CatalogPart controlli e, al contrario, CatalogPart i 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 nuovamente 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 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 sia possibile importare il file di definizione. |
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 alla raccolta di tutti i CatalogPart controlli nella zona. Diverse proprietà orientate al testo, ad EmptyZoneTextesempio , HeaderTexte InstructionText, sostituiscono le proprietà di base per fornire il testo predefinito appropriato per i cataloghi. La SelectTargetZoneText proprietà contiene il testo insieme 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 degli eventi e rendering ereditati da altri controlli di base, progettati in modo univoco allo scopo di gestire 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 metodo è un metodo astratto. Le CreateCatalogParts 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 inviata al 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 del modello di zona. Un modello di zona viene creato dai tipi che implementano l'interfaccia ed è necessario se si desidera abilitare gli sviluppatori di pagine usando la ITemplate zona personalizzata per fare riferimento CatalogPart ai controlli all'interno della zona nel markup dichiarativo di una pagina Web. Se è necessario il supporto del modello di zona, è necessario ereditare dalla CatalogZone classe. Al contrario, se la zona personalizzata e CatalogPart i relativi controlli saranno indipendenti e verranno creati a livello di codice senza alcuna opzione per gli sviluppatori di pagine per specificare i controlli dichiarativi in un modello di zona, è possibile ereditare direttamente dalla CatalogZoneBase classe. Se si eredita dalla classe, è necessario eseguire l'override del CatalogZoneBaseCreateCatalogParts() metodo e aggiungere o WebPart altri controlli server desiderati nel catalogo a un CatalogPartCollection oggetto.
Costruttori
| CatalogZoneBase() |
Inizializza la classe per l'uso da parte di un'istanza di una classe ereditata. Questo costruttore può essere chiamato solo da una classe ereditata. |
Proprietà
| AccessKey |
Ottiene o imposta il tasto di scelta che consente di accedere 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 oggetto WebPartVerb 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 contenente questo controllo. (Ereditato da Control) |
| AssociatedDisplayModes |
Ottiene l'insieme di oggetti WebPartDisplayMode associati a una particolare zona ToolZone. (Ereditato da ToolZone) |
| Attributes |
Ottiene l'insieme 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 contenente l'associazione dati del controllo corrente. (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 classe CatalogPartChrome associata alla zona CatalogZoneBase. |
| CatalogParts |
Ottiene un insieme di tutti i controlli CatalogPart contenuti in una zona CatalogZoneBase. |
| ChildControlsCreated |
Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (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 proprietà ClientID. (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control) |
| CloseVerb |
Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di chiudere l'interfaccia utente del catalogo e riportare la pagina in modalità di visualizzazione normale. |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl. (Ereditato da CompositeControl) |
| ControlStyle |
Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ControlStyleCreated |
Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (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 controllo ToolZone è attualmente visualizzato. (Ereditato da ToolZone) |
| EditUIStyle |
Ottiene gli attributi di stile per i controlli modificabili contenuti in un controllo ToolZone. (Ereditato da ToolZone) |
| EmptyZoneText |
Ottiene o imposta un messaggio che viene visualizzato quando un'area 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 al controllo vengono applicati i temi. (Ereditato da WebControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control) |
| ErrorStyle |
Ottiene gli attributi di stile per il rendering del messaggio di errore visualizzato se non è possibile caricare o creare un controllo WebPart. (Ereditato da WebZone) |
| Events |
Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control) |
| Font |
Ottiene le proprietà del carattere associate al controllo server Web. (Ereditato da WebControl) |
| FooterStyle |
Ottiene gli attributi di stile per il contenuto dell'area di 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 sono impostati attributi per il controllo. (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. (Ereditato da Control) |
| HasFooter |
Ottiene un valore che indica se una zona comprende o meno un'area di piè di pagina. (Ereditato da WebZone) |
| HasHeader |
Ottiene un valore che indica se una zona comprende un'area di intestazione. (Ereditato da WebZone) |
| HeaderCloseVerb |
Ottiene un riferimento all'oggetto WebPartVerb nell'intestazione di un controllo ToolZone 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 dell'area di intestazione di un'area. |
| HeaderVerbStyle |
Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un controllo ToolZone. (Ereditato da ToolZone) |
| Height |
Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl) |
| ID |
Ottiene o imposta l'identificatore a livello di codice 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 agli utenti finali. |
| InstructionTextStyle |
Ottiene gli attributi di stile per il testo di istruzioni che appare nella parte superiore di un controllo ToolZone. (Ereditato da ToolZone) |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del 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 allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control) |
| LabelStyle |
Ottiene gli attributi di stile per il contenuto delle etichette che appaiono accanto ai controlli di modifica all'interno di un controllo ToolZone. I controlli ToolZone derivati, ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette. (Ereditato da ToolZone) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (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. (Ereditato da Control) |
| Padding |
Ottiene o imposta gli attributi di spaziatura interna delle celle sulla tabella che contiene i controlli WebPart 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 della pagina. (Ereditato da Control) |
| PartChromePadding |
Ottiene o imposta la distanza tra il contenuto di un controllo WebPart e il bordo del controllo. (Ereditato da WebZone) |
| PartChromeStyle |
Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona. (Ereditato da WebZone) |
| PartChromeType |
Ottiene o imposta il tipo di bordo che delimita i controlli Web part contenuti in una zona. (Ereditato da WebZone) |
| PartLinkStyle |
Ottiene un oggetto contenente gli attributi di stile per i controlli CatalogPart che non sono attualmente selezionati nella zona. |
| PartStyle |
Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona. (Ereditato da WebZone) |
| PartTitleStyle |
Ottiene gli attributi di stile relativi al contenuto della barra del titolo per ogni controllo Web part contenuto in una zona. (Ereditato da WebZone) |
| RenderClientScript |
Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part. (Ereditato da WebZone) |
| RenderingCompatibility |
Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control) |
| SelectedCatalogPartID |
Ottiene o imposta una stringa come identificatore per il controllo CatalogPart attualmente selezionato in una zona. |
| SelectedPartLinkStyle |
Ottiene un oggetto contenente gli attributi di stile per il controllo CatalogPart attualmente selezionato nella zona. |
| SelectTargetZoneText |
Ottiene o imposta il testo con il 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 per i controlli server presenti nel catalogo vengono visualizzate o meno le icone associate. |
| Site |
Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl) |
| Style |
Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl) |
| SupportsDisabledAttribute |
Ottiene un valore che indica se il controllo deve impostare l'attributo |
| TabIndex |
Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl) |
| TagKey |
Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebZone) |
| TagName |
Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| ToolTip |
Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl) |
| UniqueID |
Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (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. (Ereditato da Control) |
| VerbButtonType |
Ottiene o imposta il tipo di pulsante da utilizzare 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 di una zona. (Ereditato da WebZone) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se un controllo server viene o meno sottoposto a rendering come elemento dell'interfaccia utente nella pagina. (Ereditato da ToolZone) |
| WebPartManager |
Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part. (Ereditato da WebZone) |
| Width |
Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl) |
Metodi
| AddAttributesToRender(HtmlTextWriter) |
Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| AddedControl(Control, Int32) |
Chiamato dopo che un controllo figlio viene aggiunto alla raccolta 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 ControlCollection del controllo server. (Ereditato da Control) |
| ApplyStyle(Style) |
Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ApplyStyleSheetSkin(Page) |
Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (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 recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella cache ClientID su |
| 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 proprietà ClientIDMode 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 catalogo alla modalità di visualizzazione normale. |
| 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. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CreateCatalogPartChrome() |
Crea un'istanza di un oggetto CatalogPartChrome utilizzato per il rendering degli elementi periferici dell'interfaccia utente relativi ai controlli CatalogPart di una zona. |
| CreateCatalogParts() |
Fornisce una dichiarazione del metodo base che può essere sottoposta a override dalle zone derivate per gestire i dettagli della creazione dei controlli CatalogPart contenuti in una zona. |
| CreateChildControls() |
Crea il set dei controlli figlio associati a una zona CatalogZoneBase. |
| CreateControlCollection() |
Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control) |
| CreateControlStyle() |
Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| DataBind() |
Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio. (Ereditato da CompositeControl) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control) |
| Dispose() |
Abilita un controllo server alla pulizia finale prima che venga rilasciato 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, li crea. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String) |
Cerca un controllo server nel contenitore dei nomi corrente con il parametro |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro |
| Focus() |
Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control) |
| GetDesignModeState() |
Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control) |
| GetEffectiveChromeType(Part) |
Restituisce il valore PartChromeType corrente effettivo di un controllo WebPart, una volta specificate la proprietà PartChromeType della zona e la modalità di visualizzazione corrente della pagina Web part. (Ereditato da WebZone) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL corrispondente 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 a un nome della route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della proprietà UniqueID 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 eventuali controlli figlio. (Ereditato da Control) |
| InvalidateCatalogParts() |
Elimina in modo permanente l'insieme di controlli CatalogPart associati a una zona CatalogZoneBase. |
| IsLiteralContent() |
Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control) |
| LoadControlState(Object) |
Carica lo stato dalla richiesta di una pagina precedente per le proprietà del controllo che devono persistere durante i postback, anche quando viene disabilitato lo stato di visualizzazione sul controllo. |
| LoadPostData(String, NameValueCollection) |
Elabora lo stato delle caselle di controllo che corrispondono ai controlli WebPart nel catalogo, quando viene eseguito il postback della pagina al server. |
| LoadViewState(Object) |
Carica le informazioni sullo stato precedentemente salvate per una zona. |
| MapPathSecure(String) |
Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (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. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (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. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Fornisce una dichiarazione del metodo base che i controlli ToolZone derivati possono sottoporre a override per gestire i dettagli del cambiamento delle modalità di visualizzazione pagina 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 PreRender e registra l'oggetto pagina in modo che richieda postback. |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Fornisce una dichiarazione del metodo base che i controlli ToolZone derivati possono sottoporre a override per gestire l'evento di cambiare quale 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 oggetto Stream utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control) |
| RaisePostBackEvent(String) |
Esegue le azioni associate a uno dei verbi di zona oppure 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 dalla raccolta Controls dell'oggetto Control. (Ereditato da Control) |
| Render(HtmlTextWriter) |
Esegue il rendering della zona sull'oggetto HtmlTextWriter specificato. |
| RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato. (Ereditato da WebZone) |
| RenderBody(HtmlTextWriter) |
Esegue l'override del metodo base per eseguire il rendering dell'area del corpo di una zona derivata dalla classe CatalogZoneBase. |
| RenderCatalogPartLinks(HtmlTextWriter) |
Esegue il rendering dei collegamenti ai singoli controlli CatalogPart di una zona CatalogZoneBase. |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderContents(HtmlTextWriter) |
Esegue il rendering dell'intero contenuto di un controllo zona compreso tra il tag di inizio e quello di fine sull'oggetto HtmlTextWriter specificato. (Ereditato da WebZone) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control) |
| RenderEndTag(HtmlTextWriter) |
Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| RenderFooter(HtmlTextWriter) |
Esegue il rendering dell'area di piè di pagina relativa a una zona CatalogZoneBase. |
| RenderHeader(HtmlTextWriter) |
Esegue l'override del metodo base per fornire il rendering specializzato per l'area di intestazione richiesto dai controlli ToolZone. (Ereditato da ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Esegue il rendering di un singolo verbo con un controllo ToolZone. (Ereditato da ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Esegue il rendering dei verbi nell'area di piè di pagina di una zona CatalogZoneBase. |
| ResolveAdapter() |
Ottiene l'adattatore del 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 formato utilizzabile dal client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salvare le eventuali modifiche in uno stato del controllo CatalogZoneBase che si verifica dopo il postback della pagina Web al server. |
| SaveViewState() |
Salva tutte le modifiche dello stato di visualizzazione avvenute dopo il reinserimento di una pagina nel server. |
| SetDesignModeState(IDictionary) |
Imposta i dati della 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) |
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. (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. (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 zona. |
Eventi
| DataBinding |
Viene generato quando il controllo server viene associato a un'origine dati. (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. (Ereditato da Control) |
| Init |
Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control) |
| Load |
Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control) |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control) |
| Unload |
Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
Metodi di estensione
| 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 metatabella per il controllo contenitore dei dati. |
| GetDefaultValues(INamingContainer) |
Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato. |
| GetMetaTable(INamingContainer) |
Ottiene i metadati della tabella per il controllo dei dati specificato. |
| SetMetaTable(INamingContainer, MetaTable) |
Imposta i metadati della tabella per il controllo dei dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se sono disponibili i metadati della tabella. |
| EnableDynamicData(INamingContainer, Type) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |
| EnableDynamicData(INamingContainer, Type, Object) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |
Si applica a
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per