DataGridColumn.HeaderImageUrl Property
Gets or sets the location of an image to display in the header section of the column.
[Visual Basic] Public Overridable Property HeaderImageUrl As String [C#] public virtual string HeaderImageUrl {get; set;} [C++] public: __property virtual String* get_HeaderImageUrl(); public: __property virtual void set_HeaderImageUrl(String*); [JScript] public function get HeaderImageUrl() : String; public function set HeaderImageUrl(String);
Property Value
The location of an image to display in the header section of the column. The default value is String.Empty.
Remarks
Use the HeaderImageUrl property to specify the URL of an image to display in the header section of the column. You can use a relative or an absolute URL. A relative URL relates the location of the image to the location of the Web page without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the path to the image in code. An absolute URL provides the complete path, so moving the site to another directory requires updating the code.
Note If you want to display text instead of an image in the header section of the column, set the HeaderText property instead of this property.
Example
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <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))) dt.Columns.Add(new DataColumn("BooleanValue", GetType(Boolean))) ' Populate the table with sample values. Dim i As Integer For i = 0 To 4 dr = dt.NewRow() dr(0) = i dr(1) = "Item " & i.ToString() dr(2) = 1.23 * (i + 1) dr(3) = False dt.Rows.Add(dr) Next i ' To persist the data source between posts to the server, store ' it in session state. Session("Source") = dt 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 ' Make sure to set the header text before binding the data to ' the DataGrid control; otherwise, the change will not appear ' until the next time the page is refreshed. ItemsGrid.Columns(0).HeaderText = "Item" ItemsGrid.DataSource = CreateDataSource() ItemsGrid.DataBind() End If End Sub Sub Button_Click(sender As Object, e As EventArgs) Dim subtotal As Double = 0.0 ' Update the data source with the user's selection and ' calculate the subtotal. Dim dt As DataTable = UpdateSource(subtotal) ' Display the subtotal in the footer section of the third column. ItemsGrid.Columns(2).FooterText = "Subtotal: " & subtotal.ToString("c") ' Create a DataView and bind it to the DataGrid control. Dim dv As DataView = New DataView(dt) ItemsGrid.DataSource = dv ItemsGrid.DataBind() End Sub ' This version of UpdateSource updates the data source and ' calculates the subtotal. Function UpdateSource(ByRef subtotal As Double) As DataTable ' Retrieve the data table from session state. Dim dt As DataTable = CType(Session("Source"), DataTable) Dim item As DataGridItem ' Iterate through the Items collection and update the data source ' with the user's selections. If an item is selected, add the ' amount of the item to the subtotal. For Each item in ItemsGrid.Items ' Retrieve the SelectCheckBox CheckBox control from the ' specified item (row) in the DataGrid control. Dim selection As CheckBox = CType(item.FindControl("SelectCheckBox"), CheckBox) If Not selection Is Nothing ' Update the BooleanValue field with the value of the check box. dt.Rows(item.ItemIndex)(3) = selection.Checked ' Add the value of the item to the subtotal if the item is ' selected. If selection.Checked Then subtotal += Convert.ToDouble(item.Cells(2).Text.Substring(1)) End If End If Next ' Save the data source. Session("Source") = dt Return dt End Function ' This version of UpdateSource updates the data source only. Function UpdateSource() As DataTable ' Retrieve the data table from session state. Dim dt As DataTable = CType(Session("Source"), DataTable) Dim item As DataGridItem ' Iterate through the Items collection and update the data source ' with the user's selections. If an item is selected, add the ' amount of the item to the subtotal. For Each item in ItemsGrid.Items ' Retrieve the SelectCheckBox CheckBox control from the ' specified item (row) in the DataGrid control. Dim selection As CheckBox = _ CType(item.FindControl("SelectCheckBox"), CheckBox) If Not selection Is Nothing ' Update the BooleanValue field with the value of the check box. dt.Rows(item.ItemIndex)(3) = selection.Checked End If Next ' Save the data source. Session("Source") = dt Return dt End Function Sub Selection_Change(sender As Object, e As EventArgs) ' Set the image for the header section of the first column in ' the DataGrid control. ItemsGrid.Columns(0).HeaderImageUrl = List.SelectedItem.Value ' Create a DataView and bind it to the DataGrid control. This ' will refresh the DataGrid control with the updated header image. Dim dv As DataView = New DataView(UpdateSource()) ItemsGrid.DataSource = dv ItemsGrid.DataBind() End Sub </script> <body> <form runat=server> <h3>DataGridColumn HeaderImageUrl Example</h3> Select an image for the header section of the first column. <br><br> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue" HeaderImageUrl="image1.jpg"/> <asp:BoundColumn DataField="StringValue" HeaderImageUrl="image2.jpg"/> <asp:BoundColumn DataField="CurrencyValue" DataFormatString="{0:c}" HeaderImageUrl="image3.jpg"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> <asp:TemplateColumn HeaderImageUrl="image4.jpg"> <ItemTemplate> <asp:CheckBox id="SelectCheckBox" Text="Add to Cart" Checked='<%# DataBinder.Eval(Container.DataItem, "BooleanValue") %>' runat="server"/> </ItemTemplate> </asp:TemplateColumn> </Columns> </asp:DataGrid> <br><br> <asp:Button id="SubmitButton" Text="Submit" OnClick = "Button_Click" runat="server"/> <hr> Header image for first column: <br> <asp:DropDownList id="List" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"> <asp:ListItem Selected="True" Value="image1.jpg"> Image 1 </asp:ListItem> <asp:ListItem Value="image2.jpg"> Image 2 </asp:ListItem> <asp:ListItem Value="image3.jpg"> Image 3 </asp:ListItem> <asp:ListItem Value="image4.jpg"> Image 4 </asp:ListItem> </asp:DropDownList> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <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))); dt.Columns.Add(new DataColumn("BooleanValue", typeof(bool))); // Populate the table with sample values. for (int i = 0; i < 5; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = 1.23 * (i + 1); dr[3] = false; dt.Rows.Add(dr); } // To persist the data source between posts to the server, store // it in session state. Session["Source"] = dt; 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) { // Make sure to set the header text before binding the data to // the DataGrid control; otherwise, the change will not appear // until the next time the page is refreshed. ItemsGrid.Columns[0].HeaderText = "Item"; ItemsGrid.DataSource = CreateDataSource(); ItemsGrid.DataBind(); } } void Button_Click(Object sender, EventArgs e) { double subtotal = 0.0; // Update the data source with the user's selection and // calculate the subtotal. DataTable dt = UpdateSource(ref subtotal); // Display the subtotal in the footer section of the third column. ItemsGrid.Columns[2].FooterText = "Subtotal: " + subtotal.ToString("c"); // Create a DataView and bind it to the DataGrid control. DataView dv = new DataView(dt); ItemsGrid.DataSource = dv; ItemsGrid.DataBind(); } // This version of UpdateSource updates the data source and // calculates the subtotal. DataTable UpdateSource(ref double subtotal) { // Retrieve the data table from session state. DataTable dt = (DataTable)Session["Source"]; // Iterate through the Items collection and update the data source // with the user's selections. If an item is selected, add the // amount of the item to the subtotal. foreach (DataGridItem item in ItemsGrid.Items) { // Retrieve the SelectCheckBox CheckBox control from the // specified item (row) in the DataGrid control. CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox"); if (selection != null) { // Update the BooleanValue field with the value of the check box. dt.Rows[item.ItemIndex][3] = selection.Checked; // Add the value of the item to the subtotal if the item is // selected. if (selection.Checked) { subtotal += Convert.ToDouble(item.Cells[2].Text.Substring(1)); } } } // Save the data source. Session["Source"] = dt; return dt; } // This version of UpdateSource updates the data source only. DataTable UpdateSource() { // Retrieve the data table from session state. DataTable dt = (DataTable)Session["Source"]; // Iterate through the Items collection and update the data source // with the user's selections. If an item is selected, add the // amount of the item to the subtotal. foreach (DataGridItem item in ItemsGrid.Items) { // Retrieve the SelectCheckBox CheckBox control from the // specified item (row) in the DataGrid control. CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox"); if (selection != null) { // Update the BooleanValue field with the value of the check box. dt.Rows[item.ItemIndex][3] = selection.Checked; } } // Save the data source. Session["Source"] = dt; return dt; } void Selection_Change(Object sender, EventArgs e) { // Set the image for the header section of the first column in // the DataGrid control. ItemsGrid.Columns[0].HeaderImageUrl = List.SelectedItem.Value; // Create a DataView and bind it to the DataGrid control. This // will refresh the DataGrid control with the updated header image. DataView dv = new DataView(UpdateSource()); ItemsGrid.DataSource = dv; ItemsGrid.DataBind(); } </script> <body> <form runat=server> <h3>DataGridColumn HeaderImageUrl Example</h3> Select an image for the header section of the first column. <br><br> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue" HeaderImageUrl="image1.jpg"/> <asp:BoundColumn DataField="StringValue" HeaderImageUrl="image2.jpg"/> <asp:BoundColumn DataField="CurrencyValue" DataFormatString="{0:c}" HeaderImageUrl="image3.jpg"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> <asp:TemplateColumn HeaderImageUrl="image4.jpg"> <ItemTemplate> <asp:CheckBox id="SelectCheckBox" Text="Add to Cart" Checked='<%# DataBinder.Eval(Container.DataItem, "BooleanValue") %>' runat="server"/> </ItemTemplate> </asp:TemplateColumn> </Columns> </asp:DataGrid> <br><br> <asp:Button id="SubmitButton" Text="Submit" OnClick = "Button_Click" runat="server"/> <hr> Header image for first column: <br> <asp:DropDownList id="List" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"> <asp:ListItem Selected="True" Value="image1.jpg"> Image 1 </asp:ListItem> <asp:ListItem Value="image2.jpg"> Image 2 </asp:ListItem> <asp:ListItem Value="image3.jpg"> Image 3 </asp:ListItem> <asp:ListItem Value="image4.jpg"> Image 4 </asp:ListItem> </asp:DropDownList> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
DataGridColumn Class | DataGridColumn Members | System.Web.UI.WebControls Namespace | String.Empty