WebPart.ZoneIndex Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft die Indexposition eines WebPart-Steuerelements innerhalb seiner Zone ab.

C#

[System.ComponentModel.Browsable(false)]
public int ZoneIndex { get; }

Eigenschaftswert

Int32

Die numerische Ordnung eines Steuerelements innerhalb seiner Zone. Das erste Steuerelement in einer Zone weist den Indexwert 0 (null) auf.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird der Zugriff auf die Zone Eigenschaften und ZoneIndex für ein benutzerdefiniertes Webpart-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas im Abschnitt Beispiel der WebPart Klassenübersicht erstellt wurde.

Das Codebeispiel enthält ein benutzerdefiniertes Benutzersteuerelement, mit dem Benutzer die Anzeigemodi auf einer Webparts-Seite ändern können. Auf das Benutzersteuerelement wird mithilfe einer Register -Direktive am oberen Rand der Webseite verwiesen, die das Benutzersteuerelement hostet. Eine ausführliche Beschreibung, wie Sie dieses Benutzersteuerelement erstellen und mit Anzeigemodi arbeiten, finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.

ASP.NET (C#)

<%@ 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>

Der zweite Teil des Codebeispiels ist die Webseite. Es gibt zwei <asp:webpartzone> Elemente auf der Seite, die jeweils eine Webpartszone darstellen. Die erste Zone enthält ein Standardsteuerelement Calendar , das zur Laufzeit wie ein WebPart Steuerelement fungiert, da es sich in einer Zone befindet. Die zweite Zone enthält das TextDisplayWebPart -Steuerelement. Wenn ein Benutzer auf die Schaltfläche Zoneninformationen klickt, zeigt das Label1 Steuerelement die Werte der ZoneIndex -Eigenschaft für das Steuerelement und die ID -Eigenschaft der Zone an, die derzeit das Steuerelement enthält.

ASP.NET (C#)

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  String labelText = @"<p><strong>Text WebPart " +
                     "Zone Information</strong></p>";

  void Button1_Click(object sender, EventArgs e)
  {
    // Get the zone for the Web Parts control.
    WebPartZoneBase theZone = textpart1.Zone;
    Label1.Text = labelText +
                  "Zone ID:  " + theZone.ID +
                  @"<br />" +
                  "Zone Index:  " +
                  textpart1.ZoneIndex.ToString();
    // Change the type of button for the verb.
    theZone.VerbButtonType = ButtonType.Button;
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:textdisplaywebpart 
            id="textpart1" 
            runat="server" 
            Title="Text WebPart" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="Button1" 
      Runat="server" 
      Text="Zone Information" 
      OnClick="Button1_Click" />
    <br />
    <asp:Label ID="Label1" runat="server" />
  </form>
</body>
</html>

Hinweise

Die ZoneIndex -Eigenschaft gibt die numerische Reihenfolge (oder Ordnungsposition) eines Webparts-Steuerelements innerhalb seiner Zone im Verhältnis zu anderen Steuerelementen in der Zone an. Das WebPartManager Steuerelement verwendet diese Eigenschaft, um seine Sammlung von Webparts-Steuerelementen auf einer Webseite nachzuverfolgen und zu verwalten.

Wichtig

Sie können nicht davon ausgehen, dass der Wert der ZoneIndex Eigenschaft für ein Steuerelement dem Indexwert für dasselbe Steuerelement innerhalb der WebParts Auflistung der Zone des Steuerelements entspricht. Häufig sind die relative Position eines Steuerelements in seiner Zone (sein ZoneIndex Wert) und sein Index innerhalb der WebParts Auflistung seiner Zone unterschiedliche Werte, wenn Steuerelemente zu Zonen hinzugefügt und daraus entfernt werden.

Gilt für:

Weitere Informationen

• WebZone
• WebPartZone
• WebPartZoneBase
• ASP.NET Webparts-Steuerelemente