WebPartZoneBase.LayoutOrientation Propriété

  • Référence

Définition

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

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é

Orientation

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

Exceptions

ArgumentOutOfRangeException

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, y compris le fichier source code-behind et la page .aspx qui contient la zone de 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 WebPartZone1, après avoir chargé la page dans un navigateur. Les contrôles composants 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 Activer/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 composants WebPart contrôles sont disposés dans une zone. Avec l’orientation par défaut Vertical , les contrôles sont affichés 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 affiche les pages web en mode de compatibilité (rétrocompatible 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é DHTML compatMode . Quand Internet Explorer affiche une page en mode standard, dans certains scénarios, elle ne redimensionne pas les cellules dans les tableaux, même si le balisage HTML d’une cellule est <td height="100%">. Par conséquent, WebPart les contrôles et leur zone contenante sont rendus afin que les contrôles ne s’étendent pas jusqu’à la hauteur totale de la zone.

Ce type de rendu se produit dans deux cas.

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

  • Quand la propriété d’une LayoutOrientation zone est définie Horizontalsur , 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 hauteur totale 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