WebPartZoneBase Classe

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Sert de classe de base pour tous les contrôles de zone qui agissent en tant que conteneurs pour WebPart (ou d’autres contrôles serveur ou utilisateur).

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

Héritage: Object

Control

WebControl

CompositeControl

WebZone
WebPartZoneBase

Dérivé: System.Web.UI.WebControls.WebParts.WebPartZone

Implémente: IPostBackEventHandler

Exemples

L’exemple de code suivant illustre l’utilisation de la WebPartZoneBase classe. Le code montre comment une classe dérivée, est WebPartZoneutilisée de manière déclarative dans une page de composants WebPart pour contenir des WebPart contrôles. L’exemple de code comporte quatre sections : les trois premières sections décrivent les fichiers de code, et la quatrième explique comment exécuter le code.

La première partie de l’exemple de code est un contrôle utilisateur qui permet aux utilisateurs de basculer la page en différents modes d’affichage. Pour plus d’informations sur les modes d’affichage des composants WebPart et une description du code dans ce contrôle, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.

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

La deuxième partie de l’exemple de code est un fichier à côté du code qui contient le code permettant de gérer les événements pour la page web principale. Le code de ce fichier montre comment utiliser certains des membres clés WebPartZoneBase par programmation.

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

La troisième partie de l’exemple de code est la page Web qui contient les contrôles qui présentent le WebPartZone comportement de la classe de base WebPartZoneBase et WebPart les contrôles contenus dans les zones.

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

Chargez la page web dans un navigateur. Utilisez le contrôle de liste déroulante Mode d’affichage pour basculer la page en mode création, cliquez sur les WebPart contrôles et essayez de les faire glisser entre les zones visibles. Cliquez sur certains des boutons de la page pour voir l’effet de l’utilisation de différents membres de la WebPartZoneBase classe. Ensuite, basculez la page en mode édition. Vérifiez qu’un WebPart contrôle est positionné dans WebPartZone2, cliquez sur le menu verbes dans la barre de titre du contrôle, puis cliquez sur Modifier pour modifier le contrôle. Terminez la modification de ce contrôle, puis modifiez l’un des contrôles dans l’autre zone. Lorsque vous effectuez ces étapes, notez les différences dans les styles d’interface utilisateur des contrôles et des zones, qui sont l’effet de l’utilisation des différents membres de la WebPartZoneBase classe.

Remarques

Dans le jeu de contrôles Composants WebPart, une zone est un contrôle composite, rendu sous la forme d’une table HTML, qui contient d’autres contrôles dans une région définie d’une page Web. La WebPartZoneBase classe est une zone qui hérite de la classe de base et fournit un ensemble de comportements de base WebZone pour les zones dérivées qui contiennent des WebPart contrôles, des contrôles serveur et des contrôles utilisateur. La combinaison de WebPartZoneBase zones avec WebPart (et d’autres serveurs) forme l’interface utilisateur principale d’une application De composants WebPart, la vue normale d’une page que les utilisateurs interagissent avec la plupart du temps.

Toutes les zones fournissent un ensemble commun d’éléments d’interface utilisateur pour les contrôles qu’elles contiennent. Pour une discussion détaillée des éléments d’interface utilisateur communs à toutes les zones, consultez la rubrique vue d’ensemble de la classe pour la WebZone classe. La WebPartZoneBase zone inclut une section de corps qui contient des contrôles serveur et un objet associé WebPartChrome utilisé pour le rendu des contrôles contenus et de leurs éléments chromes, tels que leurs verbes, leurs bordures, etc.

En plus des fonctionnalités héritées de la classe, la WebPartZoneBase classe ajoute le glissement de contrôle côté client, des verbes spécifiques (pour activer les actions courantes de l’interface utilisateur telles que la réduction, la fermeture, la WebZone suppression et les contrôles d’édition) et des fonctionnalités de style supplémentaires. La WebPartZoneBase classe est également la classe à hériter si vous souhaitez concevoir une zone personnalisée pilotée par la base de données. Par exemple, vous pouvez créer une zone de composants WebPart météo personnalisée qui hérite et WebPartZoneBaseest conçue pour contenir et fournir des fonctionnalités de disposition et d’autres services pour WebPart les contrôles liés aux données et afficher les informations météorologiques.

