WebPartZoneBase Klasse

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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::IPostBackEventHandler

public abstract class WebPartZoneBase : System.Web.UI.WebControls.WebParts.WebZone, System.Web.UI.IPostBackEventHandler

type WebPartZoneBase = class
    inherit WebZone
    interface IPostBackEventHandler

Public MustInherit Class WebPartZoneBase
Inherits WebZone
Implements IPostBackEventHandler

Vererbung

Object

Control

WebControl

CompositeControl

WebZone

WebPartZoneBase

Abgeleitet

System.Web.UI.WebControls.WebParts.WebPartZone

Implementiert

IPostBackEventHandler

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, 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 Webparts-Seite.

<%@ 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 Hauptwebseite 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 anzuzeigen. Wechseln Sie als Nächstes die Seite in den Bearbeitungsmodus. Stellen Sie sicher, dass ein WebPart Steuerelement in WebPartZone2positioniert ist, klicken Sie auf das Menü Verben in der Titelleiste des Steuerelements, 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 ergeben.

Hinweise

Im Webparts-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 Verhaltensweisen 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 Webparts-Anwendung, 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 ui-Elemente, die für alle Zonen gemeinsam sind, finden Sie im Thema klassenübersicht für die WebZone Klasse. Die WebPartZoneBase Zone enthält einen Textabschnitt, der Serversteuerelemente enthält, und ein zugeordnetes WebPartChrome Objekt, das zum Rendern der enthaltenen Steuerelemente und ihrer Chromelemente wie verben, Rahmen usw. verwendet wird.

Zusätzlich zu den features, die von der WebZone -Klasse geerbt werden, fügt die WebPartZoneBase -Klasse das ziehen von clientseitigen Steuerelementen, bestimmte Verben (um allgemeine 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. Sie können beispielsweise eine benutzerdefinierte Wetterwebpartszone erstellen, die von erbt und layoutfeatures WebPartZoneBaseund andere Dienste für WebPart Steuerelemente enthält und bereitstellt, die datengebunden sind und Wetterinformationen anzeigen.

Die WebPartZoneBase -Klasse enthält eine Reihe von Eigenschaften zum Arbeiten mit Stilattributen in einer Zone. Es gibt mehrere Eigenschaften für Rahmen, einschließlich BorderStyle und BorderWidth. Es gibt eine Gruppe von Eigenschaften für die Arbeit mit Stilattributen von Menüs, die in der Kopfzeile 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 Part-Steuerelementen in der Zone angezeigt werden. Verben auf Zonenebene können zwar Zonen WebPartZoneBase hinzugefügt werden, haben aber standardmäßig keine. Es gibt eine Reihe von Standardverben, die mit dem Webparts-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 auf der Benutzeroberfläche darstellt.

Weitere wichtige Member für die Arbeit 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 Serversteuerelemente) 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 zwischen Zonen verschoben oder innerhalb einer Zone von Benutzern 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 kann die Höhe eines WebPartZone oder seiner enthaltenen Steuerelemente je nach Ausrichtung der Zone auf unerwartete Weise rendern. Weitere Informationen finden Sie in der Dokumentation für die LayoutOrientation - oder - Height Eigenschaften.

Andere Methoden in der WebPartZoneBase -Klasse bieten Ihnen eine detaillierte programmgesteuerte Steuerung des Renderings 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 disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist. (Geerbt von CompositeControl)
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 null fest. (Geerbt von Control)
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 id-Parameter. (Geerbt von Control)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Geerbt von Control)
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

Weitere Informationen

• WebPart
• ToolZone
• ASP.NET Webparts-Steuerelemente