WebPartZoneBase.LayoutOrientation Propriété

Définition

Obtient ou définit une valeur indiquant si les contrôles contenus dans une zone sont organisés verticalement ou horizontalement.

public:
 virtual property System::Web::UI::WebControls::Orientation LayoutOrientation { System::Web::UI::WebControls::Orientation get(); void set(System::Web::UI::WebControls::Orientation value); };
public virtual System.Web.UI.WebControls.Orientation LayoutOrientation { get; set; }
member this.LayoutOrientation : System.Web.UI.WebControls.Orientation with get, set
Public Overridable Property LayoutOrientation As Orientation

Valeur de propriété

Valeur Orientation qui détermine le mode d'organisation des contrôles dans une zone. L'orientation par défaut est Vertical.

Exceptions

La valeur ne fait pas partie des valeurs Orientation énumérées.

Exemples

L’exemple de code suivant illustre l’utilisation déclarative et programmatique de la LayoutOrientation propriété sur un WebPartZone contrôle. Pour obtenir l’exemple de code complet, notamment le fichier source code-behind et la page .aspx qui contient la zone dans ce code, consultez la vue d’ensemble de la WebPartZoneBase classe.

Notez que la LayoutOrientation propriété a une valeur qui lui est affectée dans le balisage déclaratif. Cette valeur a un impact sur WebPartZone1, une fois que vous avez chargé la page dans un navigateur. Les contrôles WebPart dans la zone sont affichés horizontalement.

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

Vous pouvez cliquer sur le bouton Désactiver l’orientation de la disposition pour modifier l’orientation de la zone. Le code permettant de basculer l’orientation se produit dans l’exemple de code suivant de la classe partielle.

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

Remarques

La LayoutOrientation propriété concerne la façon dont les contrôles WebPart sont disposés dans une zone. Avec l’orientation par défaut Vertical , les contrôles sont rendus dans une disposition de haut en bas, en fonction de la ZoneIndex valeur de chaque contrôle. Avec une Horizontal orientation, les contrôles sont disposés côte à côte, sous réserve de la largeur de la zone.

Internet Explorer peut affecter la hauteur d’un WebPart contrôle et la hauteur de la zone qui le contient. Internet Explorer restitue les pages web en mode de compatibilité (compatibilité descendante avec les versions précédentes du navigateur) ou en mode standard (déterminé par la présence d’une DOCTYPE déclaration dans la page). Pour plus d’informations sur ces modes, consultez la propriété compatMode DHTML. Quand Internet Explorer affiche une page en mode standard, dans certains scénarios, il ne redimensionne pas les cellules des tableaux, même lorsque le balisage HTML d’une cellule est <td height="100%">. Par conséquent, WebPart les contrôles et leur zone de conteneur sont rendus de sorte qu’ils ne s’étendent pas à la pleine hauteur de la zone.

Ce type de rendu se produit dans deux cas.

  • Lorsque la propriété d’une LayoutOrientation zone est définie sur Vertical, et que vous définissez explicitement la hauteur sur la zone. Pour permettre aux contrôles de remplir la pleine hauteur de la zone, ne spécifiez pas la hauteur d’une zone horizontale.

  • Lorsque la propriété d’une LayoutOrientation zone est définie sur Horizontal, et que vous ne définissez pas explicitement la hauteur de la zone (ou des contrôles contenus). Pour permettre aux contrôles de remplir la pleine hauteur de la zone, définissez la hauteur de la zone ou des contrôles dans une zone verticale.

L’exemple de code de cette rubrique illustre l’utilisation normale de la LayoutOrientation propriété . Pour obtenir un exemple de code qui illustre le problème de rendu lié à la hauteur et comment le contourner, consultez la Height propriété .

S’applique à

Voir aussi