La WebPartZoneBase classe contient un certain nombre de propriétés permettant d’utiliser des attributs de style dans une zone. Il existe plusieurs propriétés pour les bordures, notamment BorderStyle et BorderWidth. Il existe un groupe de propriétés permettant d’utiliser des attributs de style de menus qui peuvent apparaître dans l’en-tête d’une zone, par MenuLabelStyleexemple, MenuVerbStyleet d’autres.

La WebPartZoneBase classe contient également un certain nombre de membres pour la gestion des verbes dans une zone. Ces membres sont liés aux verbes qui apparaissent sur les contrôles de partie dans la zone. Bien que les verbes au niveau de la zone puissent être ajoutés à WebPartZoneBase des zones, par défaut, ils n’ont pas de verbes au niveau de la zone. Il existe un ensemble de verbes standard fournis avec le jeu de contrôles Composants WebPart à utiliser avec des contrôles de composants, et les développeurs peuvent également ajouter des verbes personnalisés. Certaines propriétés importantes pour l’utilisation de verbes incluent des propriétés qui référencent certains des objets verbes standard, tels que CloseVerb, DeleteVerb ConnectVerbet EditVerb, HelpVerbet , et MinimizeVerb. Les verbes standard apparaissent dans un menu détaillé (généralement présentés dans l’interface utilisateur sous la forme d’un menu déroulant) dans la barre de titre de chaque contrôle contenu dans une zone. Il existe également une VerbButtonType propriété qui vous permet de déterminer le type d’objet cliquable qui représente un verbe dans l’interface utilisateur.

D’autres membres clés pour travailler avec des verbes incluent la OnCreateVerbs méthode, qui est un gestionnaire d’événements qui peut être substitué pour la gestion personnalisée du processus de création de verbes et l’événement CreateVerbs .

La WebPartZoneBase classe contient un certain nombre de membres pour travailler avec WebPart des contrôles contenus dans une zone. La WebParts propriété fait référence à la collection de tous les WebPart contrôles (et autres serveurs) dans la zone. Plusieurs méthodes correspondent aux verbes ou actions standard qu’un utilisateur peut effectuer sur WebPart des contrôles dans une zone, comme CloseWebPart, ConnectWebPartet EditWebPart.

Il existe également un certain nombre de membres dans la WebPartZoneBase classe qui concernent la façon dont les WebPart contrôles sont disposés ou organisés dans la zone. La AllowLayoutChange propriété détermine si les contrôles peuvent être déplacés entre des zones ou réorganisés dans une zone par les utilisateurs. La LayoutOrientation propriété vous permet de déterminer si les contrôles d’une zone sont organisés horizontalement ou verticalement.

Note

Internet Explorer peut afficher la hauteur d’un WebPartZone ou de ses contrôles contenus de manière inattendue, en fonction de l’orientation de la zone. Pour plus d’informations, consultez la documentation relative aux LayoutOrientation propriétés ou aux Height propriétés.

D’autres méthodes de la WebPartZoneBase classe vous fournissent un contrôle programmatique détaillé sur le rendu des différentes zones d’une zone. La plupart de ces méthodes remplacent les méthodes de base héritées de la WebZone classe, pour personnaliser le rendu pour les zones qui contiennent des WebPart contrôles. Les méthodes importantes incluent Render, , RenderBody RenderDropCueet RenderHeader.

Constructeurs

Nom	Description
WebPartZoneBase()	Initialise la classe à utiliser par une instance de classe héritée. Ce constructeur ne peut être appelé que par une classe héritée.

Propriétés

