CatalogZone Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Slouží jako primární ovládací prvek v sadě ovládacích částí webových částí pro hostování CatalogPart ovládacích prvků na webové stránce.
public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase
public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase
type CatalogZone = class
inherit CatalogZoneBase
Public Class CatalogZone
Inherits CatalogZoneBase
- Dědičnost
Příklady
Následující příklad kódu ukazuje deklarativní a programové použití CatalogZone ovládacího prvku. Příklad kódu má čtyři části:
Uživatelský ovládací prvek, který umožňuje změnit režimy zobrazení na webové stránce.
Soubor se zdrojovým kódem pro vlastní CatalogZone ovládací prvek a vlastní WebPart ovládací prvek, který je importován katalogem a přidán na webovou stránku.
Webová stránka, která deklaruje uživatelský ovládací prvek a vlastní CatalogZone ovládací prvek.
Vysvětlení způsobu spuštění příkladu
První část tohoto příkladu kódu je uživatelský ovládací prvek, který uživatelům umožňuje změnit režimy zobrazení na webové stránce. Podrobnosti o režimech zobrazení a popis zdrojového kódu v tomto ovládacím prvku naleznete v návodu : Změna režimů zobrazení na stránce webových částí.
<%@ 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>
Druhá část příkladu kódu obsahuje kód pro vlastní CatalogZone a WebPart ovládací prvky. Kód pro CatalogZone ovládací prvek ukazuje, jak dědit z CatalogZone třídy a přizpůsobit jeho vlastnosti nastavením některých výchozích hodnot vlastností v konstruktoru. Zdrojový kód také ukazuje, jak vytvořit vlastní WebPart třídu s názvem TextDisplayWebPart. Toto je ovládací prvek přidružený k tomuto prvku . Soubor popisu webové části, který budete importovat jako součást tohoto příkladu kódu. Po importu souboru popisu pomocí ImportCatalogPart ovládacího prvku na webové stránce budete moci přidat TextDisplayWebPart ovládací prvek na stránku, který je plně předem nakonfigurovaný, jak je uvedeno v souboru popisu.
Pro spuštění příkladu kódu je nutné zkompilovat tento zdrojový kód. Můžete jej explicitně zkompilovat a výsledné sestavení umístit do složky Bin vašeho webu nebo globální mezipaměti sestavení. Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Tento příklad kódu používá dynamickou kompilaci, takže pokud chcete tento příklad spustit tímto způsobem, pojmenujte soubor zdrojového kódu a přidejte ho do App_Code podsložky kořenového adresáře webové aplikace. Návod, který ukazuje obě metody kompilace, naleznete v části Návod: Vývoj a použití vlastního ovládacího prvku webového serveru.
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
Třetí částí příkladu kódu je webová stránka, která obsahuje ovládací prvky. Obsahuje direktivu Register pro uživatelský ovládací prvek a další pro zdrojový soubor s vlastními ovládacími prvky. Všimněte si, že ve druhé direktivě nenázví sestavení, protože příklad nepoužívá sestavení, používá dynamickou kompilaci se zdrojovým kódem umístěným v podsložce App_Code. Webová stránka deklaruje WebPartZone ovládací prvek a v rámci jeho podřízeného <zonetemplate>BulletedList prvku deklaruje ovládací prvek. I když se jedná o standardní ovládací prvek ASP.NET, bude mít úplné funkce webových částí za běhu, protože WebPartManager ovládací prvek zabalí všechny ovládací prvky serveru umístěné do objektu WebPartZoneGenericWebPart , aby se ostatní ovládací prvky serveru mohly účastnit aplikací webových částí. Deklarováno také v této zóně je vlastní WebPart ovládací prvek s názvem TextDisplayWebPart. Všimněte si, že tento ovládací prvek má atribut ExportMode="All" deklarovaný v něm. To vám umožní exportovat . Soubor popisu webové části, který obsahuje hodnoty vlastností ovládacího prvku, které mohou naimportovat ostatní uživatelé a přidat předkonfigurovaný ovládací prvek na jiné webové stránky.
Poznámka:
Chcete-li uživatelům aplikace webových částí povolit export souboru popisu ovládacích WebPart prvků, musíte také povolit funkci exportu ve webové aplikaci přidáním enableExport="true" atributu <webParts> k elementu (což je podřízený prvek <system.web> ) v souboru Web.config. Export je ve výchozím nastavení zakázaný, takže pokud jste export pro aplikaci ještě nepovolili, upravte Web.config soubor a udělejte to teď.
Webová stránka také deklaruje vlastní CatalogZone ovládací prvek a v něm prvek, <zonetemplate> který obsahuje ImportCatalogPart ovládací prvek. Uživatel použije tento ovládací prvek za běhu k importu . Soubor popisu webové části pro vlastní WebPart ovládací prvek
<%@ 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>
Teď spusťte příklad kódu. Načtěte webovou stránku v prohlížeči. Prvním krokem je export . Soubor popisu webové části pro TextDisplayWebPart ovládací prvek. Klikněte na nabídku sloves ve vlastním ovládacím prvku (reprezentované šipkou dolů v záhlaví) a klikněte na Exportovat. Podle pokynů uložte soubor popisu ovládacího prvku. Otevřete . Soubor popisu webové části v editoru a upravte hodnotu textu vlastnosti nadpisu.
<property> Vyhledejte prvek, který má atribut name="Title", a upravte text nadpisu, který je obsažen mezi levou a pravou <property> značkou. Teď webovou stránku zavřete a upravte zdroj stránky v editoru.
<aspSample:TextDisplayWebPart> Odstraňte element deklarace ovládacího prvku a pak soubor uložte a zavřete.
Znovu načtěte webovou stránku v prohlížeči. Ovládací TextDisplayWebPart prvek by se neměl zobrazit, protože jste ho odebrali. Pomocí ovládacího prvku rozevíracího seznamu Režim zobrazení a výběrem možnosti Katalog přepněte stránku do režimu katalogu. Všimněte si, že se zobrazí vlastní CatalogZone ovládací prvek spolu s ovládacím ImportCatalogPart prvku. Kliknutím na tlačítko Procházet vyhledejte položku . Soubor popisu webové části, který jste exportovali pro TextDisplayWebPart ovládací prvek. Můžete kliknout na Nahrát, zaškrtnout políčko vedle importovaného ovládacího prvku a kliknutím na Přidat ho přidat na stránku. Kliknutím na zavřít katalog vrátíte stránku do normálního režimu procházení. Importovaný ovládací prvek by se teď měl zobrazit na stránce a nadpis, který se zobrazí v záhlaví ovládacího prvku, by měl být text nadpisu, který jste přidali do pole . Soubor popisu webové části.
Poznámky
V sadě ovládacích částí webových částí je zóna oblastí na webové stránce, která obsahuje ovládací prvky webových částí. Zónu webových částí vytvoří ovládací prvek zóny, což je typ CompositeControl navržený tak, aby obsahoval další ovládací prvky. Primárními funkcemi zóny je rozložení ovládacích prvků, které obsahuje, a poskytnutí společného uživatelského rozhraní (UI) pro tyto ovládací prvky. Obecné informace o zónách a jejich použití v aplikacích webových částí najdete v základní WebZone třídě a přehledu sady ovládacích prvků webových částí.
Klíčovou funkcí ovládacích prvků webových částí je, že koncovým uživatelům umožňují upravovat (nebo přizpůsobovat) webové stránky podle svých preferencí a ukládat individuální nastavení pro budoucí relace prohlížeče. Jedním z aspektů úprav stránek webových částí je možnost přidat WebPart ovládací prvky nebo jiné serverové ovládací prvky na stránku webových částí. Ovládací CatalogZone prvek poskytuje seznam nebo katalog ovládacích prvků, které mohou uživatelé přidat na stránku.
Ovládací CatalogZone prvek je jedním ze základních ovládacích prvků v sadě ovládacích částí webových částí. Je odvozen z CatalogZoneBase třídy a většina jeho chování je zděděna z této třídy. Třída CatalogZone v podstatě přidává do základní třídy šablonu zóny, což je implementace ITemplate rozhraní. Šablona zóny umožňuje vývojářům deklarativní přidávání CatalogPart ovládacích prvků do zóny ve formátu trvalosti stránky.
Důležité
CatalogZone Zóna může obsahovat pouze CatalogPart ovládací prvky a naopak CatalogPart ovládací prvky mohou být umístěny pouze v zónách odvozených od CatalogZoneBase třídy, například CatalogZone.
CatalogZone Ovládací prvek se zobrazí jenom tehdy, když uživatel přepne webovou stránku do režimu zobrazení katalogu (CatalogDisplayMode). Katalog může obsahovat několik typů ovládacích CatalogPart prvků. Každý CatalogPart ovládací prvek je typ kontejneru, který obsahuje ovládací prvky serveru, které mohou uživatelé přidat na stránku. Ovládací CatalogPart prvky se liší podle toho, odkud pocházejí ovládací prvky serveru, které obsahují. Následující tabulka shrnuje CatalogPart ovládací prvky, které jsou součástí sady ovládacích částí webových částí, a pro každý ovládací prvek, jaký druh serverových ovládacích prvků obsahuje.
| Ovládací prvek | Description |
|---|---|
| PageCatalogPart | Udržuje odkazy na ovládací prvky, které byly zavřeny na stránce. Tyto ovládací prvky můžou uživatelé znovu otevřít (přidat zpět na stránku). |
| DeclarativeCatalogPart | Obsahuje odkazy na ovládací prvky deklarované v katalogu webových částí v kódu webové stránky. Tyto ovládací prvky můžou uživatelé přidat na webovou stránku. |
| ImportCatalogPart | Poskytuje uživatelské rozhraní pro uživatele k nahrání definičního souboru (soubor XML s příponou . Rozšíření webové části a zadaný formát, který obsahuje informace o stavu) ovládacího prvku do katalogu, aby bylo možné ovládací prvek přidat na webovou stránku. |
Vzhledem k tomu, že CatalogZone třída přidává pouze šablonu zóny k chování své základní třídy, má několik členů. Konstruktor CatalogZone je konstruktor bez parametrů. S ním můžete inicializovat novou instanci CatalogZone třídy. Vlastnost ZoneTemplate získá nebo nastaví odkaz na ITemplate objekt, který obsahuje ovládací prvky zóny. Metoda CreateCatalogParts je kritická. Přepíše základní metodu pro vytvoření kolekce všech CatalogPart ovládacích prvků obsažených v šabloně zóny.
Poznámka:
Tlačítka v uživatelském CatalogZone rozhraní vyžadují, aby skriptování na straně klienta fungovalo správně. Pokud je skriptování v prohlížeči zakázané, uživatel nebude moct provádět akce prostřednictvím CatalogZone uživatelského rozhraní.
Přístupnost
Značky vykreslené pro tento ovládací prvek ve výchozím nastavení nemusí odpovídat standardům přístupnosti, jako jsou pravidla pro přístupnost webového obsahu 1.0 (WCAG) priority 1. Podrobnosti o podpoře přístupnosti tohoto ovládacího prvku najdete v tématu ASP.NET Ovládací prvky a přístupnost.
Poznámky pro dědice
Vlastní CatalogZone třídy můžete vytvořit, pokud chcete mít větší kontrolu nad vykreslováním a chováním uživatelského rozhraní katalogu. Pokud nepotřebujete uživatelům vašeho ovládacího prvku poskytovat deklarativní přidávání CatalogPart ovládacích prvků, můžete dědit přímo z CatalogZoneBase třídy. Pokud chcete povolit přidání ovládacích prvků deklarativním způsobem, je jednoduchý přístup dědit z CatalogZone třídy, protože poskytuje základní šablonu zóny.
Pokud dědíte z CatalogZone třídy, můžete přepsat metodu CreateCatalogParts() a použít metodu k přidání vlastních CatalogPart ovládacích prvků do CatalogPartCollection, pokud chcete větší programovou kontrolu nad přidáním vlastních CatalogPart ovládacích prvků do zóny.
Konstruktory
| Name | Description |
|---|---|
| CatalogZone() |
Inicializuje novou instanci CatalogZone třídy. |
Vlastnosti
| Name | Description |
|---|---|
| AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AddVerb |
Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům přidat ovládací prvky z katalogu na stránku webových částí. (Zděděno od CatalogZoneBase) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| AssociatedDisplayModes |
Získá kolekci WebPartDisplayMode objektů, které jsou přidruženy k určité ToolZone zóně. (Zděděno od ToolZone) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BackImageUrl |
Získá nebo nastaví adresu URL na obrázek pozadí zóny. (Zděděno od WebZone) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control) |
| BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
| BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| CatalogPartChrome |
Získá odkaz na instanci CatalogPartChrome třídy asociované se zónou CatalogZoneBase . (Zděděno od CatalogZoneBase) |
| CatalogParts |
Získá kolekci CatalogPart všech ovládacích prvků obsažených v CatalogZoneBase zóně. (Zděděno od CatalogZoneBase) |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
| ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
| ClientIDSeparator |
Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| CloseVerb |
Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zavřít uživatelské rozhraní katalogu (UI) a vrátit stránku do normálního režimu procházení. (Zděděno od CatalogZoneBase) |
| Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
| Controls |
ControlCollection Získá objekt, který představuje podřízené ovládací prvky v objektu CompositeControl. (Zděděno od CompositeControl) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu určující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CssClass |
Získá nebo nastaví cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl) |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| Display |
Získá hodnotu, která určuje, zda ToolZone je ovládací prvek aktuálně zobrazen. (Zděděno od ToolZone) |
| EditUIStyle |
Získá atributy stylu pro upravitelné ovládací prvky obsažené v ovládacím ToolZone prvku. (Zděděno od ToolZone) |
| EmptyZoneText |
Získá nebo nastaví zprávu, která se zobrazí, když zóna neobsahuje žádné ovládací prvky. (Zděděno od CatalogZoneBase) |
| EmptyZoneTextStyle |
Získá atributy stylu pro zástupný text v prázdné zóně. (Zděděno od WebZone) |
| Enabled |
Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl) |
| EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
| ErrorStyle |
Získá atributy stylu pro vykreslení chybové zprávy, která je zobrazena, pokud WebPart ovládací prvek nelze načíst nebo vytvořit. (Zděděno od WebZone) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| Font |
Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl) |
| FooterStyle |
Získá atributy stylu pro obsah oblasti zápatí zóny. (Zděděno od WebZone) |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HasAttributes |
Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| HasChildViewState |
Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| HasFooter |
Získá hodnotu určující, zda zóna má oblast zápatí. (Zděděno od WebZone) |
| HasHeader |
Získá hodnotu určující, zda zóna má oblast záhlaví. (Zděděno od WebZone) |
| HeaderCloseVerb |
Získá odkaz na WebPartVerb objekt v záhlaví ToolZone ovládacího prvku, který slouží k zavření ovládacího prvku. (Zděděno od ToolZone) |
| HeaderStyle |
Získá atributy stylu pro obsah oblasti záhlaví zóny. (Zděděno od WebZone) |
| HeaderText |
Získá nebo nastaví text pro oblast záhlaví zóny. (Zděděno od CatalogZoneBase) |
| HeaderVerbStyle |
Získá atributy stylu pro všechny příkazy záhlaví zobrazené v ovládacím ToolZone prvku. (Zděděno od ToolZone) |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| InstructionText |
Získá nebo nastaví text v zóně, která poskytuje pokyny pro koncové uživatele. (Zděděno od CatalogZoneBase) |
| InstructionTextStyle |
Získá atributy stylu pro instrukční text, který se zobrazí v horní části ToolZone ovládacího prvku. (Zděděno od ToolZone) |
| IsChildControlStateCleared |
Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LabelStyle |
Získá atributy stylu pro obsah popisků, které se zobrazí spolu s ovládacími prvky pro úpravy v ovládacím ToolZone prvku. Odvozené ToolZone ovládací prvky, například CatalogZone a EditorZone, aplikují styly na popisky. (Zděděno od ToolZone) |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Padding |
Získá nebo nastaví atributy odsazení buňky v tabulce, která obsahuje WebPart ovládací prvky v zóně. (Zděděno od WebZone) |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| PartChromePadding |
Získá nebo nastaví vzdálenost mezi obsahem WebPart ovládacího prvku a ohraničení ovládacího prvku. (Zděděno od WebZone) |
| PartChromeStyle |
Získá vlastnosti stylu, které se vztahují na ohraničení ovládacích prvků webových částí obsažených v zóně. (Zděděno od WebZone) |
| PartChromeType |
Získá nebo nastaví typ ohraničení, které rámečky webové části ovládací prvky obsažené v zóně. (Zděděno od WebZone) |
| PartLinkStyle |
Získá objekt, který obsahuje styl atributy pro CatalogPart ovládací prvky, které nejsou aktuálně vybrány v zóně. (Zděděno od CatalogZoneBase) |
| PartStyle |
Získá vlastnosti stylu, které se vztahují na ohraničení a obsah každého ovládacího prvku webové části obsažené v zóně. (Zděděno od WebZone) |
| PartTitleStyle |
Získá atributy stylu pro obsah záhlaví pro každý ovládací prvek webové části obsažené v zóně. (Zděděno od WebZone) |
| RenderClientScript |
Získá hodnotu, která určuje, zda se má vykreslit klientský skript na stránce webových částí. (Zděděno od WebZone) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| SelectedCatalogPartID |
Získá nebo nastaví řetězec jako identifikátor pro aktuálně vybraný CatalogPart ovládací prvek v zóně. (Zděděno od CatalogZoneBase) |
| SelectedPartLinkStyle |
Získá objekt, který obsahuje styl atributy pro CatalogPart ovládací prvek, který je aktuálně vybrán v zóně. (Zděděno od CatalogZoneBase) |
| SelectTargetZoneText |
Získá nebo nastaví text vedle ovládacího prvku v uživatelském rozhraní katalogu , který umožňuje uživatelům zvolit, do které zóny mají přidat své vybrané ovládací prvky. (Zděděno od CatalogZoneBase) |
| ShowCatalogIcons |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvky serveru v katalogu zobrazují jejich přidružené ikony v katalogu. (Zděděno od CatalogZoneBase) |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od WebControl) |
| Style |
Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která určuje, zda ovládací prvek má nastavit |
| TabIndex |
Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
Získá hodnotu, která odpovídá tomuto ovládacímu HtmlTextWriterTag prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebZone) |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
| TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control) |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
| VerbButtonType |
Získá nebo nastaví, jaký typ tlačítka se používá k reprezentaci sloves v zóně. (Zděděno od WebZone) |
| VerbStyle |
Získá atributy stylu pro příkazy uživatelského rozhraní (UI) přidružené k ovládacím částem webových částí v zóně. (Zděděno od WebZone) |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako prvek uživatelského rozhraní (UI) na stránce. (Zděděno od ToolZone) |
| WebPartManager |
Získá odkaz na WebPartManager ovládací prvek přidružený k WebZone instanci ovládacího prvku na stránce webových částí. (Zděděno od WebZone) |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| ZoneTemplate |
Získá nebo nastaví šablonu tak, aby obsahovala podřízené ovládací prvky v ovládacím CatalogZone prvku ve formátu trvalosti stránky. |
Metody
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je třeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
| AddParsedSubObject(Object) |
Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control) |
| ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| Close() |
Přepne webovou stránku z režimu zobrazení katalogu na normální režim procházení. (Zděděno od CatalogZoneBase) |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| CreateCatalogPartChrome() |
Vytvoří instanci objektu CatalogPartChrome sloužícího k vykreslení prvků periferního uživatelského rozhraní pro CatalogPart ovládací prvky v zóně. (Zděděno od CatalogZoneBase) |
| CreateCatalogParts() |
Vytvoří instanci každého CatalogPart typu deklarovaného v zóně. |
| CreateChildControls() |
Vytvoří sadu podřízených ovládacích prvků přidružených k CatalogZoneBase zóně. (Zděděno od CatalogZoneBase) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control) |
| CreateControlStyle() |
Vytvoří objekt stylu, který je interně WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| DataBind() |
Vytvoří vazbu zdroje dat s podřízenými CompositeControl ovládacími prvky a všemi jeho podřízenými ovládacími prvky. (Zděděno od CompositeControl) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control) |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetEffectiveChromeType(Part) |
Vrátí skutečnou WebPart nebo efektivní aktuální PartChromeType hodnotu ovládacího prvku vzhledem k PartChromeType vlastnosti zóny a aktuální režim zobrazení stránky webových částí. (Zděděno od WebZone) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| InvalidateCatalogParts() |
Zničí kolekci ovládacích prvků přidružených CatalogPart k CatalogZoneBase zóně. (Zděděno od CatalogZoneBase) |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControlState(Object) |
Načte stav z předchozího požadavku na stránku pro vlastnosti ovládacího prvku, které by se měly zachovat napříč postbacky, i když je v ovládacím prvku zakázán stav zobrazení. (Zděděno od CatalogZoneBase) |
| LoadPostData(String, NameValueCollection) |
Zpracuje stav zaškrtávacích políček, které odpovídají WebPart ovládacím prvkům v katalogu, když se stránka publikuje zpět na server. (Zděděno od CatalogZoneBase) |
| LoadViewState(Object) |
Načte dříve uložené informace o stavu zóny. (Zděděno od CatalogZoneBase) |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control) |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Poskytuje deklaraci základní metody, která odvozené ToolZone ovládací prvky mohou přepsat pro zpracování podrobností o změně režimů zobrazení stránky pro specializovanou zónu. (Zděděno od ToolZone) |
| OnInit(EventArgs) |
Zaregistruje objekt stránky tak, aby stránka vyžadovala stav ovládacího prvku. (Zděděno od CatalogZoneBase) |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost a zaregistruje objekt stránky tak, aby vyžadoval postbacky. (Zděděno od CatalogZoneBase) |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Poskytuje deklaraci základní metody, která odvozené ToolZone ovládací prvky mohou přepsat pro zpracování události změny, které ovládací prvky webové části jsou vybrány v rámci specializované zóny. (Zděděno od ToolZone) |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá použité ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control) |
| RaisePostBackEvent(String) |
Provede akce přidružené k některému ze sloves zóny nebo vyvolá událost, která publikuje zpět na server. (Zděděno od CatalogZoneBase) |
| RecreateChildControls() |
Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl. (Zděděno od CompositeControl) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Vykreslí zónu na zadaný HtmlTextWriter objekt. (Zděděno od CatalogZoneBase) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku zóny na zadaný HtmlTextWriter objekt. (Zděděno od WebZone) |
| RenderBody(HtmlTextWriter) |
Přepíše základní metodu pro vykreslení oblasti těla zóny odvozené z CatalogZoneBase třídy. (Zděděno od CatalogZoneBase) |
| RenderCatalogPartLinks(HtmlTextWriter) |
Vykreslí odkazy na jednotlivé CatalogPart ovládací prvky v CatalogZoneBase zóně. (Zděděno od CatalogZoneBase) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderContents(HtmlTextWriter) |
Vykreslí celý obsah ovládacího prvku zóny mezi počáteční a koncovou značkou do zadaného HtmlTextWriter objektu. (Zděděno od WebZone) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| RenderFooter(HtmlTextWriter) |
Vykreslí oblast zápatí pro zónu CatalogZoneBase . (Zděděno od CatalogZoneBase) |
| RenderHeader(HtmlTextWriter) |
Přepíše základní metodu tak, aby poskytovala specializované vykreslování oblasti záhlaví vyžadované ovládacími ToolZone prvky. (Zděděno od ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Vykreslí jednotlivé sloveso pomocí ToolZone ovládacího prvku. (Zděděno od ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Vykreslí příkazy v oblasti CatalogZoneBase zápatí zóny. (Zděděno od CatalogZoneBase) |
| ResolveAdapter() |
Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny ve CatalogZoneBase stavu ovládacího prvku, ke kterému dojde po odeslání webové stránky zpět na server. (Zděděno od CatalogZoneBase) |
| SaveViewState() |
Uloží všechny změny stavu zobrazení, ke kterým došlo po odeslání stránky zpět na server. (Zděděno od CatalogZoneBase) |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Sleduje změny stavu zobrazení ovládacího prvku zóny. (Zděděno od CatalogZoneBase) |
Událost
| Name | Description |
|---|---|
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| Disposed |
Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control) |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type, Object) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný ovládací prvek dat. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, zda jsou k dispozici metadata tabulky. |