Partager via


WebPartZoneBase Classe

Définition

Sert de classe de base à tous les contrôles de zone qui agissent en tant que conteneurs pour les contrôles 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
Dérivé
Implémente

Exemples

L’exemple de code suivant illustre l’utilisation de la WebPartZoneBase classe . Le code montre comment une classe dérivée, WebPartZone, est utilisé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 dans 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 code-beside qui contient le code pour gérer les événements pour la page web principale. Le code de ce fichier montre comment travailler avec 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 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 de 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 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 WebZone et fournit un ensemble de comportements de base 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 contrôles serveur) forme l’interface utilisateur principale d’une application WebPart, la vue normale d’une page avec laquelle les utilisateurs interagissent 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 présentation 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 comprend une section de corps qui contient des contrôles serveur et un objet associé WebPartChrome utilisé pour afficher les contrôles contenus et leurs éléments chrome, tels que leurs verbes, leurs bordures, etc.

En plus des fonctionnalités héritées de la WebZone classe, la classe ajoute un WebPartZoneBase glisser-déplacer de contrôle côté client, des verbes spécifiques (pour activer des actions d’interface utilisateur courantes telles que la réduction, la fermeture, la suppression et la modification des contrôles) 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 de WebPartZoneBaseet qui est conçue pour contenir et fournir des fonctionnalités de disposition et d’autres services pour WebPart les contrôles qui sont liés aux données et affichent des 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 composant dans la zone. Bien que les verbes au niveau de la zone puissent être ajoutés à WebPartZoneBase des zones, par défaut, ils n’en ont pas. Il existe un ensemble de verbes standard fournis avec le jeu de contrôles WebPart à utiliser avec des contrôles de composant, 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 objets verbe standard, tels que CloseVerb, ConnectVerbDeleteVerb, et EditVerb, HelpVerbet MinimizeVerb. Les verbes standard apparaissent dans un menu de verbes (généralement présentés dans l’interface utilisateur sous forme de 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 quel type d’objet cliquable représente un verbe dans l’interface utilisateur.

D’autres membres clés pour l’utilisation des verbes incluent la OnCreateVerbs méthode, qui est un gestionnaire d’événements qui peut être remplacé 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 permettant d’utiliser 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 les contrôles dans une zone, comme CloseWebPart, ConnectWebPartet EditWebPart.

Il existe également un certain nombre de membres de 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 au sein d’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.

Notes

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

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. Bon nombre 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

WebPartZoneBase()

Initialise la classe pour qu'elle soit utilisée par une instance de la classe héritée. Ce constructeur peut être appelé uniquement par une classe héritée.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le 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 contrôles WebPart peut être changée dans une zone.

AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des 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 vers 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 contrôle WebPartZoneBase.

BorderStyle

Obtient ou définit le type de bordure qui entoure un contrôle WebPartZoneBase.

BorderWidth

Obtient ou définit la largeur de la bordure qui entoure un contrôle WebPartZoneBase.

ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du 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 propriété ClientID.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
CloseVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de fermer les contrôles WebPart contenus dans une zone.

ConnectVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de créer des connexions entre des contrôles WebPart.

Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
Controls

Obtient un objet ControlCollection qui représente les contrôles enfants de CompositeControl.

(Hérité de CompositeControl)
ControlStyle

Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DeleteVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de supprimer les contrôles WebPart contenus dans une zone.

DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
DisplayTitle

Obtient la valeur actuelle du texte utilisé comme titre pour une zone WebPartZoneBase lorsque la zone elle-même est visible.

DragDropEnabled

Obtient une valeur qui indique si vous pouvez faire glisser les contrôles WebPart à l'intérieur ou à l'extérieur d'une zone.

DragHighlightColor

Obtient ou définit la couleur qui entoure la bordure d'une zone WebPartZoneBase et de ses zones de déplacement effectives lorsqu'un utilisateur déplace un contrôle.

EditVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de modifier les contrôles WebPart contenus dans une zone.

EmptyZoneText

Obtient ou définit un message qui apparaît lorsqu'un contrôle WebPartZoneBase ne contient aucun contrôle WebPart.

EmptyZoneTextStyle

Obtient les attributs de style pour le texte d'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 de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
ErrorStyle

Obtient les attributs de style pour restituer le message d'erreur qui est affiché si un contrôle WebPart ne peut pas être chargé ou créé.

(Hérité de WebZone)
Events

Obtient la liste des délégués de gestionnaires 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 objet WebPartVerb qui permet à l'utilisateur final d'exporter un fichier de définition XML pour chaque contrôle WebPart contenu dans 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 en cours possèdent 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 objet WebPartVerb utilisé pour accéder au contenu de l'aide pour les contrôles WebPart contenus dans une zone.

ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du 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 indiquant si les contrôles contenus dans 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 par ID et non par index.

(Hérité de Control)
MenuCheckImageStyle

Obtient des attributs de style qui sont appliqués à l'image de coche qui apparaît sur un menu d'actions verbales 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 d'actions verbales de chaque contrôle WebPart contenu dans une zone.

MenuLabelHoverStyle

Obtient des attributs de style qui sont appliqués à l'étiquette d'un menu d'actions verbales dans la barre de titre d'un contrôle WebPart lorsqu'un utilisateur positionne le pointeur de la souris sur l'étiquette.

MenuLabelStyle

Obtient des informations de style pour l'étiquette du menu d'actions verbales déroulant qui apparaît dans la barre de titre de chaque contrôle WebPart contenu dans une zone.

MenuLabelText

Obtient ou définit la valeur qui sert d'étiquette pour le menu d'actions verbales déroulant dans la barre de titre de chaque contrôle WebPart contenu dans une zone.

MenuPopupImageUrl

Obtient ou définit l'URL d'une image qui ouvre le menu d'actions verbales déroulant dans la barre de titre de chaque contrôle WebPart contenu dans une zone.

MenuPopupStyle

Obtient des attributs de style pour le menu d'actions verbales déroulant qui apparaît sur les contrôles WebPart contenus dans une zone.

MenuVerbHoverStyle

Obtient des informations de style pour l'apparence d'un verbe dans un menu d'actions verbales déroulant 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'actions verbales déroulant lorsque le menu s'affiche.

MinimizeVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de réduire les contrôles WebPart contenus dans une zone.

NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
Padding

Obtient ou définit les attributs de marge intérieure des cellules sur la table qui contient les contrôles WebPart dans une zone.

(Hérité de WebZone)
Page

Obtient une référence à l'instance de 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 la page.

(Hérité de Control)
PartChromePadding

Obtient ou définit la distance entre le contenu d'un contrôle WebPart et la bordure du contrôle.

(Hérité de WebZone)
PartChromeStyle

Obtient des caractéristiques de style qui s'appliquent aux bordures des contrôles WebPart contenus dans une zone.

(Hérité de WebZone)
PartChromeType

Obtient ou définit le type de bordure qui encadre les contrôles WebPart contenus dans une zone.

(Hérité de WebZone)
PartStyle

Obtient des caractéristiques de style qui s'appliquent à la bordure et au contenu de chaque contrôle WebPart contenu dans une zone.

(Hérité de WebZone)
PartTitleStyle

Obtient des attributs de style pour le contenu de la barre de titre de chaque contrôle WebPart contenu dans une zone.

(Hérité de WebZone)
RenderClientScript

Obtient une valeur indiquant s'il faut restituer le script client sur une page WebPart.

(Hérité de WebZone)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
RestoreVerb

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de restaurer les contrôles WebPart contenus dans une zone à une taille normale.

SelectedPartChromeStyle

Obtient des informations de style pour l'apparence d'un contrôle WebPart sélectionné dans une zone.

ShowTitleIcons

Obtient ou définit une valeur qui indique si des icônes de titre sont affichées dans la barre de titre de chaque contrôle WebPart contenu dans une zone.

Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un 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 avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur 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 valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebZone)
TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des 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 ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
TitleBarVerbButtonType