Nom	Description
AccessKey	Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl)
Adapter	Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AllowLayoutChange	Obtient ou définit une valeur qui indique si la disposition des WebPart contrôles peut être modifiée dans une zone.
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control)
Attributes	Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl)
BackColor	Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl)
BackImageUrl	Obtient ou définit l’URL sur une image d’arrière-plan pour une zone. (Hérité de WebZone)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
BorderColor	Obtient ou définit la couleur de la bordure d’un WebPartZoneBase contrôle.
BorderStyle	Obtient ou définit le type de bordure qui entoure un WebPartZoneBase contrôle.
BorderWidth	Obtient ou définit la largeur de la bordure qui entoure un WebPartZoneBase contrôle.
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control)
CloseVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de fermer les WebPart contrôles d’une zone.
ConnectVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de créer des connexions entre WebPart les contrôles.
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants dans un CompositeControl. (Hérité de CompositeControl)
ControlStyle	Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DeleteVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de supprimer les WebPart contrôles d’une zone.
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
DisplayTitle	Obtient la valeur actuelle du texte utilisé comme titre d’une WebPartZoneBase zone lorsque la zone elle-même est visible.
DragDropEnabled	Obtient une valeur qui indique si WebPart les contrôles peuvent être déplacés vers ou hors d’une zone.
DragHighlightColor	Obtient ou définit la couleur autour de la bordure d’une WebPartZoneBase zone et de ses régions drop-cue lorsqu’un utilisateur fait glisser un contrôle.
EditVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de modifier WebPart des contrôles dans une zone.
EmptyZoneText	Obtient ou définit un message qui s’affiche lorsqu’un WebPartZoneBase contrôle ne contient aucun WebPart contrôle.
EmptyZoneTextStyle	Obtient les attributs de style pour le texte de l’espace réservé dans une zone vide. (Hérité de WebZone)
Enabled	Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
ErrorStyle	Obtient les attributs de style pour le rendu du message d’erreur qui s’affiche si un WebPart contrôle ne peut pas être chargé ou créé. (Hérité de WebZone)
Events	Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control)
ExportVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux d’exporter un fichier de définition XML pour chaque WebPart contrôle d’une zone.
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
FooterStyle	Obtient les attributs de style pour le contenu de la zone de pied de page d’une zone. (Hérité de WebZone)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl)
HasAttributes	Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
HasFooter	Obtient une valeur indiquant si une zone a une zone de pied de page.
HasHeader	Obtient une valeur indiquant si une zone a une zone d’en-tête.
HeaderStyle	Obtient les attributs de style pour le contenu de la zone d’en-tête d’une zone. (Hérité de WebZone)
HeaderText	Obtient ou définit le texte de la zone d’en-tête d’une zone. (Hérité de WebZone)
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
HelpVerb	Obtient une référence à un WebPartVerb objet utilisé pour accéder au contenu d’aide pour WebPart les contrôles d’une zone.
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control)
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control)
IsViewStateEnabled	Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control)
LayoutOrientation	Obtient ou définit une valeur qui indique si les contrôles d’une zone sont organisés verticalement ou horizontalement.
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control)
MenuCheckImageStyle	Obtient les attributs de style appliqués à l’image de coche qui s’affiche dans un menu verbes en regard du texte de verbe sélectionné.
MenuCheckImageUrl	Obtient ou définit l’URL d’une image utilisée comme coche dans le menu verbes de chaque WebPart contrôle d’une zone.
MenuLabelHoverStyle	Obtient les attributs de style appliqués à l’étiquette d’un menu verbes dans la barre de titre d’un WebPart contrôle lorsqu’un utilisateur positionne le pointeur de la souris sur l’étiquette.
MenuLabelStyle	Obtient des informations de style pour l’étiquette du menu déroulant verbes qui apparaît dans la barre de titre de chaque WebPart contrôle d’une zone.
MenuLabelText	Obtient ou définit la valeur qui sert d’étiquette pour le menu déroulant verbes dans la barre de titre de chaque WebPart contrôle d’une zone.
MenuPopupImageUrl	Obtient ou définit l’URL d’une image qui ouvre le menu déroulant verbes dans la barre de titre de chaque WebPart contrôle d’une zone.
MenuPopupStyle	Obtient des attributs de style pour le menu déroulant des verbes qui s’affichent sur WebPart les contrôles d’une zone.
MenuVerbHoverStyle	Obtient des informations de style pour l’apparence d’un verbe dans un menu déroulant verbes lorsqu’un utilisateur final positionne le pointeur de la souris sur le verbe.
MenuVerbStyle	Obtient des informations de style pour l’apparence d’un verbe dans un menu déroulant verbes lorsque le menu est affiché.
MinimizeVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de réduire les WebPart contrôles d’une zone.
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control)
Padding	Obtient ou définit les attributs de remplissage de cellule sur le tableau qui contient les WebPart contrôles d’une zone. (Hérité de WebZone)
Page	Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control)
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control)
PartChromePadding	Obtient ou définit la distance entre le contenu d’un WebPart contrôle et la bordure du contrôle. (Hérité de WebZone)
PartChromeStyle	Obtient les caractéristiques de style qui s’appliquent aux bordures des contrôles De composants WebPart contenus dans une zone. (Hérité de WebZone)
PartChromeType	Obtient ou définit le type de bordure qui trame les contrôles de composants WebPart contenus dans une zone. (Hérité de WebZone)
PartStyle	Obtient les caractéristiques de style qui s’appliquent à la bordure et au contenu de chaque contrôle WebPart contenu par une zone. (Hérité de WebZone)
PartTitleStyle	Obtient les attributs de style pour le contenu de la barre de titre pour chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone)
RenderClientScript	Obtient une valeur qui indique s’il faut afficher le script client sur une page de composants WebPart. (Hérité de WebZone)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
RestoreVerb	Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de restaurer WebPart des contrôles dans une zone à la taille normale.
SelectedPartChromeStyle	Obtient des informations de style pour l’apparence d’un contrôle sélectionné WebPart dans une zone.
ShowTitleIcons	Obtient ou définit une valeur qui indique si les icônes de titre sont affichées dans la barre de titre de chaque WebPart contrôle d’une zone.
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl)
SupportsDisabledAttribute	Obtient une valeur qui indique si le contrôle doit définir l’attribut `disabled` de l’élément HTML rendu sur « disabled » lorsque la propriété du IsEnabled contrôle est `false`. (Hérité de CompositeControl)
TabIndex	Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl)
TagKey	Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebZone)
TagName	Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
TitleBarVerbButtonType	Obtient ou définit le type de bouton utilisé pour les verbes dans la barre de titre des WebPart contrôles.
TitleBarVerbStyle	Obtient des attributs de style pour les verbes dans la barre de titre d’un WebPart contrôle.
ToolTip	Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control)
VerbButtonType	Obtient ou définit le type de bouton associé aux verbes qui existent dans une WebPartZoneBase zone lorsqu’il est accessible avec un navigateur plus ancien.
VerbStyle	Obtient les attributs de style pour les verbes d’interface utilisateur associés aux contrôles WebPart dans une zone. (Hérité de WebZone)
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control)
ViewStateMode	Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control)
Visible	Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control)
WebPartChrome	Obtient une référence à l’objet WebPartChrome qui détermine le rendu périphérique des WebPart contrôles dans la zone.
WebPartManager	Obtient une référence au WebPartManager contrôle associé à une WebZone instance de contrôle sur une page de composants WebPart. (Hérité de WebZone)
WebParts	Obtient la collection de contrôles WebPart contenus dans une zone.
WebPartVerbRenderMode	Obtient ou définit une valeur indiquant comment les verbes doivent être rendus sur WebPart les contrôles de la zone.
Width	Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl)

