CatalogZoneBase Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит базовым классом для всех элементов управления зоны, которые действуют в качестве каталогов. Каталоги содержат списки элементов управления WebPart, которые пользователи могут добавлять на веб-страницу.
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
- Наследование
- Производный
- Реализации
Примеры
В следующем примере кода демонстрируется несколько декларативных и программных применений CatalogZoneBase класса . Поскольку класс является абстрактным, в примерах кода используется производный CatalogZone класс, который поставляется с набором элементов управления веб-частей, демонстрируя свойства и методы, которые он наследует от CatalogZoneBase класса .
Пример кода состоит из четырех частей:
Пользовательский элемент управления, позволяющий изменять режимы отображения на веб-странице.
Веб-страница, содержащая ссылку на CatalogZone элемент управления и код, демонстрирующий использование некоторых членов ключевых CatalogZoneBase классов.
Пользовательский WebPart элемент управления, добавляемый в пользовательский CatalogZone элемент управления.
Описание работы примера в браузере.
Первая часть этого примера кода — это пользовательский элемент управления, позволяющий изменять режимы отображения на странице. Дополнительные сведения о режимах отображения и описание исходного кода в этом элементе управления см. в разделе Пошаговое руководство. Изменение режимов отображения на странице веб-частей.
<%@ 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>
Вторая часть примера кода — это веб-страница, содержащая декларативную ссылку на CatalogZone элемент управления . В верхней части страницы находятся две Register
директивы: одна для пользовательского элемента управления и одна для пользовательского WebPart элемента управления. Обратите внимание, что под <asp:WebPartZone>
элементом <asp: CatalogZone>
находится элемент , содержащий декларативные ссылки на пользовательский WebPart элемент управления и на элемент управления ASP.NET Calendar . Зона также имеет множество тегов и свойств, заданных для определения ее внешнего вида и поведения. <script>
Между тегами на странице находится разнообразный код обработки событий, большинство из которых демонстрирует различные программные способы использования CatalogZoneBase членов.
<%@ 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>
Третья часть примера кода — это пользовательский WebPart элемент управления с именем TextDisplayWebPart
. Он объявляется в пределах зоны, и пользователь может добавить его из каталога на страницу. Для выполнения примера кода необходимо скомпилировать этот исходный код. Ее можно скомпилировать явным образом и поместить полученную сборку в папку Bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически компилироваться во время выполнения. Демонстрацию обоих методов компиляции см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.
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
Обратите внимание, что для работы примера кода необходимо добавить параметр в файл Web.config, чтобы включить экспорт файлов описания веб-частей. Убедитесь, что файл Web.config в том же каталоге, что и веб-страница для этого примера кода. <system.web>
В разделе убедитесь, что имеется <webParts>
элемент с атрибутом enableExport
, равным true
, как показано в следующей разметке.
<webParts enableExport="true">
...
</webParts>
При загрузке страницы в браузере можно выбрать Каталог в раскрывающемся списке, чтобы переключиться в режим отображения каталога. Когда каталог отображается, можно увидеть два серверных элемента управления, которые можно добавить из каталога на страницу, а также заметить в пользовательском интерфейсе эффекты декларативного и программного CatalogZoneBase использования членов класса.
Комментарии
Класс CatalogZoneBase является базовым классом, наследующим от ToolZone класса . Он предоставляет базовый набор поведений для производных зон.
Класс CatalogZoneBase предоставляет уникальный пользовательский интерфейс, который позволяет пользователям добавлять WebPart элементы управления и другие серверные элементы управления на веб-страницы. Элементы управления, производные CatalogZoneBase от класса , такие как CatalogZone, фактически размещаются на веб-страницах. Они действуют как контейнеры для других элементов управления, называемых CatalogPart элементами управления, которые создают списки серверных элементов управления, которые пользователи могут добавлять на страницу. Зоны, производные от класса , CatalogZoneBase могут отображаться только в том случае, если страница находится в режиме отображения каталога.
Примечание
Зона CatalogZoneBase может содержать только CatalogPart элементы управления, и наоборот, CatalogPart элементы управления могут находиться только в CatalogZoneBase зонах.
Механизмом добавления серверных элементов управления в каталог является следующий набор из трех элементов управления, производных от базового CatalogPart класса.
Control | Описание |
---|---|
PageCatalogPart | Сохраняет ссылки на элементы управления, закрытые на странице. Эти элементы управления могут быть повторно открыты (добавлены на страницу) пользователями. |
DeclarativeCatalogPart | Содержит ссылки на элементы управления, объявленные в каталоге веб-частей в разметке веб-страницы. Эти элементы управления могут добавляться на веб-страницу пользователями. |
ImportCatalogPart | Предоставляет пользователю пользовательский интерфейс для отправки файла определения в каталог, чтобы элемент управления можно было добавить на веб-страницу. Файлы определения — это XML-файл с . Расширение имени файла веб-части, которое импортирует параметры для элемента управления. Элемент управления должен присутствовать на сервере, прежде чем можно будет импортировать файл определения. |
Класс CatalogZoneBase имеет ряд свойств, которые полезны для отображения каталогов WebPart элементов управления. Свойство AddVerb ссылается на команду, которая добавляет выбранный элемент управления из каталога на страницу, а CloseVerb свойство ссылается на команду, которая закрывает каталог и возвращает режим отображения страницы в режиме просмотра. Свойство CatalogParts ссылается на коллекцию всех CatalogPart элементов управления в зоне. Некоторые текстовые свойства, такие как EmptyZoneText, HeaderTextи InstructionText, переопределяют базовые свойства, чтобы предоставить текст по умолчанию, подходящий для каталогов. Свойство SelectTargetZoneText содержит текст вместе с элементом управления раскрывающимся списком, который позволяет пользователям выбирать зону, в которую будет добавлен элемент управления.
Несколько других свойств включены в CatalogZoneBase класс . Свойство SelectedCatalogPartID является уникальным строковым идентификатором для выбранного CatalogPart в данный момент элемента управления. Свойство ShowCatalogIcons указывает, следует ли отображать значки, которые могут быть связаны с элементами управления, задавая CatalogIconImageUrl свойство для WebPart элемента управления .
Свойство PartLinkStyle содержит атрибуты стиля для ссылок CatalogPart на элементы управления, которые в настоящее время не выбраны в зоне. В отличие от этого, SelectedPartLinkStyle свойство содержит атрибуты стиля для ссылки на CatalogPart элемент управления, выбранный пользователем в данный момент в зоне.
Помимо свойств, в CatalogZoneBase классе есть также некоторые методы, а также стандартные методы обработки событий и отрисовки, унаследованные от других базовых элементов управления, которые уникально разработаны для обработки каталогов элементов управления. Метод CreateCatalogPartChrome создает хром (периферийные элементы пользовательского интерфейса, такие как граница, глаголы, значки и заголовок), который окружает каждый CatalogPart элемент управления в зоне, а также обрабатывает отрисовку элементов управления. Метод CreateCatalogParts является абстрактным методом; производные классы переопределяют его для создания экземпляров всех CatalogPart элементов управления, содержащихся в зоне. Метод InvalidateCatalogParts может вызываться производным классом, если коллекция CatalogPart элементов управления в зоне меняется по какой-либо программной причине, а производный класс должен воссоздать коллекцию. Метод LoadPostData загружает ранее существующее состояние для полей проверка рядом с WebPart элементами управления в каталоге при отправке страницы обратно на сервер. И наоборот, SaveControlState метод сохраняет состояние полей проверка. Наконец, RenderCatalogPartLinks метод предоставляет все отрисовки для ссылок на каждый CatalogPart элемент управления, содержащийся в зоне.
Примечания для тех, кто реализует этот метод
Если вы хотите разработать настраиваемую зону для размещения CatalogPart элементов управления, необходимо определить, хотите ли вы предоставлять поддержку шаблона зоны. Шаблон зоны создается типами, реализующими ITemplate интерфейс , и необходим, если вы хотите разрешить разработчикам страниц, использующим настраиваемую зону, ссылаться на CatalogPart элементы управления в пределах зоны в декларативной разметке веб-страницы. Если требуется поддержка шаблона зоны, следует наследовать от CatalogZone класса . В отличие от этого, если пользовательская зона и ее CatalogPart элементы управления будут автономными и будут создаваться программными средствами без каких-либо параметров для разработчиков страниц для декларативного указания элементов управления в шаблоне зоны, вы можете наследовать непосредственно от CatalogZoneBase класса . При наследовании от CatalogZoneBase класса необходимо переопределить CreateCatalogParts() метод и добавить WebPart в объект или другие серверные элементы управления в каталоге CatalogPartCollection .
Конструкторы
CatalogZoneBase() |
Инициализирует класс для использования экземпляром унаследованного класса. Этот конструктор может вызываться только унаследованным классом. |
Свойства
AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
AddVerb |
Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям добавлять элементы управления из каталога на страницу веб-частей. |
AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
AssociatedDisplayModes |
Получает коллекцию объектов WebPartDisplayMode, которые сопоставлены с некоторой зоной ToolZone. (Унаследовано от ToolZone) |
Attributes |
Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
BackColor |
Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl) |
BackImageUrl |
Получает или задает URL-адрес фонового изображения для зоны. (Унаследовано от WebZone) |
BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
BorderColor |
Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl) |
BorderStyle |
Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl) |
BorderWidth |
Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl) |
CatalogPartChrome |
Получает ссылку на экземпляр класса CatalogPartChrome, который сопоставлен с зоной CatalogZoneBase. |
CatalogParts |
Получает коллекцию всех элементов управления CatalogPart, содержащихся в зоне CatalogZoneBase. |
ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
CloseVerb |
Возвращает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога и переключать страницу в обычный режим отображения. |
Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
Controls |
Возвращает объект ControlCollection, содержащий дочерние элементы CompositeControl. (Унаследовано от CompositeControl) |
ControlStyle |
Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
ControlStyleCreated |
Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
CssClass |
Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl) |
DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
Display |
Получает значение, показывающее, отображается ли в текущий момент элемент управления ToolZone. (Унаследовано от ToolZone) |
EditUIStyle |
Получает атрибуты стиля для редактируемых элементов управления, содержащихся в элементе управления ToolZone. (Унаследовано от ToolZone) |
EmptyZoneText |
Получает или задает сообщение, которое появляется, когда в зоне нет элементов управления. |
EmptyZoneTextStyle |
Получает атрибуты стиля для текста местозаполнителя в пустой зоне. (Унаследовано от WebZone) |
Enabled |
Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl) |
EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
ErrorStyle |
Получает атрибуты стиля для отрисовки сообщения об ошибке, которое отображается, если элемент управления WebPart не может быть загружен или создан. (Унаследовано от WebZone) |
Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
Font |
Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl) |
FooterStyle |
Получает атрибуты стиля для содержимого области нижнего колонтитула зоны. (Унаследовано от WebZone) |
ForeColor |
Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl) |
HasAttributes |
Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl) |
HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
HasFooter |
Получает значение, указывающее, содержится ли в зоне область нижнего колонтитула. (Унаследовано от WebZone) |
HasHeader |
Получает значение, указывающее, содержит ли зона область заголовка. (Унаследовано от WebZone) |
HeaderCloseVerb |
Получает ссылку на объект WebPartVerb в верхнем колонтитуле зоны ToolZone, который используется для закрытия элемента управления. (Унаследовано от ToolZone) |
HeaderStyle |
Получает атрибуты стиля для содержимого области заголовка зоны. (Унаследовано от WebZone) |
HeaderText |
Получает или задает текст для области заголовка зоны. |
HeaderVerbStyle |
Получает атрибуты стиля для всех команд верхнего колонтитула, отображаемых в элементе управления ToolZone. (Унаследовано от ToolZone) |
Height |
Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl) |
ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
InstructionText |
Получает или задает текст в зоне, содержащий указания для пользователей. |
InstructionTextStyle |
Получает атрибуты стиля для текста инструкций, выводящегося в верхней части элемента управления ToolZone. (Унаследовано от ToolZone) |
IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
IsEnabled |
Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl) |
IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
LabelStyle |
Получает атрибуты стиля для содержимого меток, выводимых рядом с элементами управления редактирования в элементе управления ToolZone. Производные элементы управления ToolZone, такие как CatalogZone и EditorZone, применяют стили к меткам. (Унаследовано от ToolZone) |
LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
Padding |
Получает или задает атрибуты поля ячейки в таблице зоны, содержащей элементы управления WebPart. (Унаследовано от WebZone) |
Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
PartChromePadding |
Получает или задает расстояние между содержимым элемента управления WebPart и границей элемента управления. (Унаследовано от WebZone) |
PartChromeStyle |
Получает характеристики стиля, применяемые к границам элементов управления веб-частей, содержащихся в зоне. (Унаследовано от WebZone) |
PartChromeType |
Получает или задает тип границы, которая обрамляет элементы управления веб-частей, содержащихся в зоне. (Унаследовано от WebZone) |
PartLinkStyle |
Получает объект, содержащий атрибуты стиля для элементов управления CatalogPart, которые в настоящее время выбраны на странице. |
PartStyle |
Получает характеристики стиля, которые применяются к границе и содержимому каждого элемента управления веб-частей, содержащегося в зоне. (Унаследовано от WebZone) |
PartTitleStyle |
Поучает атрибуты стиля для содержимого заголовка окна каждого элемента управления, содержащегося в зоне. (Унаследовано от WebZone) |
RenderClientScript |
Получает значение, которое указывает, следует ли отрисовывать клиентский скрипт на веб-странице. (Унаследовано от WebZone) |
RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
SelectedCatalogPartID |
Получает или задает строку в качестве идентификатора текущего выбранного элемента управления CatalogPart в зоне. |
SelectedPartLinkStyle |
Получает объект, который содержит атрибуты стиля для выбранного в настоящий момент элемента управления CatalogPart в зоне. |
SelectTargetZoneText |
Получает или задает текст для элемента управления в пользовательском интерфейсе каталога, с помощью которого пользователи могут выбрать, в какую зону можно добавить выбранные элементы управления. |
ShowCatalogIcons |
Получает или задает значение, указывающее, отображаются ли значки для серверных элементов управления в каталоге. |
Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl) |
Style |
Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl) |
SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl) |
TagKey |
Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebZone) |
TagName |
Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
ToolTip |
Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl) |
UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
VerbButtonType |
Получает или задает тип кнопки, используемый для представления команд в зоне. (Унаследовано от WebZone) |
VerbStyle |
Получает атрибуты стиля для команд пользовательского интерфейса, связанного с элементами управления веб-частей в зоне. (Унаследовано от WebZone) |
ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
Visible |
Получает или задает значение, определяющее, выводится ли серверный элемент управления на странице в виде элемента пользовательского интерфейса. (Унаследовано от ToolZone) |
WebPartManager |
Получает ссылку на элемент управления WebPartManager, связанный с экземпляром элемента управления WebZone на странице веб-частей. (Унаследовано от WebZone) |
Width |
Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl) |
Методы
AddAttributesToRender(HtmlTextWriter) |
Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
ApplyStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl) |
ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
Close() |
Переключает веб-страницу из режима отображения каталога в обычный режим просмотра. |
CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
CreateCatalogPartChrome() |
Создает экземпляр объекта CatalogPartChrome, используемого для отрисовки периферийных элементов пользовательского интерфейса для элементов управления CatalogPart в зоне. |
CreateCatalogParts() |
Содержит объявление базового метода, который можно переопределить в производных зонах, чтобы изменить частные аспекты создания элементов управления CatalogPart, содержащихся в зоне. |
CreateChildControls() |
Создает набор дочерних элементов управления, сопоставленных с зоной CatalogZoneBase. |
CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
CreateControlStyle() |
Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
DataBind() |
Привязывает источник данных к CompositeControl и ко всем его дочерним элементам управления. (Унаследовано от CompositeControl) |
DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
GetEffectiveChromeType(Part) |
Возвращает фактическое или эффективное текущее значение PartChromeType элемента управления WebPart, учитывая свойство PartChromeType зоны и текущий режим отображения страницы веб-частей. (Унаследовано от WebZone) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
GetRouteUrl(String, Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
GetRouteUrl(String, RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
GetUniqueIDRelativeTo(Control) |
Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control) |
HasControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control) |
HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления. (Унаследовано от Control) |
InvalidateCatalogParts() |
Уничтожает коллекцию элементов управления CatalogPart, связанную с зоной CatalogZoneBase. |
IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
LoadControlState(Object) |
Загружает состояние из предыдущего запроса страницы для свойств элемента управления, которые должны быть постоянными в обратных запросах, даже если для элемента управления отключено состояние просмотра. |
LoadPostData(String, NameValueCollection) |
Обрабатывает состояние флажков, соответствующих элементам управления WebPart в каталоге, при обратном запросе страницы на сервер. |
LoadViewState(Object) |
Загружает ранее сохраненные сведения о состоянии для зоны. |
MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать аспекты изменения режимов отображения страницы для специальной зоны. (Унаследовано от ToolZone) |
OnInit(EventArgs) |
Регистрирует объект страницы, чтобы страница нуждалась в состоянии элемента управления. |
OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
OnPreRender(EventArgs) |
Создает событие PreRender и регистрирует объект страницы, чтобы были необходимы обратные запросы. |
OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать событие изменения элемента управления веб-частей, выбранного в специальной зоне. (Унаследовано от ToolZone) |
OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
RaisePostBackEvent(String) |
Выполняет действия, сопоставленные с одной из команд зоны, или вызывает событие, выполняющее обратную передачу на сервер. |
RecreateChildControls() |
Воссоздает дочерние элементы элемента управления, являющегося наследником CompositeControl. (Унаследовано от CompositeControl) |
RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
Render(HtmlTextWriter) |
Отображает зону в указанном объекте HtmlTextWriter. |
RenderBeginTag(HtmlTextWriter) |
Отрисовывает HTML-тег открытия элемента управления зоны для указанного объекта HtmlTextWriter. (Унаследовано от WebZone) |
RenderBody(HtmlTextWriter) |
Переопределяет базовый метод, чтобы отобразить основную область зоны, производной от класса CatalogZoneBase. |
RenderCatalogPartLinks(HtmlTextWriter) |
Отрисовывает ссылки на отдельные элементы управления CatalogPart в зоне CatalogZoneBase. |
RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
RenderContents(HtmlTextWriter) |
Отрисовывает все содержимое элемента управления зоны между начальным и конечным тегами для указанного объекта HtmlTextWriter. (Унаследовано от WebZone) |
RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
RenderFooter(HtmlTextWriter) |
Отрисовывает нижний колонтитул для зоны CatalogZoneBase. |
RenderHeader(HtmlTextWriter) |
Переопределяет базовый метод, чтобы выполнить специальные операции отрисовки для области верхнего колонтитула, необходимые для элементов управления ToolZone. (Унаследовано от ToolZone) |
RenderVerb(HtmlTextWriter, WebPartVerb) |
Отображает отдельную команду в элементе управления ToolZone. (Унаследовано от ToolZone) |
RenderVerbs(HtmlTextWriter) |
Отрисовывает команды в области нижнего колонтитула зоны CatalogZoneBase. |
ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
SaveControlState() |
Сохраняет изменения в состоянии элемента управления CatalogZoneBase, которые произошли после обратного запроса веб-страницы на сервер. |
SaveViewState() |
Сохраняет изменения состояния просмотра, произошедшие с момента отправки страницы обратно на сервер. |
SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
TrackViewState() |
Отслеживает изменения состояния просмотра элемента управления зоны. |
События
DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
Методы расширения
FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
GetDefaultValues(INamingContainer) |
Получает коллекцию значений по умолчанию для заданного элемента управления данными. |
GetMetaTable(INamingContainer) |
Получает метаданные таблицы для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
EnableDynamicData(INamingContainer, Type) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по