BaseDataList.HorizontalAlign Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the horizontal alignment of a data listing control within its container.

public:
 virtual property System::Web::UI::WebControls::HorizontalAlign HorizontalAlign { System::Web::UI::WebControls::HorizontalAlign get(); void set(System::Web::UI::WebControls::HorizontalAlign value); };

[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.HorizontalAlign HorizontalAlign { get; set; }

public virtual System.Web.UI.WebControls.HorizontalAlign HorizontalAlign { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.HorizontalAlign : System.Web.UI.WebControls.HorizontalAlign with get, set

member this.HorizontalAlign : System.Web.UI.WebControls.HorizontalAlign with get, set

Public Overridable Property HorizontalAlign As HorizontalAlign

Property Value

HorizontalAlign

One of the HorizontalAlign values. The default value is NotSet.

Attributes: BindableAttribute

Examples

The following code example demonstrates how to use the HorizontalAlign property to specify the horizontal alignment of the data-bound control.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         // Load sample data only once when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Index_Change(Object sender, EventArgs e) 
      {

         ItemsGrid.HorizontalAlign = (HorizontalAlign)HorizontalAlignList.SelectedIndex;

      }
 
   </script>
 
<head runat="server">
    <title>BaseDataList HorizontalAlign Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BaseDataList HorizontalAlign Example</h3>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           GridLines="Both"
           HorizontalAlign="NotSet"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>

      <br />
      <br />

     <h4>Select the horizontal alignment style:</h4>

           <table cellpadding="5">

        <tr>

           <td>

              Horizontal alignment style:

           </td>

        </tr>

        <tr>

           <td>

              <asp:DropDownList id="HorizontalAlignList"
                   AutoPostBack="True"
                   OnSelectedIndexChanged="Index_Change"
                   runat="server">

                 <asp:ListItem Value="0" Selected="True">NotSet</asp:ListItem>
                 <asp:ListItem Value="1">Left</asp:ListItem>
                 <asp:ListItem Value="2">Center</asp:ListItem>
                 <asp:ListItem Value="3">Right</asp:ListItem>

              </asp:DropDownList>

           </td>

        </tr>

     </table>

   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataGrid control.
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(string)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 to 8 
        
            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 
 
         ' Load sample data only once when the page is first loaded.
         If Not IsPostBack Then 
  
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()

         End If

      End Sub

      Sub Index_Change(sender As Object, e As EventArgs) 

         ItemsGrid.HorizontalAlign = CType(HorizontalAlignList.SelectedIndex, HorizontalAlign)

      End Sub
 
   </script>
 
<head runat="server">
    <title>BaseDataList HorizontalAlign Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BaseDataList HorizontalAlign Example</h3>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           GridLines="Both"
           HorizontalAlign="NotSet"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>

      <br />
      <br />
     <h4>Select the horizontal alignment style:</h4>

           <table cellpadding="5">

        <tr>

           <td>

              Horizontal alignment style:

           </td>

        </tr>

        <tr>

           <td>

              <asp:DropDownList id="HorizontalAlignList"
                   AutoPostBack="True"
                   OnSelectedIndexChanged="Index_Change"
                   runat="server">

                 <asp:ListItem Value="0" Selected="True">NotSet</asp:ListItem>
                 <asp:ListItem Value="1">Left</asp:ListItem>
                 <asp:ListItem Value="2">Center</asp:ListItem>
                 <asp:ListItem Value="3">Right</asp:ListItem>

              </asp:DropDownList>

           </td>

        </tr>

         </table>
   </form>
 
</body>
</html>

Remarks

Use the HorizontalAlign property to specify the horizontal alignment of a data listing control within its container. This property is set with one of the HorizontalAlign enumeration values. The following table lists the possible values.

Value	Description
`NotSet`	The horizontal alignment is not set.
`Left`	The data listing control is left-aligned within its container.
`Center`	The data listing control is centered within its container.
`Right`	The data listing control is right-aligned within its container.

Applies to

Share via