Obtient ou définit le type de bouton utilisé pour les verbes dans la barre de titre des contrôles WebPart.

TitleBarVerbStyle

Obtient des attributs de style pour les verbes présents dans la barre de titre d'un contrôle WebPart.

ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.

(Hérité de WebControl)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du 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 cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
VerbButtonType

Obtient ou définit le type de bouton associé aux verbes qui existent dans une zone WebPartZoneBase atteinte via 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 entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la 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 pour les contrôles WebPart contenus dans la zone.

WebPartManager

Obtient une référence au contrôle WebPartManager associé à une instance de contrôle WebZone sur une page WebPart.

(Hérité de WebZone)
WebParts

Obtient la collection de contrôles WebPart contenus dans une zone.

WebPartVerbRenderMode

Obtient ou définit une valeur qui indique comment les verbes doivent être restitués sur les contrôles WebPart contenus dans la zone.

Width

Obtient ou définit la largeur du contrôle serveur web.

(Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls 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 ControlCollection du contrôle serveur.

(Hérité de Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des 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 la page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage 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 les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de 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()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
CloseWebPart(WebPart)

Ferme un contrôle WebPart sélectionné dans une zone.

ConnectWebPart(WebPart)

Initialise le processus de création d'une connexion entre deux contrôles WebPart.

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 des développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Crée le jeu de composants enfants contenus dans une zone.

CreateControlCollection()

Crée un objet ControlCollection qui contient tous les contrôles présents dans une zone.

CreateControlStyle()

Crée un jeu 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 substituer un objet WebPartChrome personnalisé pour modifier l'apparence des contrôles WebPart contenus dans une zone.

DataBind()

Lie une source de données au CompositeControl et à 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 WebPart sélectionné dans une zone.

Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EditWebPart(WebPart)

Initialise le processus de modification d'un contrôle WebPart sélectionné dans une zone.

EndRenderTracing(TextWriter, Object)

Met fin au traçage 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. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à 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 PartChromeType actuelle réelle ou effective d'un contrôle WebPart, étant donné la propriété PartChromeType de la zone et le mode d'affichage actuel de la page WebPart.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetInitialWebParts()

Obtient une collection initiale de contrôles WebPart contenus dans une zone, à partir d'un modèle ou d'un support de stockage.

GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu 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 jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID 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 des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().

(Hérité de Control)
LoadViewState(Object)

Charge des informations d'état enregistrées précédemment pour une zone.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
MinimizeWebPart(WebPart)

Réduit un contrôle WebPart sélectionné dans une zone.

OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’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 utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles 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 contrôles WebPart contenus dans une zone, en fonction des modifications qui se sont produites depuis l'événement de publication (postback) 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)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
Render(HtmlTextWriter)

Génère le rendu de la zone via l'objet HtmlTextWriter spécifié.

RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle de zone via l'objet HtmlTextWriter spécifié.

(Hérité de WebZone)
RenderBody(HtmlTextWriter)

Substitue la méthode de base pour effectuer le rendu du corps d'une zone dérivé de la classe WebPartZoneBase.

RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Génère le rendu de tout le contenu d'un contrôle de zone entre les balises de début et de fin à l'objet via HtmlTextWriter spécifié.

(Hérité de WebZone)
RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
RenderDropCue(HtmlTextWriter)

Génère le rendu des éléments d'interface utilisateur pour indiquer à un utilisateur final l'emplacement où un contrôle WebPart peut être déplacé dans une zone.

RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderFooter(HtmlTextWriter)

Substitue le rendu pour le pied de page d'un contrôle de zone.

(Hérité de WebZone)
RenderHeader(HtmlTextWriter)

Substitue la méthode de base pour restituer l'en-tête d'une zone WebPartZoneBase qui contient des contrôles WebPart.

ResolveAdapter()

Obtient l'adaptateur de contrôles 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 que le client soit en mesure d'utiliser.

(Hérité de Control)
RestoreWebPart(WebPart)

Restaure un contrôle WebPart sélectionné qui a été réduit à un état normal.

SaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.

(Hérité de Control)
SaveViewState()

Enregistre les changements d’état d’affichage qui se sont produits après qu’une page a été republiée sur le serveur.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des 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 d'état d'affichage apportées à une zone afin qu'elles puissent être stockées dans un objet StateBag, et que l'utilisateur puisse y accéder par l'intermédiaire de la propriété ViewState.

Événements

CreateVerbs

Se produit lorsque les verbes sont créés pour une zone qui dérive de la classe WebPartZoneBase.

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, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue 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

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permet à un concepteur de recréer dans l'environnement au moment du design la collection du contrôle composite de contrôles enfants.

(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

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 pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

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)

Définit 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 des 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 des valeurs par défaut pour le contrôle de données spécifié.

TryGetMetaTable(INamingContainer, MetaTable)

Détermine si des métadonnées de table sont disponibles.

EnableDynamicData(INamingContainer, Type)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

S’applique à

Voir aussi