WebPartZoneBase.LayoutOrientation Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che indica se i controlli di una zona sono disposti verticalmente o orizzontalmente.

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

Valore della proprietà

Orientation

Valore Orientation che determina la modalità di disposizione dei controlli di una zona. L'orientamento predefinito è Vertical.

Eccezioni

ArgumentOutOfRangeException

Il valore non fa parte dei valori Orientation enumerati.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo e programmatico della LayoutOrientation proprietà in un WebPartZone controllo. Per l'esempio di codice completo, incluso il file di origine code-behind e la pagina aspx che contiene la zona in questo codice, vedere la panoramica della WebPartZoneBase classe.

Si noti che la LayoutOrientation proprietà ha un valore assegnato nel markup dichiarativo. Questo valore influisce su WebPartZone1, dopo aver caricato la pagina in un browser. I controlli Web part nella zona vengono sottoposti a rendering orizzontalmente.

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

È possibile fare clic sul pulsante Attiva orientamento layout per modificare l'orientamento della zona. Il codice per attivare l'orientamento si verifica nell'esempio di codice seguente dalla classe parziale.

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

Commenti

La LayoutOrientation proprietà riguarda il modo in cui vengono disposti i controlli Web part in una zona. Con l'orientamento predefinito Vertical , i controlli vengono visualizzati in una disposizione superiore a inferiore, in base al ZoneIndex valore di ogni controllo. Con un Horizontal orientamento, i controlli sono disposti affiancati, soggetti alla larghezza della zona.

Internet Explorer può influire sull'altezza di un WebPart controllo e sull'altezza della zona che lo contiene. Internet Explorer esegue il rendering delle pagine Web in modalità compatibilità (compatibile con le versioni precedenti del browser) o in modalità standard (determinata dalla presenza di una DOCTYPE dichiarazione nella pagina). Per informazioni su queste modalità, vedere la proprietà compatMode DHTML. Quando Internet Explorer esegue il rendering di una pagina in modalità standard, in alcuni scenari non ridimensiona le celle nelle tabelle, anche quando il markup HTML di una cella è <td height="100%">. Di conseguenza, WebPart i controlli e la loro zona contenente vengono sottoposti a rendering in modo che i controlli non si estendono all'altezza completa della zona.

Questo tipo di rendering si verifica in due casi.

Quando la proprietà di LayoutOrientation una zona è impostata su Verticale si imposta in modo esplicito l'altezza sulla zona. Per abilitare i controlli per riempire l'altezza completa della zona, non specificare l'altezza di una zona orizzontale.
Quando la proprietà di LayoutOrientation una zona è impostata su Horizontale non si imposta in modo esplicito l'altezza della zona (o dei controlli contenuti). Per abilitare i controlli per riempire l'altezza completa della zona, impostare l'altezza della zona o dei controlli in una zona verticale.

L'esempio di codice in questo argomento illustra l'utilizzo normale della LayoutOrientation proprietà. Per un esempio di codice che illustra il problema di rendering correlato all'altezza e come risolverlo, vedere la Height proprietà .

Si applica a