CatalogZone Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Służy jako podstawowa kontrolka w kontrolce składników Web Part ustawiona na potrzeby hostowania CatalogPart kontrolek na stronie sieci Web.
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- Dziedziczenie
Przykłady
Poniższy przykład kodu pokazuje deklaratywne i programowe użycie kontrolki CatalogZone . Przykładowy kod ma cztery części:
Kontrolka użytkownika, która umożliwia zmianę trybów wyświetlania na stronie sieci Web.
Plik z kodem źródłowym dla kontrolki niestandardowej i kontrolką niestandardową CatalogZoneWebPart importowaną przez wykaz i dodaną do strony sieci Web.
Strona sieci Web, która deklaruje kontrolkę użytkownika i kontrolkę niestandardową CatalogZone .
Wyjaśnienie sposobu uruchamiania przykładu.
Pierwszą częścią tego przykładu kodu jest kontrolka użytkownika, która umożliwia użytkownikom zmienianie trybów wyświetlania na stronie sieci Web. Aby uzyskać szczegółowe informacje o trybach wyświetlania i opisie kodu źródłowego w tej kontrolce, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składników Web Part.
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName, modeName);
DisplayModeDropdown.Items.Add(item);
}
}
// If shared scope is allowed for this user, display the scope-switching
// UI and select the appropriate radio button for the current user scope.
if (_manager.Personalization.CanEnterSharedScope)
{
Panel2.Visible = true;
if (_manager.Personalization.Scope == PersonalizationScope.User)
RadioButton1.Checked = true;
else
RadioButton2.Checked = true;
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
// Set the selected item equal to the current display mode.
void Page_PreRender(object sender, EventArgs e)
{
ListItemCollection items = DisplayModeDropdown.Items;
int selectedIndex =
items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
DisplayModeDropdown.SelectedIndex = selectedIndex;
}
// Reset all of a user's personalization data for the page.
protected void LinkButton1_Click(object sender, EventArgs e)
{
_manager.Personalization.ResetPersonalizationState();
}
// If not in User personalization scope, toggle into it.
protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.Scope == PersonalizationScope.Shared)
_manager.Personalization.ToggleScope();
}
// If not in Shared scope, and if user is allowed, toggle the scope.
protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope &&
_manager.Personalization.Scope == PersonalizationScope.User)
_manager.Personalization.ToggleScope();
}
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _
_manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
Druga część przykładu kodu zawiera kod dla kontrolek i WebPart niestandardowychCatalogZone. Kod kontrolki CatalogZone pokazuje, jak dziedziczyć z CatalogZone klasy i dostosowywać jego właściwości, ustawiając niektóre domyślne wartości właściwości w konstruktorze. Kod źródłowy pokazuje również, jak utworzyć klasę niestandardową WebPart o nazwie TextDisplayWebPart. Jest to kontrolka skojarzona z elementem . Plik opisu składnika Web Part, który zostanie zaimportowany w ramach tego przykładu kodu. Po zaimportowaniu pliku opisu za pomocą ImportCatalogPart kontrolki na stronie sieci Web będzie można dodać kontrolkę TextDisplayWebPart do strony, w pełni skonfigurowaną wstępnie zgodnie z opisem w pliku opisu.
Aby przykład kodu został uruchomiony, należy skompilować ten kod źródłowy. Można je jawnie skompilować i umieścić wynikowy zestaw w folderze Bin witryny sieci Web lub globalnej pamięci podręcznej zestawów. Możesz też umieścić kod źródłowy w folderze App_Code witryny, w którym będzie dynamicznie kompilowany w czasie wykonywania. Ten przykład kodu używa kompilacji dynamicznej, więc jeśli chcesz uruchomić przykład w ten sposób, nadaj plikowi kodu źródłowego nazwę i dodaj go do podfolderu App_Code katalogu głównego aplikacji internetowej. Aby zapoznać się z przewodnikiem, który pokazuje obie metody kompilowania, zobacz Przewodnik: opracowywanie i używanie niestandardowej kontroli serwera sieci Web.
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
Trzecią częścią przykładu kodu jest strona sieci Web zawierająca kontrolki. Zawiera on dyrektywę dla kontrolki użytkownika, a drugą Register dla pliku źródłowego z kontrolkami niestandardowymi. Należy pamiętać, że w drugiej dyrektywie nie nazywa zestawu, ponieważ przykład nie używa zestawu, używa kompilacji dynamicznej z kodem źródłowym umieszczonym w podfolderze App_Code. Strona sieci Web deklaruje kontrolkę WebPartZone i w jej elemecie podrzędnym <zonetemplate> deklaruje kontrolkę BulletedList . Chociaż jest to standardowa kontrolka ASP.NET, będzie ona mieć pełną funkcjonalność składników Web Part w czasie wykonywania, ponieważ WebPartManager kontrolka opakowuje wszystkie kontrolki serwera umieszczone w obiekcie, GenericWebPart dzięki czemu inne kontrolki serwera mogą uczestniczyć w WebPartZone aplikacjach składników Web Part. Zadeklarowano również w tej strefie kontrolkę niestandardową WebPart o nazwie TextDisplayWebPart. Zwróć uwagę, że ta kontrolka ma atrybut zadeklarowany ExportMode="All" na nim. Umożliwia to wyeksportowanie elementu . Plik opisu składnika Web Part zawierający wartości właściwości kontrolki, które można zaimportować przez innych użytkowników, aby dodać wstępnie skonfigurowaną kontrolkę do innych stron sieci Web.
Uwaga
Aby umożliwić użytkownikom aplikacji składników Web Part eksportowanie pliku opisu dla WebPart kontrolek, należy również włączyć funkcję eksportu w aplikacji internetowej, dodając enableExport="true" atrybut do <webParts> elementu (który jest elementem podrzędnym <system.web> elementu) w pliku Web.config. Eksportowanie jest domyślnie wyłączone, więc jeśli nie włączono jeszcze eksportu dla aplikacji, zmodyfikuj plik Web.config i zrób to teraz.
Strona sieci Web deklaruje również kontrolkę niestandardową CatalogZone<zonetemplate> , a w niej element zawierający kontrolkę ImportCatalogPart . Użytkownik użyje tej kontrolki w czasie wykonywania, aby zaimportować element . Plik opisu składnika Web Part dla kontrolki niestandardowej 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>
Teraz uruchom przykład kodu. Załaduj stronę internetową w przeglądarce. Pierwszym krokiem jest wyeksportowanie elementu . Plik opisu składnika Web Part dla kontrolki TextDisplayWebPart . Kliknij menu czasowników w kontrolce niestandardowej (reprezentowane przez strzałkę w dół na pasku tytułu), a następnie kliknij pozycję Eksportuj. Postępuj zgodnie z instrukcjami, aby zapisać plik opisu dla kontrolki. Otwórz plik . Plik opisu składnika Web Part w edytorze i edytuj wartość tekstu właściwości tytułu. <property> Znajdź element, który ma atrybut name="Title", i edytuj tekst tytułu zawarty między tagami otwierania i zamykania<property>. Teraz zamknij stronę sieci Web i edytuj źródło strony w edytorze. <aspSample:TextDisplayWebPart> Usuń element deklaracji kontrolki, a następnie zapisz i zamknij plik.
Załaduj ponownie stronę internetową w przeglądarce. Kontrolka nie powinna być wyświetlana TextDisplayWebPart , ponieważ została usunięta. Użyj kontrolki listy rozwijanej Tryb wyświetlania i wybierz pozycję Wykaz , aby przełączyć stronę do trybu wykazu. Zwróć uwagę, że kontrolka niestandardowa CatalogZone jest wyświetlana wraz z kontrolką ImportCatalogPart . Kliknij przycisk Przeglądaj , aby zlokalizować element . Plik opisu składnika Web Part wyeksportowany dla kontrolki TextDisplayWebPart . Możesz kliknąć przycisk Przekaż, zaznaczyć pole wyboru obok zaimportowanych kontrolek, a następnie kliknąć przycisk Dodaj , aby dodać go do strony. Kliknij przycisk Zamknij wykaz , aby zwrócić stronę do normalnego trybu przeglądania. Zaimportowana kontrolka powinna być teraz wyświetlana na stronie, a tytuł wyświetlany na pasku tytułu kontrolki powinien być tekstem tytułu dodanym do elementu . Plik opisu składnika Web Part.
Uwagi
W zestawie kontrolek składników Web Part strefa jest regionem na stronie sieci Web zawierającej kontrolki składników Web Part. Strefa składników Web Part jest tworzona przez kontrolkę strefy, która jest typem przeznaczonym CompositeControl do przechowywania innych kontrolek. Podstawowymi funkcjami strefy jest układ kontrolek, które zawiera, oraz zapewnienie wspólnego interfejsu użytkownika dla tych kontrolek. Ogólne informacje o strefach i sposobie ich użycia w aplikacjach składników Web Part można znaleźć w temacie Base Class (Klasa bazowa WebZone ) i Web Part Control Set Overview (Omówienie zestawu kontrolek składników Web Part).
Kluczową funkcją kontrolek składników Web Part jest to, że umożliwiają użytkownikom końcowym modyfikowanie (lub personalizowanie) stron sieci Web zgodnie z ich preferencjami i zapisywanie spersonalizowanych ustawień dla przyszłych sesji przeglądarki. Jednym z aspektów modyfikowania stron składników Web Part jest możliwość dodawania WebPart kontrolek lub innych kontrolek serwera do strony składników Web Part. Kontrolka CatalogZone udostępnia listę lub wykaz kontrolek, które użytkownicy mogą dodawać do strony.
Kontrolka CatalogZone jest jedną z podstawowych kontrolek w zestawie kontrolek składników Web Part. Pochodzi ona z CatalogZoneBase klasy, a większość jej zachowania jest dziedziczona z tej klasy. Klasa CatalogZone zasadniczo dodaje do klasy bazowej szablon strefy, który jest implementacją interfejsu ITemplate . Szablon strefy umożliwia deweloperom deklaratywne dodawanie CatalogPart kontrolek do strefy w formacie trwałości strony.
Ważne
Strefa CatalogZone może zawierać tylko CatalogPart kontrolki i na odwrót CatalogPart kontrolki mogą znajdować się tylko w strefach pochodzących z CatalogZoneBase klasy, takich jak CatalogZone.
Kontrolka CatalogZone staje się widoczna tylko wtedy, gdy użytkownik przełącza stronę sieci Web w tryb wyświetlania katalogu (CatalogDisplayMode). Wykaz może zawierać kilka typów CatalogPart kontrolek. Każda kontrolka CatalogPart jest typem kontenera, który zawiera kontrolki serwera, które użytkownicy mogą dodać do strony. Kontrolki CatalogPart różnią się w zależności od tego, skąd pochodzą kontrolki serwera. Poniższa tabela zawiera CatalogPart podsumowanie kontrolek dostarczanych z zestawem kontrolek składników Web Part oraz, dla każdej kontrolki, jakiego rodzaju kontrolki zawiera.
| Kontrola | Opis |
|---|---|
| PageCatalogPart | Obsługuje odwołania do kontrolek, które zostały zamknięte na stronie. Te kontrolki mogą zostać ponownie otwarte (dodane z powrotem do strony) przez użytkowników. |
| DeclarativeCatalogPart | Zawiera odwołania do kontrolek zadeklarowanych w wykazie składników Web Part w znacznikach strony sieci Web. Te kontrolki można dodać do strony sieci Web przez użytkowników. |
| ImportCatalogPart | Udostępnia interfejs użytkownika do przekazania pliku definicji (pliku XML z elementem . Rozszerzenie składnika Web Part i określony format zawierający informacje o stanie) dla kontrolki w wykazie, dzięki czemu kontrolka może zostać dodana do strony sieci Web. |
CatalogZone Ponieważ klasa dodaje tylko szablon strefy do zachowania swojej klasy bazowej, ma kilka elementów członkowskich. Konstruktor jest konstruktorem bez parametrów. Za CatalogZone jego pomocą można zainicjować nowe wystąpienie CatalogZone klasy. Właściwość ZoneTemplate pobiera lub ustawia odwołanie do ITemplate obiektu zawierającego kontrolki strefy. Metoda jest krytyczna CreateCatalogParts . Zastępuje metodę podstawową, aby utworzyć kolekcję wszystkich CatalogPart kontrolek zawartych w szablonie strefy.
Uwaga
Przyciski w interfejsie CatalogZone użytkownika wymagają skryptów po stronie klienta w celu poprawnego działania. Jeśli skrypty są wyłączone w przeglądarce, użytkownik nie będzie mógł wykonywać akcji za pośrednictwem interfejsu CatalogZone użytkownika.
Ułatwienia dostępu
Znaczniki renderowane domyślnie dla tej kontrolki mogą nie być zgodne ze standardami ułatwień dostępu, takimi jak wytyczne dotyczące ułatwień dostępu do zawartości sieci Web 1.0 (WCAG) priorytet 1. Aby uzyskać szczegółowe informacje na temat obsługi ułatwień dostępu dla tej kontrolki, zobacz ASP.NET Controls and Accessibility (Kontrolki i ułatwienia dostępu).
Uwagi dotyczące dziedziczenia
Możesz utworzyć klasy niestandardowe CatalogZone , jeśli chcesz mieć większą kontrolę nad renderowaniem i zachowaniem interfejsu użytkownika wykazu. Jeśli nie musisz udostępniać użytkownikom kontrolki możliwość deklaratywnego dodawania CatalogPart kontrolek, możesz dziedziczyć bezpośrednio z CatalogZoneBase klasy. Jeśli chcesz umożliwić deklaratywne dodawanie kontrolek, proste podejście polega na dziedziczeniu CatalogZone z klasy, ponieważ udostępnia podstawowy szablon strefy.
Jeśli dziedziczysz z CatalogZone klasy, możesz zastąpić CreateCatalogParts() metodę i użyć metody w celu dodania kontrolek niestandardowych do CatalogPartCollectionklasy , jeśli chcesz mieć większą kontrolę programową nad dodawaniem kontrolek niestandardowych CatalogPartCatalogPart do strefy.
Konstruktory
| CatalogZone() |
Inicjuje nowe wystąpienie klasy CatalogZone. |
Właściwości
| AccessKey |
Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl) |
| Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
| AddVerb |
Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym dodawanie kontrolek z wykazu do strony składników Web Part. (Odziedziczone po CatalogZoneBase) |
| AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
| AssociatedDisplayModes |
Pobiera kolekcję obiektów skojarzonych WebPartDisplayMode z określoną ToolZone strefą. (Odziedziczone po ToolZone) |
| Attributes |
Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl) |
| BackColor |
Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BackImageUrl |
Pobiera lub ustawia adres URL na obraz tła dla strefy. (Odziedziczone po WebZone) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control) |
| BorderColor |
Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl) |
| BorderStyle |
Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BorderWidth |
Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| CatalogPartChrome |
Pobiera odwołanie do wystąpienia klasy skojarzonej CatalogPartChrome ze strefą CatalogZoneBase . (Odziedziczone po CatalogZoneBase) |
| CatalogParts |
Pobiera kolekcję wszystkich CatalogPart kontrolek zawartych w CatalogZoneBase strefie. (Odziedziczone po CatalogZoneBase) |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control) |
| ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
| ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania ClientID wartości właściwości. (Odziedziczone po Control) |
| ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
| CloseVerb |
Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zamknięcie interfejsu użytkownika wykazu i zwrócenie strony do normalnego trybu przeglądania. (Odziedziczone po CatalogZoneBase) |
| Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
| Controls |
ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne w obiekcie CompositeControl. (Odziedziczone po CompositeControl) |
| ControlStyle |
Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| ControlStyleCreated |
Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| CssClass |
Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl) |
| DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
| DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| Display |
Pobiera wartość wskazującą, czy kontrolka jest obecnie wyświetlana ToolZone . (Odziedziczone po ToolZone) |
| EditUIStyle |
Pobiera atrybuty stylu dla edytowalnych kontrolek zawartych w kontrolce ToolZone . (Odziedziczone po ToolZone) |
| EmptyZoneText |
Pobiera lub ustawia komunikat wyświetlany, gdy strefa nie zawiera żadnych kontrolek. (Odziedziczone po CatalogZoneBase) |
| EmptyZoneTextStyle |
Pobiera atrybuty stylu tekstu zastępczego w pustej strefie. (Odziedziczone po WebZone) |
| Enabled |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl) |
| EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl) |
| EnableViewState |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie. (Odziedziczone po Control) |
| ErrorStyle |
Pobiera atrybuty stylu do renderowania komunikatu o błędzie wyświetlanego, jeśli WebPart nie można załadować ani utworzyć kontrolki. (Odziedziczone po WebZone) |
| Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
| Font |
Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl) |
| FooterStyle |
Pobiera atrybuty stylu zawartości obszaru stopki strefy. (Odziedziczone po WebZone) |
| ForeColor |
Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| HasAttributes |
Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl) |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| HasFooter |
Pobiera wartość wskazującą, czy strefa ma obszar stopki. (Odziedziczone po WebZone) |
| HasHeader |
Pobiera wartość wskazującą, czy strefa ma obszar nagłówka. (Odziedziczone po WebZone) |
| HeaderCloseVerb |
Pobiera odwołanie do WebPartVerb obiektu w nagłówku kontrolki używanej ToolZone do zamknięcia kontrolki. (Odziedziczone po ToolZone) |
| HeaderStyle |
Pobiera atrybuty stylu dla zawartości obszaru nagłówka strefy. (Odziedziczone po WebZone) |
| HeaderText |
Pobiera lub ustawia tekst dla obszaru nagłówka strefy. (Odziedziczone po CatalogZoneBase) |
| HeaderVerbStyle |
Pobiera atrybuty stylu dla wszystkich czasowników nagłówków wyświetlanych w kontrolce ToolZone . (Odziedziczone po ToolZone) |
| Height |
Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
| IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
| InstructionText |
Pobiera lub ustawia tekst w strefie, która zapewnia wskazówki dla użytkowników końcowych. (Odziedziczone po CatalogZoneBase) |
| InstructionTextStyle |
Pobiera atrybuty stylu dla tekstu instrukcji wyświetlanego w górnej części kontrolki ToolZone . (Odziedziczone po ToolZone) |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsEnabled |
Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control) |
| LabelStyle |
Pobiera atrybuty stylu dla zawartości etykiet, które są wyświetlane obok kontrolek edycji w kontrolce ToolZone . ToolZone Pochodne kontrolki, takie jak CatalogZone i EditorZone, stosują style do etykiet. (Odziedziczone po ToolZone) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control) |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
| Padding |
Pobiera lub ustawia atrybuty wypełniania komórek w tabeli zawierającej kontrolki WebPart w strefie. (Odziedziczone po WebZone) |
| Page |
Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control) |
| PartChromePadding |
Pobiera lub ustawia odległość między zawartością WebPart kontrolki a obramowaniem kontrolki. (Odziedziczone po WebZone) |
| PartChromeStyle |
Pobiera cechy stylu, które mają zastosowanie do obramowań kontrolek składników Web Part zawartych w strefie. (Odziedziczone po WebZone) |
| PartChromeType |
Pobiera lub ustawia typ obramowania, który zawiera kontrolki Składników Web Part zawarte w strefie. (Odziedziczone po WebZone) |
| PartLinkStyle |
Pobiera obiekt, który zawiera atrybuty stylu dla CatalogPart kontrolek, które nie są obecnie zaznaczone w strefie. (Odziedziczone po CatalogZoneBase) |
| PartStyle |
Pobiera cechy stylu, które mają zastosowanie do obramowania i zawartości każdej kontrolki składników Web Part zawartej w strefie. (Odziedziczone po WebZone) |
| PartTitleStyle |
Pobiera atrybuty stylu zawartości paska tytułu dla każdej kontrolki składników Web Part zawartej w strefie. (Odziedziczone po WebZone) |
| RenderClientScript |
Pobiera wartość wskazującą, czy skrypt klienta ma być renderowany na stronie składników Web Part. (Odziedziczone po WebZone) |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| SelectedCatalogPartID |
Pobiera lub ustawia ciąg jako identyfikator aktualnie wybranej CatalogPart kontrolki w strefie. (Odziedziczone po CatalogZoneBase) |
| SelectedPartLinkStyle |
Pobiera obiekt zawierający atrybuty stylu dla CatalogPart kontrolki, która jest aktualnie zaznaczona w strefie. (Odziedziczone po CatalogZoneBase) |
| SelectTargetZoneText |
Pobiera lub ustawia tekst obok kontrolki w interfejsie użytkownika wykazu, który umożliwia użytkownikom wybranie strefy, do której mają zostać dodane wybrane kontrolki. (Odziedziczone po CatalogZoneBase) |
| ShowCatalogIcons |
Pobiera lub ustawia wartość wskazującą, czy kontrolki serwera w wykazie wyświetlają skojarzone ikony w wykazie. (Odziedziczone po CatalogZoneBase) |
| Site |
Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
| SkinID |
Pobiera lub ustawia skórę do zastosowania do kontrolki. (Odziedziczone po WebControl) |
| Style |
Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| SupportsDisabledAttribute |
Pobiera wartość wskazującą, czy kontrolka powinna ustawić |
| TabIndex |
Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| TagKey |
Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontroli serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebZone) |
| TagName |
Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| ToolTip |
Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl) |
| UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
| ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
| VerbButtonType |
Pobiera lub ustawia, jakiego rodzaju przycisk jest używany do reprezentowania czasowników w strefie. (Odziedziczone po WebZone) |
| VerbStyle |
Pobiera atrybuty stylu dla czasowników interfejsu użytkownika skojarzonych z kontrolkami składników Web Part w strefie. (Odziedziczone po WebZone) |
| ViewState |
Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb stanu widoku tej kontrolki. (Odziedziczone po Control) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako element interfejsu użytkownika na stronie. (Odziedziczone po ToolZone) |
| WebPartManager |
Pobiera odwołanie do kontrolki WebPartManager skojarzonej z wystąpieniem WebZone kontrolki na stronie składników Web Part. (Odziedziczone po WebZone) |
| Width |
Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| ZoneTemplate |
Pobiera lub ustawia szablon, aby zawierał kontrolki podrzędne w kontrolce CatalogZone w formacie trwałości strony. |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Dodaje atrybuty i style HTML, które muszą być renderowane do określonego HtmlTextWriterTagelementu . Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| AddedControl(Control, Int32) |
Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
| ApplyStyle(Style) |
Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| BuildProfileTree(String, Boolean) |
Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control) |
| ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
| ClearChildControlState() |
Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control) |
| Close() |
Przełącza stronę sieci Web z trybu wyświetlania wykazu na normalny tryb przeglądania. (Odziedziczone po CatalogZoneBase) |
| CopyBaseAttributes(WebControl) |
Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| CreateCatalogPartChrome() |
Tworzy wystąpienie CatalogPartChrome obiektu używanego do renderowania elementów interfejsu użytkownika peryferyjnego dla CatalogPart kontrolek w strefie. (Odziedziczone po CatalogZoneBase) |
| CreateCatalogParts() |
Tworzy wystąpienie każdego CatalogPart typu zadeklarowanego w strefie. |
| CreateChildControls() |
Tworzy zestaw kontrolek podrzędnych skojarzonych ze strefą CatalogZoneBase . (Odziedziczone po CatalogZoneBase) |
| CreateControlCollection() |
Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera. (Odziedziczone po Control) |
| CreateControlStyle() |
Tworzy obiekt stylu używany wewnętrznie przez klasę WebControl w celu zaimplementowania wszystkich właściwości powiązanych ze stylem. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| DataBind() |
Wiąże źródło danych ze CompositeControl wszystkimi kontrolkami podrzędnymi i . (Odziedziczone po CompositeControl) |
| DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Dispose() |
Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
| EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| FindControl(String) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego |
| FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
| Focus() |
Ustawia fokus danych wejściowych na kontrolkę. (Odziedziczone po Control) |
| GetDesignModeState() |
Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| GetEffectiveChromeType(Part) |
Zwraca rzeczywistą lub efektywną bieżącą PartChromeTypeWebPart wartość kontrolki, biorąc pod uwagę PartChromeType właściwość strefy i bieżący tryb wyświetlania strony składników Web Part. (Odziedziczone po WebZone) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
| HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
| HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control) |
| InvalidateCatalogParts() |
Niszczy kolekcję kontrolek skojarzonych CatalogPart ze strefą CatalogZoneBase . (Odziedziczone po CatalogZoneBase) |
| IsLiteralContent() |
Określa, czy kontrolka serwera przechowuje tylko zawartość literału. (Odziedziczone po Control) |
| LoadControlState(Object) |
Ładuje stan z poprzedniego żądania strony dla właściwości kontrolki, które powinny być utrwalane w przypadku wycofywania nawet wtedy, gdy stan widoku jest wyłączony w kontrolce. (Odziedziczone po CatalogZoneBase) |
| LoadPostData(String, NameValueCollection) |
Przetwarza stan pól wyboru odpowiadających WebPart kontrolkom w wykazie, gdy strona zostanie wysłana z powrotem na serwer. (Odziedziczone po CatalogZoneBase) |
| LoadViewState(Object) |
Ładuje wcześniej zapisane informacje o stanie dla strefy. (Odziedziczone po CatalogZoneBase) |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| MergeStyle(Style) |
Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control) |
| OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Zawiera deklarację metody podstawowej, która może zastąpić pochodne ToolZone kontrolki w celu obsługi szczegółów zmiany trybów wyświetlania strony dla wyspecjalizowanej strefy. (Odziedziczone po ToolZone) |
| OnInit(EventArgs) |
Rejestruje obiekt strony tak, aby strona wymagała stanu kontroli. (Odziedziczone po CatalogZoneBase) |
| OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie i rejestruje obiekt strony, tak aby wymagał poświadczeń zwrotnych. (Odziedziczone po CatalogZoneBase) |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Zawiera podstawową deklarację metody, która może zastąpić pochodne ToolZone kontrolki w celu obsługi zdarzenia zmiany, które kontrolki składników Web Part są wybierane w wyspecjalizowanej strefie. (Odziedziczone po ToolZone) |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
| RaisePostBackEvent(String) |
Wykonuje akcje skojarzone z jednym z czasowników strefy lub zgłasza zdarzenie, które publikuje z powrotem na serwerze. (Odziedziczone po CatalogZoneBase) |
| RecreateChildControls() |
Odtwarza kontrolki podrzędne w kontrolce pochodzącej z CompositeControlklasy . (Odziedziczone po CompositeControl) |
| RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Renderuje strefę do określonego HtmlTextWriter obiektu. (Odziedziczone po CatalogZoneBase) |
| RenderBeginTag(HtmlTextWriter) |
Renderuje otwierający tag HTML kontrolki strefy do określonego HtmlTextWriter obiektu. (Odziedziczone po WebZone) |
| RenderBody(HtmlTextWriter) |
Zastępuje metodę podstawową, aby renderować obszar treści strefy pochodzącej CatalogZoneBase z klasy. (Odziedziczone po CatalogZoneBase) |
| RenderCatalogPartLinks(HtmlTextWriter) |
Renderuje łącza do poszczególnych CatalogPart kontrolek w CatalogZoneBase strefie. (Odziedziczone po CatalogZoneBase) |
| RenderChildren(HtmlTextWriter) |
Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderContents(HtmlTextWriter) |
Renderuje całą zawartość kontrolki strefy między początkowymi i końcowymi tagami do określonego HtmlTextWriter obiektu. (Odziedziczone po WebZone) |
| RenderControl(HtmlTextWriter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control) |
| RenderEndTag(HtmlTextWriter) |
Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| RenderFooter(HtmlTextWriter) |
Renderuje obszar stopki dla CatalogZoneBase strefy. (Odziedziczone po CatalogZoneBase) |
| RenderHeader(HtmlTextWriter) |
Zastępuje metodę podstawową w celu zapewnienia wyspecjalizowanego renderowania dla obszaru nagłówka wymaganego przez ToolZone kontrolki. (Odziedziczone po ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Renderuje poszczególne czasowniki z kontrolką ToolZone . (Odziedziczone po ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Renderuje czasowniki w obszarze stopki CatalogZoneBase strefy. (Odziedziczone po CatalogZoneBase) |
| ResolveAdapter() |
Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
| ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
| ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
| SaveControlState() |
Zapisuje wszelkie zmiany w CatalogZoneBase stanie kontrolki, które występują po opublikowaniu strony sieci Web z powrotem na serwerze. (Odziedziczone po CatalogZoneBase) |
| SaveViewState() |
Zapisuje wszelkie zmiany stanu widoku, które wystąpiły po opublikowaniu strony z powrotem na serwerze. (Odziedziczone po CatalogZoneBase) |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej. (Odziedziczone po Control) |
| SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| SetTraceData(Object, Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| TrackViewState() |
Śledzi zmiany stanu widoku kontrolki strefy. (Odziedziczone po CatalogZoneBase) |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| Disposed |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET. (Odziedziczone po Control) |
| Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
| Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
| PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
| Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
Jawne implementacje interfejsu
| IAttributeAccessor.GetAttribute(String) |
Pobiera atrybut kontrolki Sieci Web o określonej nazwie. (Odziedziczone po WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Umożliwia projektantowi ponowne utworzenie kolekcji kontrolek podrzędnych kontrolki złożonej w środowisku czasu projektowania. (Odziedziczone po CompositeControl) |
| IControlBuilderAccessor.ControlBuilder |
Aby uzyskać opis tego członka, zobacz ControlBuilder. (Odziedziczone po Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control) |
| IExpressionsAccessor.Expressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control) |
| IPostBackDataHandler.LoadPostData(String, NameValueCollection) |
Implementuje metodę LoadPostData(String, NameValueCollection) , wywołując metodę LoadPostData(String, NameValueCollection)CatalogZoneBase klasy. (Odziedziczone po CatalogZoneBase) |
| IPostBackDataHandler.RaisePostDataChangedEvent() |
Aby uzyskać opis tego elementu członkowskiego, zobacz RaisePostDataChangedEvent(). (Odziedziczone po CatalogZoneBase) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Implementuje metodę RaisePostBackEvent(String) . (Odziedziczone po ToolZone) |
Metody rozszerzania
| FindDataSourceControl(Control) |
Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki. |
| FindFieldTemplate(Control, String) |
Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki. |
| FindMetaTable(Control) |
Zwraca obiekt metatable dla kontrolki zawierającej dane. |
| GetDefaultValues(INamingContainer) |
Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych. |
| GetMetaTable(INamingContainer) |
Pobiera metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable) |
Ustawia metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
| EnableDynamicData(INamingContainer, Type) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, Object) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
Dotyczy
Zobacz też
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla