CatalogZone Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит основным элементом управления в наборе элементов управления веб-частей для размещения элементов управления CatalogPart на веб-странице.
public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBasepublic class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBasetype CatalogZone = class
inherit CatalogZoneBasePublic Class CatalogZone
Inherits CatalogZoneBase- Наследование
Примеры
В следующем примере кода демонстрируется декларативное и программное использование CatalogZone элемента управления . Пример кода состоит из четырех частей:
Пользовательский элемент управления, позволяющий изменять режимы отображения на веб-странице.
Файл с исходным кодом для пользовательского CatalogZone элемента управления и настраиваемым 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 элементов управления и WebPart . Код элемента CatalogZone управления демонстрирует, как наследовать от CatalogZone класса и настроить его свойства, задав некоторые значения свойств по умолчанию в конструкторе. В исходном коде также показано, как создать пользовательский WebPart класс с именем TextDisplayWebPart. Это элемент управления, связанный с . Файл описания веб-части, импортируемый в этом примере кода. После импорта файла описания с помощью ImportCatalogPart элемента управления на веб-странице вы сможете добавить TextDisplayWebPart элемент управления на страницу, полностью предварительно настроенный, как указано в файле описания.
Чтобы выполнить пример кода, необходимо скомпилировать этот исходный код. Вы можете скомпилировать его явным образом и поместить полученную сборку в папку Bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически компилироваться во время выполнения. В этом примере кода используется динамическая компиляция, поэтому, если вы хотите запустить пример таким образом, присвойте файлу исходного кода имя и добавьте его во вложенную папку 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
{
// Create a customized CatalogZone control by setting
// some properties in the constructor.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class MyCatalogZone : CatalogZone
{
public MyCatalogZone()
{
this.HeaderText = "My Company Catalog";
this.HeaderCloseVerb.Text = "Close Catalog";
this.CloseVerb.Text = "Close Catalog";
}
}
// Create a custom WebPart control to add to a WebPartZone.
[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
' Create a custom CatalogZone control by setting some
' properties in the constructor.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyCatalogZone
Inherits CatalogZone
Public Sub New()
Me.HeaderText = "My Company Catalog"
Me.HeaderCloseVerb.Text = "Close Catalog"
Me.CloseVerb.Text = "Close Catalog"
End Sub
End Class
' Create a custom WebPart to add to a WebPartZone.
<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
Третья часть примера кода — веб-страница, содержащая элементы управления. Он содержит директиву Register для пользовательского элемента управления и другую для исходного файла с пользовательскими элементами управления. Обратите внимание, что во второй директиве она не называет сборку, так как в примере не используется сборка, а используется динамическая компиляция с исходным кодом, помещенным во вложенную папку App_Code. Веб-страница объявляет WebPartZone элемент управления, а в его дочернем <zonetemplate> элементе BulletedList — элемент управления. Хотя это стандартный элемент управления ASP.NET, он будет иметь полную функциональность веб-частей во время выполнения, так как WebPartManager элемент управления заключает в оболочку любой серверный элемент управления, помещенный WebPartZone в , с GenericWebPart объектом , чтобы другие серверные элементы управления могли участвовать в приложениях веб-частей. Кроме того, в этой зоне объявлен пользовательский WebPart элемент управления с именем TextDisplayWebPart. Обратите внимание, что в этом элементе управления объявлен атрибут .ExportMode="All" Это позволяет экспортировать . Файл описания веб-части, содержащий значения свойств элемента управления, которые могут быть импортированы другими пользователями для добавления предварительно настроенного элемента управления на другие веб-страницы.
Примечание
Чтобы пользователи приложения веб-частей могли экспортировать файл описания для WebPart элементов управления, необходимо также включить функцию экспорта в веб-приложении, добавив enableExport="true" атрибут к элементу <webParts> (который является дочерним <system.web> для элемента) в файле Web.config. Экспорт отключен по умолчанию, поэтому, если вы еще не включили экспорт для приложения, измените файл Web.config и сделайте это сейчас.
Веб-страница также объявляет пользовательский CatalogZone элемент управления и элемент, <zonetemplate> содержащий ImportCatalogPart элемент управления. Пользователь будет использовать этот элемент управления во время выполнения для импорта . Файл описания веб-части для пользовательского WebPart элемента управления.
<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" 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>
<aspsample:textdisplaywebpart id="wp1" runat="server"
Title="My Text Display WebPart" />
</ZoneTemplate>
</asp:WebPartZone>
<aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:ImportCatalogPart id="ImportCatalogPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyCatalogZone>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" 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>
<aspsample:textdisplaywebpart id="wp1" runat="server"
Title="My Text Display WebPart" />
</ZoneTemplate>
</asp:WebPartZone>
<aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:ImportCatalogPart id="ImportCatalogPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyCatalogZone>
</form>
</body>
</html>
Теперь запустите пример кода. Загрузите веб-страницу в браузере. Первым шагом является экспорт . Файл описания веб-части для TextDisplayWebPart элемента управления . Щелкните меню глаголов в пользовательском элементе управления (представленном стрелкой вниз в строке заголовка) и нажмите кнопку Экспорт. Следуйте инструкциям, чтобы сохранить файл описания для элемента управления . Откройте . Файл описания веб-части в редакторе и измените значение текста свойства title. <property> Найдите элемент с атрибутом name="Title"и измените текст заголовка, который содержится между открывающим и закрывающим <property> тегами. Теперь закройте веб-страницу и измените источник страницы в редакторе. <aspSample:TextDisplayWebPart> Удалите элемент объявления элемента управления, а затем сохраните и закройте файл.
Снова загрузите веб-страницу в браузере. Элемент TextDisplayWebPart управления не должен отображаться, так как вы удалили его. В раскрывающемся списке Режим отображения выберите Каталог , чтобы переключить страницу в режим каталога. Обратите внимание, что появится пользовательский CatalogZone элемент управления вместе с элементом ImportCatalogPart управления . Нажмите кнопку Обзор , чтобы найти . Файл описания веб-части, экспортируемый TextDisplayWebPart для элемента управления . Вы можете нажать кнопку Отправить, выбрать поле проверка рядом с импортированным элементом управления и нажать кнопку Добавить, чтобы добавить его на страницу. Нажмите кнопку Закрыть каталог , чтобы вернуть страницу в обычный режим просмотра. Импортированный элемент управления должен появиться на странице, а заголовок, отображаемый в строке заголовка элемента управления, должен быть текстом заголовка, добавленным в . Файл описания веб-части.
Комментарии
В наборе элементов управления веб-частей зона — это область на веб-странице, содержащая элементы управления веб-частей. Зона веб-частей создается элементом управления зоны, который является типом, предназначенным CompositeControl для хранения других элементов управления. Основными функциями зоны являются размещение элементов управления, содержащихся в ней, и предоставление общего пользовательского интерфейса для этих элементов управления. Общие сведения о зонах и их использовании в приложениях веб-частей см. в разделах Базовый WebZone класс и Обзор набора элементов управления веб-частей.
Ключевой особенностью элементов управления веб-частей является то, что они позволяют конечным пользователям изменять (или персонализировать) веб-страницы в соответствии с их предпочтениями и сохранять персонализированные параметры для будущих сеансов браузера. Одним из аспектов изменения страниц веб-частей является возможность добавления WebPart элементов управления или других серверных элементов управления на страницу веб-частей. Элемент CatalogZone управления предоставляет список или каталог элементов управления, которые пользователи могут добавлять на страницу.
Элемент CatalogZone управления является одним из основных элементов управления в наборе элементов управления веб-частей. Он является производным CatalogZoneBase от класса , и большая часть его поведения наследуется от этого класса. Класс CatalogZone по сути добавляет к базовому классу шаблон зоны, который является реализацией ITemplate интерфейса. Шаблон зоны позволяет разработчикам декларативно добавлять CatalogPart элементы управления в зону в формате сохраняемости страниц.
Важно!
Зона CatalogZone может содержать только CatalogPart элементы управления, и наоборот, CatalogPart элементы управления могут находиться только в зонах, производных от CatalogZoneBase класса , таких как CatalogZone.
Элемент CatalogZone управления становится видимым, только когда пользователь переключает веб-страницу в режим отображения каталога (CatalogDisplayMode). Каталог может содержать несколько типов CatalogPart элементов управления. Каждый CatalogPart элемент управления является типом контейнера, содержащего серверные элементы управления, которые пользователи могут добавить на страницу. Элементы CatalogPart управления отличаются в зависимости от того, откуда приходят содержащиеся в них серверные элементы управления. В следующей таблице перечислены CatalogPart элементы управления, предоставляемые с набором элементов управления веб-частей, а также сведения о типах серверных элементов управления для каждого элемента управления.
| Control | Описание |
|---|---|
| PageCatalogPart | Сохраняет ссылки на элементы управления, которые были закрыты на странице. Эти элементы управления могут быть повторно открыты (добавлены на страницу) пользователями. |
| DeclarativeCatalogPart | Содержит ссылки на элементы управления, объявленные в каталоге веб-частей в разметке веб-страницы. Эти элементы управления могут добавляться на веб-страницу пользователями. |
| ImportCatalogPart | Предоставляет пользователю пользовательский интерфейс для отправки файла определения (XML-файла с . Расширение WebPart и указанный формат, содержащий сведения о состоянии) для элемента управления в каталоге, чтобы элемент управления можно было добавить на веб-страницу. |
CatalogZone Так как класс добавляет к поведению базового класса только шаблон зоны, он имеет мало членов. Конструктор CatalogZone является конструктором без параметров. С его помощью можно инициализировать CatalogZone новый экземпляр класса . Свойство ZoneTemplate получает или задает ссылку на ITemplate объект , содержащий элементы управления для зоны. Метод CreateCatalogParts является критически важным. Он переопределяет базовый метод для создания коллекции всех CatalogPart элементов управления, содержащихся в шаблоне зоны.
Примечание
Для правильной работы кнопок в пользовательском CatalogZone интерфейсе требуются клиентские скрипты. Если скрипты отключены в браузере, пользователь не сможет выполнять действия через CatalogZone пользовательский интерфейс.
Специальные возможности
Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по обеспечению доступности веб-содержимого 1.0 (WCAG) с приоритетом 1. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в разделе Элементы управления ASP.NET и специальные возможности.
Примечания для тех, кто наследует этот метод
Вы можете создавать пользовательские CatalogZone классы, если требуется больший контроль над отрисовкой и поведением пользовательского интерфейса каталога. Если вам не нужно предоставлять пользователям элемента управления возможность добавлять CatalogPart элементы управления декларативно, вы можете наследовать непосредственно от CatalogZoneBase класса . Если вы хотите, чтобы элементы управления добавлялись декларативно, простой подход заключается в CatalogZone наследовании от класса, так как он предоставляет основной шаблон зоны.
Если вы наследуете CatalogZone от класса , можно переопределить CreateCatalogParts() метод и использовать метод для добавления пользовательских CatalogPart элементов управления в CatalogPartCollection, если требуется более широкий программный контроль над добавлением пользовательских CatalogPart элементов управления в зону.
Конструкторы
| CatalogZone() |
Инициализирует новый экземпляр класса CatalogZone. |
Свойства
| AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
| Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
| AddVerb |
Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям добавлять элементы управления из каталога на страницу веб-частей. (Унаследовано от CatalogZoneBase) |
| 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. (Унаследовано от CatalogZoneBase) |
| CatalogParts |
Получает коллекцию всех элементов управления CatalogPart, содержащихся в зоне CatalogZoneBase. (Унаследовано от CatalogZoneBase) |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| CloseVerb |
Возвращает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога и переключать страницу в обычный режим отображения. (Унаследовано от CatalogZoneBase) |
| 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 |
Получает или задает сообщение, которое появляется, когда в зоне нет элементов управления. (Унаследовано от CatalogZoneBase) |
| 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 |
Получает или задает текст для области заголовка зоны. (Унаследовано от CatalogZoneBase) |
| HeaderVerbStyle |
Получает атрибуты стиля для всех команд верхнего колонтитула, отображаемых в элементе управления ToolZone. (Унаследовано от ToolZone) |
| Height |
Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl) |
| ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
| InstructionText |
Получает или задает текст в зоне, содержащий указания для пользователей. (Унаследовано от CatalogZoneBase) |
| 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, которые в настоящее время выбраны на странице. (Унаследовано от CatalogZoneBase) |
| PartStyle |
Получает характеристики стиля, которые применяются к границе и содержимому каждого элемента управления веб-частей, содержащегося в зоне. (Унаследовано от WebZone) |
| PartTitleStyle |
Поучает атрибуты стиля для содержимого заголовка окна каждого элемента управления, содержащегося в зоне. (Унаследовано от WebZone) |
| RenderClientScript |
Получает значение, которое указывает, следует ли отрисовывать клиентский скрипт на веб-странице. (Унаследовано от WebZone) |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| SelectedCatalogPartID |
Получает или задает строку в качестве идентификатора текущего выбранного элемента управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase) |
| SelectedPartLinkStyle |
Получает объект, который содержит атрибуты стиля для выбранного в настоящий момент элемента управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase) |
| SelectTargetZoneText |
Получает или задает текст для элемента управления в пользовательском интерфейсе каталога, с помощью которого пользователи могут выбрать, в какую зону можно добавить выбранные элементы управления. (Унаследовано от CatalogZoneBase) |
| ShowCatalogIcons |
Получает или задает значение, указывающее, отображаются ли значки для серверных элементов управления в каталоге. (Унаследовано от CatalogZoneBase) |
| 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) |
| ZoneTemplate |
Получает или задает шаблон, в котором будут содержаться дочерние элементы управления для элемента управления CatalogZone в формате сохранения страницы. |
Методы
| 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() |
Переключает веб-страницу из режима отображения каталога в обычный режим просмотра. (Унаследовано от CatalogZoneBase) |
| CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateCatalogPartChrome() |
Создает экземпляр объекта CatalogPartChrome, используемого для отрисовки периферийных элементов пользовательского интерфейса для элементов управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase) |
| CreateCatalogParts() |
Создает экземпляр каждого типа CatalogPart, объявленного в зоне. |
| CreateChildControls() |
Создает набор дочерних элементов управления, сопоставленных с зоной CatalogZoneBase. (Унаследовано от 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. (Унаследовано от CatalogZoneBase) |
| IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
| LoadControlState(Object) |
Загружает состояние из предыдущего запроса страницы для свойств элемента управления, которые должны быть постоянными в обратных запросах, даже если для элемента управления отключено состояние просмотра. (Унаследовано от CatalogZoneBase) |
| LoadPostData(String, NameValueCollection) |
Обрабатывает состояние флажков, соответствующих элементам управления WebPart в каталоге, при обратном запросе страницы на сервер. (Унаследовано от CatalogZoneBase) |
| LoadViewState(Object) |
Загружает ранее сохраненные сведения о состоянии для зоны. (Унаследовано от CatalogZoneBase) |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать аспекты изменения режимов отображения страницы для специальной зоны. (Унаследовано от ToolZone) |
| OnInit(EventArgs) |
Регистрирует объект страницы, чтобы страница нуждалась в состоянии элемента управления. (Унаследовано от CatalogZoneBase) |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Создает событие PreRender и регистрирует объект страницы, чтобы были необходимы обратные запросы. (Унаследовано от CatalogZoneBase) |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать событие изменения элемента управления веб-частей, выбранного в специальной зоне. (Унаследовано от ToolZone) |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RaisePostBackEvent(String) |
Выполняет действия, сопоставленные с одной из команд зоны, или вызывает событие, выполняющее обратную передачу на сервер. (Унаследовано от CatalogZoneBase) |
| RecreateChildControls() |
Воссоздает дочерние элементы элемента управления, являющегося наследником CompositeControl. (Унаследовано от CompositeControl) |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отображает зону в указанном объекте HtmlTextWriter. (Унаследовано от CatalogZoneBase) |
| RenderBeginTag(HtmlTextWriter) |
Отрисовывает HTML-тег открытия элемента управления зоны для указанного объекта HtmlTextWriter. (Унаследовано от WebZone) |
| RenderBody(HtmlTextWriter) |
Переопределяет базовый метод, чтобы отобразить основную область зоны, производной от класса CatalogZoneBase. (Унаследовано от CatalogZoneBase) |
| RenderCatalogPartLinks(HtmlTextWriter) |
Отрисовывает ссылки на отдельные элементы управления CatalogPart в зоне CatalogZoneBase. (Унаследовано от 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. (Унаследовано от CatalogZoneBase) |
| RenderHeader(HtmlTextWriter) |
Переопределяет базовый метод, чтобы выполнить специальные операции отрисовки для области верхнего колонтитула, необходимые для элементов управления ToolZone. (Унаследовано от ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Отображает отдельную команду в элементе управления ToolZone. (Унаследовано от ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Отрисовывает команды в области нижнего колонтитула зоны CatalogZoneBase. (Унаследовано от CatalogZoneBase) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет изменения в состоянии элемента управления CatalogZoneBase, которые произошли после обратного запроса веб-страницы на сервер. (Унаследовано от CatalogZoneBase) |
| SaveViewState() |
Сохраняет изменения состояния просмотра, произошедшие с момента отправки страницы обратно на сервер. (Унаследовано от CatalogZoneBase) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Отслеживает изменения состояния просмотра элемента управления зоны. (Унаследовано от CatalogZoneBase) |
События
| 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) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по