Méthodes

Nom	Description
AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control)
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le suivi au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control)
CloseWebPart(WebPart)	Ferme un contrôle sélectionné WebPart dans une zone.
ConnectWebPart(WebPart)	Lance le processus de création d’une connexion entre deux WebPart contrôles.
CopyBaseAttributes(WebControl)	Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CreateChildControls()	Crée l’ensemble de contrôles enfants contenus dans une zone.
CreateControlCollection()	Crée un ControlCollection objet qui contient tous les contrôles d’une zone.
CreateControlStyle()	Crée un ensemble de caractéristiques de style qui s’appliquent à un contrôle de zone lorsqu’il est visible.
CreateWebPartChrome()	Permet aux zones dérivées de remplacer un objet personnalisé WebPartChrome pour modifier l’apparence des WebPart contrôles dans une zone.
DataBind()	Lie une source de données aux contrôles enfants et à CompositeControl tous ses contrôles enfants. (Hérité de CompositeControl)
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding . (Hérité de Control)
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control)
DeleteWebPart(WebPart)	Supprime un contrôle sélectionné WebPart dans une zone.
Dispose()	Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control)
EditWebPart(WebPart)	Lance le processus de modification d’un contrôle sélectionné WebPart dans une zone.
EndRenderTracing(TextWriter, Object)	Met fin au suivi au moment du design des données de rendu. (Hérité de Control)
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control)
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de Control)
Focus()	Définit le focus d’entrée sur un contrôle. (Hérité de Control)
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetEffectiveChromeType(Part)	Retourne la valeur actuelle réelle PartChromeType ou effective d’un WebPart contrôle, en fonction de la PartChromeType propriété de la zone et du mode d’affichage actuel de la page Composants WebPart.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetInitialWebParts()	Obtient une collection initiale de WebPart contrôles contenus dans une zone, en fonction d’un modèle ou d’un support de stockage.
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Charge les informations d’état précédemment enregistrées pour une zone.
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
MinimizeWebPart(WebPart)	Réduit un contrôle sélectionné WebPart dans une zone.
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control)
OnCreateVerbs(WebPartVerbsEventArgs)	Déclenche l’événement CreateVerbs.
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnInit(EventArgs)	Déclenche l’événement Init. (Hérité de WebZone)
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l’événement PreRender.
OnUnload(EventArgs)	Déclenche l’événement Unload. (Hérité de Control)
OpenFile(String)	Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control)
RaisePostBackEvent(String)	Met à jour l’état de la collection actuelle de WebPart contrôles dans une zone, en fonction des modifications qui se sont produites depuis l’événement de publication le plus récent.
RecreateChildControls()	Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl)
RemovedControl(Control)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control)
Render(HtmlTextWriter)	Restitue la zone à l’objet spécifié HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Affiche la balise HTML ouvrante du contrôle de zone sur l’objet spécifié HtmlTextWriter . (Hérité de WebZone)
RenderBody(HtmlTextWriter)	Remplace la méthode de base pour afficher la zone de corps d’une zone dérivée de la WebPartZoneBase classe.
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Affiche l’intégralité du contenu d’un contrôle de zone entre les balises de début et de fin sur l’objet spécifié HtmlTextWriter . (Hérité de WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control)
RenderDropCue(HtmlTextWriter)	Restitue les éléments d’interface utilisateur pour indiquer à un utilisateur final où un WebPart contrôle qui est déplacé peut être supprimé dans une zone.
RenderEndTag(HtmlTextWriter)	Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderFooter(HtmlTextWriter)	Remplace le rendu du pied de page d’un contrôle de zone. (Hérité de WebZone)
RenderHeader(HtmlTextWriter)	Remplace la méthode de base pour afficher l’en-tête d’une WebPartZoneBase zone qui contient des WebPart contrôles.
ResolveAdapter()	Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control)
RestoreWebPart(WebPart)	Restaure un contrôle sélectionné WebPart qui a été réduit à l’état normal.
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre les modifications de l’état d’affichage qui se sont produites après la publication d’une page sur le serveur.
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Commence le processus de suivi des modifications de l’état d’affichage dans une zone afin qu’elles puissent être stockées dans un StateBag objet et accessibles via la ViewState propriété.

Événements

Nom	Description
CreateVerbs	Se produit lorsque les verbes sont créés pour une zone qui dérive de la WebPartZoneBase classe.
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control)
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control)
Load	Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control)
PreRender	Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control)
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)

Implémentations d’interfaces explicites

Nom	Description
IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permet à un concepteur de recréer la collection de contrôles enfants du contrôle composite dans l’environnement au moment du design. (Hérité de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Pour obtenir une description de ce membre, consultez RaisePostBackEvent(String).

Méthodes d’extension

Nom	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, Object)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.
GetDefaultValues(INamingContainer)	Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.
GetMetaTable(INamingContainer)	Obtient les métadonnées de table pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, Object)	Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable)	Définit les métadonnées de table pour le contrôle de données spécifié.
TryGetMetaTable(INamingContainer, MetaTable)	Détermine si les métadonnées de table sont disponibles.

S’applique à

Voir aussi

Commentaires

Est-ce que cette page vous a été utile?