WebPartZoneBase Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient als Basisklasse für alle Zonensteuerelemente, die als Container für WebPart-Steuerelemente(oder andere Server bzw. Benutzer) fungieren.
public ref class WebPartZoneBase abstract : System::Web::UI::WebControls::WebParts::WebZone, System::Web::UI::IPostBackEventHandlerpublic abstract class WebPartZoneBase : System.Web.UI.WebControls.WebParts.WebZone, System.Web.UI.IPostBackEventHandlertype WebPartZoneBase = class
inherit WebZone
interface IPostBackEventHandlerPublic MustInherit Class WebPartZoneBase
Inherits WebZone
Implements IPostBackEventHandler- Vererbung
- Abgeleitet
- Implementiert
Beispiele
Im folgenden Codebeispiel wird die Verwendung der WebPartZoneBase -Klasse veranschaulicht. Der Code zeigt, wie eine abgeleitete Klasse , WebPartZone, deklarativ auf einer Webpartseite verwendet wird, um Steuerelemente zu enthalten WebPart . Das Codebeispiel umfasst vier Abschnitte: In den ersten drei Abschnitten werden die Codedateien beschrieben, und im vierten Abschnitt wird erläutert, wie der Code ausgeführt wird.
Der erste Teil des Codebeispiels ist ein Benutzersteuerelement, mit dem Benutzer die Seite in verschiedene Anzeigemodi wechseln können. Weitere Informationen zu Anzeigemodi für Webparts und eine Beschreibung des Codes in diesem Steuerelement finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.
<%@ 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" />
<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>
Der zweite Teil des Codebeispiels ist eine Code-Nebendatei, die den Code zum Behandeln von Ereignissen für die Standard-Webseite enthält. Der Code in dieser Datei zeigt, wie sie programmgesteuert mit einigen der Schlüsselmember WebPartZoneBase arbeiten.
using System;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
public partial class WebPartZoneBase_overview : System.Web.UI.Page
{
protected void Page_Load(Object sender, EventArgs e)
{
Label1.Text = DateTime.Now.ToLongDateString();
Label2.Text = String.Empty;
}
protected void Button1_Click(object sender, EventArgs e)
{
if (WebPartZone2.VerbButtonType == ButtonType.Button)
WebPartZone2.VerbButtonType = ButtonType.Link;
else
WebPartZone2.VerbButtonType = ButtonType.Button;
}
protected void Button2_Click(object sender, EventArgs e)
{
if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
WebPartZone1.LayoutOrientation = Orientation.Horizontal;
else
WebPartZone1.LayoutOrientation = Orientation.Vertical;
Page_Load(sender, e);
}
protected void Button3_Click(object sender, EventArgs e)
{
StringBuilder builder = new StringBuilder();
builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
foreach (WebPart part in WebPartZone1.WebParts)
{
builder.AppendLine("ID: " + part.ID
+ "; Type: " + part.GetType()
+ @"<br />");
}
Label2.Text = builder.ToString();
Label2.Visible = true;
}
protected void Button4_Click(object sender, EventArgs e)
{
StringBuilder builder = new StringBuilder();
builder.AppendLine(@"<strong>WebPartZone1 DisplayTitle Property</strong><br />");
builder.AppendLine(WebPartZone1.DisplayTitle + @"<br />");
Label2.Text = builder.ToString();
Label2.Visible = true;
}
}
Imports System.Text
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Partial Public Class WebPartZoneBase_overview
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
Label1.Text = DateTime.Now.ToLongDateString()
Label2.Text = String.Empty
End Sub
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
If WebPartZone2.VerbButtonType = ButtonType.Button Then
WebPartZone2.VerbButtonType = ButtonType.Link
Else
WebPartZone2.VerbButtonType = ButtonType.Button
End If
End Sub
Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
WebPartZone1.LayoutOrientation = Orientation.Horizontal
Else
WebPartZone1.LayoutOrientation = Orientation.Vertical
End If
Page_Load(sender, e)
End Sub
Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim builder As New StringBuilder()
builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
Dim part As WebPart
For Each part In WebPartZone1.WebParts
builder.AppendLine("ID: " + part.ID + "; Type: " _
+ part.GetType().ToString() _
+ "<br />")
Next part
Label2.Text = builder.ToString()
Label2.Visible = True
End Sub
Protected Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim builder As New StringBuilder()
builder.AppendLine("<strong>WebPartZone1 DisplayTitle Property</strong><br />")
builder.AppendLine(WebPartZone1.DisplayTitle + "<br />")
Label2.Text = builder.ToString()
Label2.Visible = True
End Sub
End Class
Der dritte Teil des Codebeispiels ist die Webseite, die die Steuerelemente enthält, die WebPartZone Das Verhalten der Basisklasse WebPartZoneBase aufweisen, und WebPart steuerelemente, die in den Zonen enthalten sind.
<%@ Page Language="C#"
Codefile="webpartzonebase_overview.cs"
Inherits="WebPartZoneBase_overview" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<!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>WebPartZoneBase Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" Runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<table width="75%">
<tr>
<td>
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<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>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
<td valign="top" align="right">
<asp:WebPartZone
ID="WebPartZone2"
Runat="server"
DragHighlightColor="#00ff00"
AllowLayoutChange="true"
EmptyZoneText="Add WebParts to this empty Zone."
BorderWidth="2"
BorderColor="DarkBlue"
BorderStyle="Dashed"
MenuLabelText="Verbs Menu"
MenuPopupImageUrl="label.gif" >
<VerbStyle Font-Italic="true" />
<MenuLabelStyle BackColor="Lime" BorderWidth="1" />
<MenuLabelHoverStyle Font-Bold="true" />
<MenuVerbHoverStyle BackColor="LightGrey" />
<MenuVerbStyle Font-Italic="true" />
<ZoneTemplate>
<asp:Label ID="Label1" Runat="server" Title="Date" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
</tr>
<tr>
<td>
<asp:EditorZone ID="EditorZone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
Runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
</td>
</tr>
</table>
</div>
<asp:Button ID="Button1" Runat="server"
Width="200" Text="Toggle WebPartZone2 Buttons"
OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" Runat="server"
Width="200" Text="Toggle Layout Orientation"
OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" Runat="server"
Width="200" Text="List WebPartZone1 WebParts"
OnClick="Button3_Click" />
<br />
<asp:Button ID="Button4" Runat="server"
Width="200" Text="WebPartZone1 Display Title"
OnClick="Button4_Click" />
<br />
<asp:Label ID="Label2" Runat="server" Visible="false" />
</form>
</body>
</html>
<%@ Page Language="VB"
Codefile="webpartzonebase_overview.vb"
Inherits="WebPartZoneBase_overview" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<!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 id="Head1" runat="server">
<title>WebPartZoneBase Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" Runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<table width="75%">
<tr>
<td>
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<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>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
<td valign="top" align="right">
<asp:WebPartZone
ID="WebPartZone2"
Runat="server"
DragHighlightColor="#00ff00"
AllowLayoutChange="true"
EmptyZoneText="Add WebParts to this empty Zone."
BorderWidth="2"
BorderColor="DarkBlue"
BorderStyle="Dashed"
MenuLabelText="Verbs Menu"
MenuPopupImageUrl="label.gif" >
<VerbStyle Font-Italic="true" />
<MenuLabelStyle BackColor="Lime" BorderWidth="1" />
<MenuLabelHoverStyle Font-Bold="true" />
<MenuVerbHoverStyle BackColor="LightGrey" />
<MenuVerbStyle Font-Italic="true" />
<ZoneTemplate>
<asp:Label ID="Label1" Runat="server" Title="Date" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
</tr>
<tr>
<td>
<asp:EditorZone ID="EditorZone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
Runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
</td>
</tr>
</table>
</div>
<asp:Button ID="Button1" Runat="server"
Width="200" Text="Toggle WebPartZone2 Buttons"
OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" Runat="server"
Width="200" Text="Toggle Layout Orientation"
OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" Runat="server"
Width="200" Text="List WebPartZone1 WebParts"
OnClick="Button3_Click" />
<br />
<asp:Button ID="Button4" Runat="server"
Width="200" Text="WebPartZone1 Display Title"
OnClick="Button4_Click" />
<br />
<asp:Label ID="Label2" Runat="server" Visible="false" />
</form>
</body>
</html>
Laden Sie die Webseite in einen Browser. Verwenden Sie das Dropdownlistensteuerelement Anzeigemodus , um die Seite in den Entwurfsmodus zu wechseln, klicken Sie auf die WebPart Steuerelemente, und versuchen Sie, sie zwischen den sichtbaren Zonen zu ziehen. Klicken Sie auf einige der Schaltflächen auf der Seite, um die Auswirkungen der Verwendung verschiedener Member der WebPartZoneBase Klasse zu sehen. Wechseln Sie als Nächstes die Seite in den Bearbeitungsmodus. Stellen Sie sicher, dass ein WebPart Steuerelement in WebPartZone2positioniert ist, klicken Sie auf der Titelleiste des Steuerelements auf das Verbenmenü, und klicken Sie auf Bearbeiten , um das Steuerelement zu bearbeiten. Beenden Sie die Bearbeitung dieses Steuerelements, und bearbeiten Sie dann eines der Steuerelemente in der anderen Zone. Beachten Sie beim Ausführen dieser Schritte die Unterschiede in den Ui-Stilen der Steuerelemente und Zonen, die sich aus der Verwendung der verschiedenen Member der WebPartZoneBase -Klasse auswirken.
Hinweise
Im Webpart-Steuerelementsatz ist eine Zone ein zusammengesetztes Steuerelement, das als HTML-Tabelle gerendert wird und andere Steuerelemente in einem definierten Bereich einer Webseite enthält. Die WebPartZoneBase -Klasse ist eine Zone, die von der Basisklasse WebZone erbt und einen Basissatz von Verhalten für abgeleitete Zonen bereitstellt, die Steuerelemente, Serversteuerelemente und Benutzersteuerelemente enthalten WebPart . Die Kombination von WebPartZoneBase Zonen mit WebPart (und anderen Server)-Steuerelementen bildet die primäre Benutzeroberfläche einer Webpartanwendung, die normale Ansicht einer Seite, mit der Benutzer die meiste Zeit interagieren.
Alle Zonen stellen einen gemeinsamen Satz von UI-Elementen für die steuerelemente bereit, die sie enthalten. Eine ausführliche Erläuterung der Benutzeroberflächenelemente, die für alle Zonen gemeinsam sind, finden Sie im Thema Klassenübersicht für die WebZone Klasse. Die WebPartZoneBase Zone enthält einen Textkörperabschnitt, der Serversteuerelemente enthält, und ein zugeordnetes WebPartChrome Objekt, das zum Rendern der enthaltenen Steuerelemente und ihrer Chromelemente verwendet wird, z. B. deren Verben, Rahmen usw.
Zusätzlich zu den von der WebZone -Klasse geerbten Features fügt die WebPartZoneBase Klasse clientseitiges Ziehen von Steuerelementen, bestimmte Verben (zum Aktivieren allgemeiner Ui-Aktionen wie Minimieren, Schließen, Löschen und Bearbeiten von Steuerelementen) und zusätzliche Stilfeatures hinzu. Die WebPartZoneBase -Klasse ist auch die Klasse, von der geerbt werden soll, wenn Sie eine benutzerdefinierte Zone entwerfen möchten, die datenbankgesteuert ist. Beispielsweise könnten Sie eine benutzerdefinierte Wetterwebpartzone erstellen, die von erbt und so WebPartZoneBasekonzipiert ist, dass sie Layoutfeatures und andere Dienste für WebPart Steuerelemente enthält und bereitstellen soll, die datengebunden sind und Wetterinformationen anzeigen.
Die WebPartZoneBase -Klasse enthält eine Reihe von Eigenschaften zum Arbeiten mit Formatattributen in einer Zone. Es gibt mehrere Eigenschaften für Rahmen, einschließlich BorderStyle und BorderWidth. Es gibt eine Gruppe von Eigenschaften zum Arbeiten mit Formatattributen von Menüs, die im Header einer Zone angezeigt werden können, z MenuLabelStyle. B. , MenuVerbStyleund andere.
Die WebPartZoneBase -Klasse enthält auch eine Reihe von Membern für die Behandlung von Verben in einer Zone. Diese Member beziehen sich auf die Verben, die in den Teilsteuerelementen in der Zone angezeigt werden. Verben auf Zonenebene können zwar Zonen WebPartZoneBase hinzugefügt werden, verfügen jedoch standardmäßig über keine. Es gibt eine Reihe von Standardverben, die mit dem Webpart-Steuerelementsatz zur Verwendung mit Teilsteuerelementen bereitgestellt werden, und Entwickler können auch benutzerdefinierte Verben hinzufügen. Einige wichtige Eigenschaften für die Arbeit mit Verben sind Eigenschaften, die auf einige der Standardverbenobjekte verweisen, z CloseVerb. B. , ConnectVerb, DeleteVerbund EditVerb, HelpVerbund MinimizeVerb. Die Standardverben werden in einem Verbenmenü (in der Regel in der Benutzeroberfläche als Dropdownmenü) in der Titelleiste jedes Steuerelements angezeigt, das in einer Zone enthalten ist. Es gibt auch eine VerbButtonType Eigenschaft, mit der Sie bestimmen können, welcher Typ von anklickbarem Objekt ein Verb in der Benutzeroberfläche darstellt.
Weitere Wichtige Member zum Arbeiten mit Verben sind die -Methode, bei der OnCreateVerbs es sich um einen Ereignishandler handelt, der für die benutzerdefinierte Behandlung des Verberstellungsprozesses überschrieben werden kann, und das CreateVerbs Ereignis.
Die WebPartZoneBase -Klasse enthält eine Reihe von Membern zum Arbeiten mit WebPart Steuerelementen, die in einer Zone enthalten sind. Die WebParts -Eigenschaft verweist auf die Auflistung aller WebPart Steuerelemente (und anderer Server) in der Zone. Mehrere Methoden entsprechen den Standardverben oder -aktionen, die ein Benutzer für WebPart Steuerelemente in einer Zone ausführen kann, z CloseWebPart. B. , ConnectWebPartund EditWebPart.
Es gibt auch eine Reihe von Membern in der Klasse, die WebPartZoneBase sich darauf beziehen, wie die WebPart Steuerelemente innerhalb der Zone angeordnet oder angeordnet werden. Die AllowLayoutChange -Eigenschaft bestimmt, ob Steuerelemente von Benutzern zwischen Zonen verschoben oder innerhalb einer Zone neu angeordnet werden können. Mit LayoutOrientation der -Eigenschaft können Sie bestimmen, ob die Steuerelemente in einer Zone horizontal oder vertikal angeordnet sind.
Hinweis
Internet-Explorer können die Höhe eines WebPartZone oder seiner enthaltenen Steuerelemente auf unerwartete Weise rendern, abhängig von der Ausrichtung der Zone. Weitere Informationen finden Sie in der Dokumentation zu den LayoutOrientation Eigenschaften oder Height .
Andere Methoden in der WebPartZoneBase -Klasse bieten Ihnen eine detaillierte programmgesteuerte Kontrolle über das Rendern der verschiedenen Bereiche einer Zone. Viele dieser Methoden überschreiben die von der WebZone -Klasse geerbten Basismethoden, um das Rendering für Zonen anzupassen, die Steuerelemente enthalten WebPart . Wichtige Methoden sind Render, RenderBody, RenderDropCueund RenderHeader.
Konstruktoren
| WebPartZoneBase() |
Initialisiert die Klasse zur Verwendung durch eine geerbte Klasseninstanz. Dieser Konstruktor kann nur von einer geerbten Klasse aufgerufen werden. |
Eigenschaften
| AccessKey |
Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AllowLayoutChange |
Ruft einen Wert ab, der angibt, ob das Layout der WebPart-Steuerelemente in einer Zone geändert werden kann, oder legt diesen fest. |
| AppRelativeTemplateSourceDirectory |
Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Geerbt von Control) |
| Attributes |
Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| BackColor |
Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BackImageUrl |
Ruft die URL für ein Hintergrundbild einer Zone ab oder legt sie fest. (Geerbt von WebZone) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| BorderColor |
Ruft die Rahmenfarbe eines WebPartZoneBase-Steuerelements ab oder legt diese fest. |
| BorderStyle |
Ruft die Rahmenart des Rahmens ab, der ein WebPartZoneBase-Steuerelement umgibt, oder legt diese fest. |
| BorderWidth |
Ruft die Breite des Rahmens ab, der ein WebPartZoneBase-Steuerelement umgibt, oder legt diese fest. |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| CloseVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer die WebPart-Steuerelemente in einer Zone schließen können. |
| ConnectVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer Verbindungen zwischen WebPart-Steuerelementen herstellen können. |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente in einem CompositeControl darstellt. (Geerbt von CompositeControl) |
| ControlStyle |
Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ControlStyleCreated |
Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Geerbt von WebControl) |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control) |
| DeleteVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer die WebPart-Steuerelemente in einer Zone löschen können. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| DisplayTitle |
Ruft den aktuellen Wert des Texts ab, der als Titel für eine WebPartZoneBase-Zone verwendet wird, wenn die Zone selbst sichtbar ist. |
| DragDropEnabled |
Ruft einen Wert ab, der angibt, ob WebPart-Steuerelemente in eine Zone bzw. aus einer Zone gezogen werden können. |
| DragHighlightColor |
Ruft die Farbe um den Rahmen einer WebPartZoneBase-Zone und ihrer Drop-Cue-Bereiche beim Ziehen eines Steuerelements ab oder legt diese fest. |
| EditVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer WebPart-Steuerelemente in einer Zone bearbeiten können. |
| EmptyZoneText |
Ruft eine Meldung ab, die angezeigt wird, wenn ein WebPartZoneBase-Steuerelement keine WebPart-Steuerelemente enthält, oder legt diese fest. |
| EmptyZoneTextStyle |
Ruft die Stilattribute für den Platzhaltertext in einer leeren Zone ab. (Geerbt von WebZone) |
| Enabled |
Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Geerbt von WebControl) |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Geerbt von WebControl) |
| EnableViewState |
Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Geerbt von Control) |
| ErrorStyle |
Ruft die Stilattribute zum Rendering der Fehlermeldung ab, die angezeigt wird, wenn ein WebPart-Steuerelement nicht geladen oder erstellt werden kann. (Geerbt von WebZone) |
| Events |
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| ExportVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer eine XML-Definitionsdatei für jedes WebPart-Steuerelement in einer Zone exportieren können. |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| FooterStyle |
Ruft die Stilattribute für den Inhalt des Footerbereichs einer Zone ab. (Geerbt von WebZone) |
| ForeColor |
Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Geerbt von WebControl) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Geerbt von WebControl) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control) |
| HasFooter |
Ruft den Wert ab, der angibt, ob eine Zone einen Footerbereich besitzt. |
| HasHeader |
Ruft den Wert ab, der angibt, ob eine Zone einen Headerbereich besitzt. |
| HeaderStyle |
Ruft die Stilattribute für den Inhalt des Headerbereichs einer Zone ab. (Geerbt von WebZone) |
| HeaderText |
Ruft den Text für den Headerbereich einer Zone ab oder legt ihn fest. (Geerbt von WebZone) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| HelpVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem auf Hilfeinhalt für WebPart-Steuerelemente in einer Zone zugegriffen wird. |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| IsEnabled |
Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LayoutOrientation |
Ruft einen Wert ab, der angibt, ob Steuerelemente in einer Zone vertikal oder horizontal angeordnet werden, oder legt diesen fest. |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Geerbt von Control) |
| MenuCheckImageStyle |
Ruft Stilattribute ab, die auf das Häkchensymbol angewendet werden, das im Verbenmenü neben dem ausgewählten Verbentext angezeigt wird. |
| MenuCheckImageUrl |
Ruft die URL zu einem Bild ab, das im Verbenmenü aller WebPart-Steuerelemente in einer Zone als Häkchen verwendet wird, oder legt diesen fest. |
| MenuLabelHoverStyle |
Ruft Stilattribute ab, die auf die Bezeichnung eines Verbenmenüs auf der Titelleiste eines WebPart-Steuerelements angewendet werden, wenn der Mauszeiger über der Bezeichnung positioniert wird. |
| MenuLabelStyle |
Ruft Stilinformationen für die Bezeichnung des Verben-Dropdownmenüs ab, das auf der Titelleiste aller WebPart-Steuerelemente in einer Zone angezeigt wird. |
| MenuLabelText |
Ruft den Wert ab, der als Bezeichnung für das Verben-Dropdownmenü auf der Titelleiste aller WebPart-Steuerelemente in einer Zone verwendet wird, oder legt diesen Wert fest. |
| MenuPopupImageUrl |
Ruft die URL zu einem Bild ab, das das Verben-Dropdownmenü auf der Titelleiste aller WebPart-Steuerelemente in einer Zone öffnet, oder legt diese URL fest. |
| MenuPopupStyle |
Ruft Stilattribute für das Dropdown-Verbenmenü ab, das für WebPart-Steuerelemente in einer Zone angezeigt wird. |
| MenuVerbHoverStyle |
Ruft Stilinformationen ab, die auf die Darstellung eines Verbs in einem Verben-Dropdownmenü angewendet werden, wenn der Mauszeiger über dem Verb positioniert wird. |
| MenuVerbStyle |
Ruft Stilinformationen ab, die auf die Darstellung eines Verbs in einem Verben-Dropdownmenü angewendet werden, wenn das Menü angezeigt wird. |
| MinimizeVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer WebPart-Steuerelemente in einer Zone minimieren können. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control) |
| Padding |
Ruft die Textabstandsattribute der Tabelle ab, in der die WebPart-Steuerelemente einer Zone enthalten sind, oder legt diese fest. (Geerbt von WebZone) |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Geerbt von Control) |
| PartChromePadding |
Ruft den Abstand zwischen dem Inhalt eines WebPart-Steuerelements und dem Rand des Steuerelements ab oder legt diesen fest. (Geerbt von WebZone) |
| PartChromeStyle |
Ruft Stileigenschaften ab, die auf die Rahmen der in einer Zone enthaltenen Webparts-Steuerelemente angewendet werden. (Geerbt von WebZone) |
| PartChromeType |
Ruft den Typ des Rahmens ab, der das in einer Zone enthaltene Webparts-Steuerelement umgibt, oder legt diesen fest. (Geerbt von WebZone) |
| PartStyle |
Ruft Stileigenschaften ab, die auf den Rahmen und Inhalt der in einer Zone enthaltenen Webparts-Steuerelemente angewendet werden. (Geerbt von WebZone) |
| PartTitleStyle |
Ruft die Stilattribute für den Titelleisteninhalt aller in einer Zone enthaltenen Webparts-Steuerelemente ab. (Geerbt von WebZone) |
| RenderClientScript |
Ruft einen Wert ab, der angibt, ob Clientskripts auf einer Webparts-Seite gerendert werden. (Geerbt von WebZone) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| RestoreVerb |
Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer WebPart-Steuerelemente in einer Zone auf die normale Größe wiederherstellen können. |
| SelectedPartChromeStyle |
Ruft Stilinformationen zur Darstellung eines ausgewählten WebPart-Steuerelements in einer Zone ab. |
| ShowTitleIcons |
Ruft einen Wert ab, der angibt, ob auf der Titelleiste aller WebPart-Steuerelemente in einer Zone Titelsymbole angezeigt werden, oder legt diesen fest. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft das Design ab, das auf das Steuerelement angewendet werden soll. (Geerbt von WebControl) |
| Style |
Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob vom Steuerelement das |
| TabIndex |
Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Geerbt von WebControl) |
| TagKey |
Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebZone) |
| TagName |
Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TemplateControl |
Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control) |
| TitleBarVerbButtonType |
Ruft den Schaltflächentyp ab, der für die Verben auf der Titelleiste von WebPart-Steuerelementen verwendet wird, oder legt diesen fest. |
| TitleBarVerbStyle |
Ruft Stilattribute für Verben auf der Titelleiste eines WebPart-Steuerelements ab. |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control) |
| VerbButtonType |
Ruft den Schaltflächentyp ab, der den Verben in einer WebPartZoneBase-Zone zugeordnet ist, wenn mit einem älteren Browser auf diese zugegriffen wird, oder legt diesen fest. |
| VerbStyle |
Ruft die Stilattribute für die Verben der Benutzeroberfläche ab, die den Webparts-Steuerelementen in einer Zone zugeordnet sind. (Geerbt von WebZone) |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| Visible |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird. (Geerbt von Control) |
| WebPartChrome |
Ruft einen Verweis auf das WebPartChrome-Objekt ab, das das periphere Rendering für WebPart-Steuerelemente in der Zone bestimmt. |
| WebPartManager |
Ruft einen Verweis auf das WebPartManager-Steuerelement ab, das einer Instanz des WebZone-Steuerelements auf einer Webparts-Seite zugeordnet ist. (Geerbt von WebZone) |
| WebParts |
Ruft die Auflistung von in einer Zone enthaltenen Webparts-Steuerelementen ab. |
| WebPartVerbRenderMode |
Ruft einen Wert ab, der angibt, wie die Verben für WebPart-Steuerelemente in der Zone gerendert werden sollen, oder legt diesen fest. |
| Width |
Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest. (Geerbt von WebControl) |
Methoden
| AddAttributesToRender(HtmlTextWriter) |
Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Geerbt von Control) |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| ClearChildControlState() |
Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Geerbt von Control) |
| CloseWebPart(WebPart) |
Schließt ein ausgewähltes WebPart-Steuerelement in einer Zone. |
| ConnectWebPart(WebPart) |
Initiiert den Prozess der Herstellung einer Verbindung zwischen zwei WebPart-Steuerelementen. |
| CopyBaseAttributes(WebControl) |
Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CreateChildControls() |
Erstellt den Satz von in einer Zone enthaltenen untergeordneten Steuerelementen. |
| CreateControlCollection() |
Erstellt ein ControlCollection-Objekt, das alle Steuerelemente in einer Zone enthält. |
| CreateControlStyle() |
Erstellt einen Satz von Stileigenschaften, die auf ein Zonensteuerelement angewendet werden, wenn dieses sichtbar ist. |
| CreateWebPartChrome() |
Ermöglicht es abgeleiteten Zonen, ein benutzerdefiniertes WebPartChrome-Objekt zu ersetzen, um die Darstellung von WebPart-Steuerelementen in einer Zone zu ändern. |
| DataBind() |
Bindet eine Datenquelle an das CompositeControl und an alle seine untergeordneten Steuerelemente. (Geerbt von CompositeControl) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| DeleteWebPart(WebPart) |
Löscht ein ausgewähltes WebPart-Steuerelement in einer Zone. |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control) |
| EditWebPart(WebPart) |
Initiiert den Prozess der Bearbeitung eines ausgewählten WebPart-Steuerelements in einer Zone. |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| EnsureChildControls() |
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetEffectiveChromeType(Part) |
Gibt den tatsächlichen bzw. den effektiven aktuellen PartChromeType- Wert eines WebPart-Steuerelements entsprechend der PartChromeType-Eigenschaft der Zone und dem aktuellen Anzeigemodus der Webparts-Seite zurück. |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetInitialWebParts() |
Ruft auf der Grundlage einer Vorlage oder eines Speichermediums eine Anfangsauflistung von in einer Zone enthaltenen WebPart-Steuerelementen ab. |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Geerbt von Control) |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadViewState(Object) |
Lädt zuvor gespeicherte Zustandsinformationen für eine Zone. |
| MapPathSecure(String) |
Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| MergeStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| MinimizeWebPart(WebPart) |
Minimiert ein ausgewähltes WebPart-Steuerelement in einer Zone. |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird. (Geerbt von Control) |
| OnCreateVerbs(WebPartVerbsEventArgs) |
Löst das CreateVerbs-Ereignis aus. |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von WebZone) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control) |
| RaisePostBackEvent(String) |
Aktualisiert auf der Grundlage der Änderungen seit dem letzten Postbackereignis den Status der aktuellen Auflistung von WebPart-Steuerelementen in einer Zone. |
| RecreateChildControls() |
Erstellt in einem von CompositeControl abgeleiteten Steuerelement die untergeordneten Steuerelemente neu. (Geerbt von CompositeControl) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert die Zone im angegebenen HtmlTextWriter-Objekt. |
| RenderBeginTag(HtmlTextWriter) |
Rendert das öffnende HTML-Tag des Zonensteuerelements in dem angegebenen HtmlTextWriter-Objekt. (Geerbt von WebZone) |
| RenderBody(HtmlTextWriter) |
Überschreibt die Basismethode, um den Inhaltsbereich einer von der WebPartZoneBase-Klasse abgeleiteten Zone zu rendern. |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderContents(HtmlTextWriter) |
Rendert den gesamten zwischen dem Anfangs- und dem Endtag liegenden Inhalt eines Zonensteuerelements im angegebenen HtmlTextWriter-Objekt. (Geerbt von WebZone) |
| RenderControl(HtmlTextWriter) |
Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| RenderDropCue(HtmlTextWriter) |
Rendert Benutzeroberflächenelemente, um anzuzeigen, wo das WebPart-Steuerelement, das gezogen wird, in einer Zone abgelegt werden kann. |
| RenderEndTag(HtmlTextWriter) |
Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderFooter(HtmlTextWriter) |
Überschreibt das Rendering des Footers eines Zonensteuerelements. (Geerbt von WebZone) |
| RenderHeader(HtmlTextWriter) |
Überschreibt die Basismethode, um den Header einer WebPartZoneBase-Zone zu rendern, die WebPart-Steuerelemente enthält. |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control) |
| RestoreWebPart(WebPart) |
Stellt den normalen Zustand eines ausgewählten, zuvor minimierten WebPart-Steuerelements wieder her. |
| SaveControlState() |
Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SaveViewState() |
Speichert alle Ansichtszustandsänderungen, die nach dem Zurücksenden einer Seite an den Server aufgetreten sind |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Startet den Prozess der Nachverfolgung von Änderungen am Ansichtszustand für eine Zone, sodass diese in einem StateBag-Objekt gespeichert werden können und über die ViewState-Eigenschaft auf sie zugegriffen werden kann. |
Ereignisse
| CreateVerbs |
Tritt ein, wenn die Verben für eine von der WebPartZoneBase-Klasse abgeleitete Zone erstellt werden. |
| DataBinding |
Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control) |
| Disposed |
Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Geerbt von Control) |
| Init |
Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control) |
| Load |
Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control) |
| Unload |
Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| IAttributeAccessor.GetAttribute(String) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Geerbt von WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Ermöglicht es einem Designer, die Auflistung der untergeordneten Steuerelemente eines zusammengesetzten Steuerelements in der Entwurfszeitumgebung erneut zu erstellen. (Geerbt von CompositeControl) |
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Elements finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Elements finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Elements finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Elements finden Sie unter HasDataBindings. (Geerbt von Control) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Elements finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Elements finden Sie unter HasExpressions. (Geerbt von Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Eine Beschreibung dieses Elements finden Sie unter RaisePostBackEvent(String). |
Erweiterungsmethoden
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(INamingContainer) |
Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. |
| GetMetaTable(INamingContainer) |
Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. |
| SetMetaTable(INamingContainer, MetaTable) |
Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
| EnableDynamicData(INamingContainer, Type) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
| EnableDynamicData(INamingContainer, Type, Object) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
Gilt für:
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für