WebPart.ZoneIndex, propriété
Assembly : System.Web (dans system.web.dll)
La propriété ZoneIndex indique l'ordre numérique (ou position ordinale) d'un contrôle WebPart dans sa zone, par rapport aux autres contrôles présents dans la zone. Le contrôle WebPartManager utilise cette propriété pour assurer le suivi et gérer sa collection de contrôles WebPart sur une page Web.
Important : |
|---|
| Vous ne pouvez pas supposer que la valeur de la propriété ZoneIndex d'un contrôle égalera la valeur d'index du même contrôle dans la collection WebParts de la zone du contrôle. En général, la position relative d'un contrôle dans sa zone (sa valeur ZoneIndex), et son index dans la collection WebParts de sa zone, auront des valeurs différentes étant donné que des contrôles sont ajoutés et supprimés des zones. |
L'exemple de code suivant montre comment accéder aux propriétés Zone et ZoneIndex d'un contrôle WebPart personnalisé. Cet exemple suppose qu'un contrôle personnalisé, TextDisplayWebPart, créé dans la section Exemple de la vue d'ensemble de la classe WebPart, est utilisé.
L'exemple de code contient un contrôle utilisateur personnalisé qui permet aux utilisateurs de modifier les modes d'affichage sur une page WebPart. Le contrôle utilisateur est référencé au moyen d'une directive Register située en haut de la page Web qui héberge le contrôle. Pour obtenir une description détaillée sur la manière de créer ce contrôle utilisateur et d'utiliser les modes d'affichage, consultez Procédure pas à pas : développement et utilisation d'un contrôle serveur personnalisé.
<%@ 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" /> <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>
La seconde partie de l'exemple de code est la page Web. La page contient deux éléments <asp:webpartzone>, chacun représentant une zone WebPart. La première zone contient un contrôle Calendar standard qui joue le rôle de contrôle WebPart au moment de l'exécution parce qu'il est présent dans une zone. La deuxième zone contient le contrôle TextDisplayWebPart. Lorsqu'un utilisateur clique sur le bouton Informations de zone, le contrôle Label1 affiche les valeurs de la propriété ZoneIndex du contrôle, et la propriété ID de la zone qui contient actuellement le contrôle.
<%@ page language="C#" %> <%@ register TagPrefix="uc1" TagName="DisplayModeMenuCS" Src="DisplayModeMenuCS.ascx" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="TextDisplayWebPartCS"%> <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> <head id="Head1" runat="server"> </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>
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Important :