Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

WebControl.BorderColor Property

Gets or sets the border color of the Web control.

[Visual Basic]
Public Overridable Property BorderColor As Color
[C#]
public virtual Color BorderColor {get; set;}
[C++]
public: __property virtual Color get_BorderColor();
public: __property virtual void set_BorderColor(Color);
[JScript]
public function get BorderColor() : Color;
public function set BorderColor(Color);

Property Value

A System.Drawing.Color that represents the border color of the control. The default is Color.Empty, which indicates that this property is not set.

Remarks

Use the BorderColor property to specify the border color of the Web Server control. This property is set using a System.Drawing.Color object.

Note   This property will render only for certain controls. For example, Table, Panel, DataGrid, Calendar, and ValidationSummary will render this property. It will also work for CheckBoxList, RadioButtonList and DataList if their RepeatLayout property is set to RepeatLayout.Table, not RepeatLayout.Flow. However, it is rendered as the bordercolor attribute, which is not part of the HTML 3.2 standard. This attribute works for Microsoft Internet Explorer version 3 and later, but not most other browsers.

Example

[Visual Basic, C#, JScript] The following example illustrates how to set the BorderColor property of the Table control, which is inherited from the WebControl base class.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderColor="Brown"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>
 

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderColor="Brown"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>
 

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderColor="Brown"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>
 

[Visual Basic] 
<!-- This example demonstrates how to set property values for the
BorderColor, BorderStyle, and BorderWidth properties, and how to 
change the property values at run time. -->

    . . . 
<%@ Page language="VB" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>

<HTML>
    <HEAD>
        <SCRIPT runat="server">
            Private Sub Page_Load(sender As Object, e As System.EventArgs)
                ' Determine whether this is the first time the page is loaded;
                ' if so, load the drop-down lists with data.
                If Not Page.IsPostBack Then
                    ' Create a ListItemCollection and add names of colors.
                    Dim colors As New ListItemCollection()
                    colors.Add(Color.Black.Name)
                    colors.Add(Color.Blue.Name)
                    colors.Add(Color.Green.Name)
                    colors.Add(Color.Orange.Name)
                    colors.Add(Color.Purple.Name)
                    colors.Add(Color.Red.Name)
                    colors.Add(Color.White.Name)
                    colors.Add(Color.Yellow.Name)
                    ' Bind the colors collection to the borderColorList.
                    borderColorList.DataSource = colors
                    borderColorList.DataBind()

                    ' Create a ListItemCollection and the add names of 
                    ' the BorderStyle enumeration values.
                    Dim styles As New ListItemCollection()
                    Dim styleType As Type = GetType(BorderStyle)

                    Dim s As String
                    For Each s In  [Enum].GetNames(styleType)
                        styles.Add(s)
                    Next s

                    ' Bind the styles collection to the borderStyleList.
                    borderStyleList.DataSource = styles
                    borderStyleList.DataBind()

                    ' Create a ListItemCollection and add width values
                    ' expressed in pixels (px).
                    Dim widths As New ListItemCollection()

                    Dim i As Integer
                    For i = 0 To 10
                        widths.Add(i.ToString() & "px")
                    Next i

                    ' Bind the widths collection to the borderWidthList.
                    borderWidthList.DataSource = widths
                    borderWidthList.DataBind()
                End If
            End Sub

            ' This method handles the SelectedIndexChanged event for borderColorList.
            Public Sub ChangeBorderColor(sender As Object, e As System.EventArgs)
                ' Convert the color name string to an object of type Color, 
                ' and set the Color as the new border color for Label1.
                Label1.BorderColor = Color.FromName(borderColorList.SelectedItem.Text)
            End Sub

            ' This method handles the selectedIndexChanged event for boderStyleList.
            Public Sub ChangeBorderStyle(sender As Object, e As System.EventArgs)
                ' Convert the style name string to a BorderStyle enumeration value,
                ' and set the BorderStyle as the new border style for Label1.
                Dim styleType As Type = GetType(BorderStyle)
                Label1.BorderStyle = [Enum].Parse(styleType, borderStyleList.SelectedItem.Text)
            End Sub

            ' This method handles the SelectedIndexChanged event for borderWidthList.
            Public Sub ChangeBorderWidth(sender As Object, e As System.EventArgs)
                ' Convert the border width string to a object of type Unit,
                ' and set the Unit as the new border width for Label1.
                Label1.BorderWidth = Unit.Parse(borderWidthList.SelectedItem.Text)
            End Sub
    </SCRIPT>
    </HEAD>

    <BODY>
        <form runat="server">

            <h3> Border Properties Example </h3>

            <table border="0" cellpadding="6">
                <tr>
                    <td>
                        <asp:Label Runat="server" BorderColor="Black" 
                            BorderStyle="Solid" BorderWidth="4px" ID="Label1" 
                            Text="Border Properties Example" Height="75" 
                            Width="200"><center><br>Border Properties Example
                            </center></asp:Label>
                    </td>

                    <td>
                        <asp:DropDownList Runat="server" ID="borderColorList" 
                            OnSelectedIndexChanged="ChangeBorderColor" AutoPostBack="True" 
                            EnableViewState="True"></asp:DropDownList>
                        <br>
                        <br>
                        <asp:DropDownList Runat="server" ID="borderStyleList" 
                            OnSelectedIndexChanged="ChangeBorderStyle" AutoPostBack="True" 
                            EnableViewState="True"></asp:DropDownList>
                        <br>            
                        <br>
                        <asp:DropDownList Runat="server" ID="borderWidthList" 
                            OnSelectedIndexChanged="ChangeBorderWidth" AutoPostBack="True"
                            EnableViewState="True"></asp:DropDownList>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</HTML>

[C#] 
<!-- This example demonstrates how to set property values for the
BorderColor, BorderStyle, and BorderWidth properties, and how to 
change the property values at run time. -->

    . . . 
<%@ Page language="c#" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>

<HTML>
    <HEAD>
        <SCRIPT runat="server">
            private void Page_Load(object sender, System.EventArgs e)
            {
                // Determine whether this is the first time the page is loaded;
                // if so, load the drop-down lists with data.
                if (!Page.IsPostBack)
                {
                    // Create a ListItemCollection and add names of colors.
                    ListItemCollection colors = new ListItemCollection();
                    colors.Add(Color.Black.Name);
                    colors.Add(Color.Blue.Name);
                    colors.Add(Color.Green.Name);
                    colors.Add(Color.Orange.Name);
                    colors.Add(Color.Purple.Name);
                    colors.Add(Color.Red.Name);
                    colors.Add(Color.White.Name);
                    colors.Add(Color.Yellow.Name);
                    // Bind the colors collection to the borderColorList.
                    borderColorList.DataSource = colors;
                    borderColorList.DataBind();

                    // Create a ListItemCollection and the add names of 
                    // the BorderStyle enumeration values.
                    ListItemCollection styles = new ListItemCollection();

                    foreach (string s in Enum.GetNames(typeof(BorderStyle)))
                    {
                        styles.Add(s);
                    }

                    // Bind the styles collection to the borderStyleList.
                    borderStyleList.DataSource = styles;
                    borderStyleList.DataBind();

                    // Create a ListItemCollection and add width values
                    // expressed in pixels (px).
                    ListItemCollection widths = new ListItemCollection();

                    for (int i = 0; i < 11; i++)
                    {
                        widths.Add(i.ToString() + "px");
                    }

                    // Bind the widths collection to the borderWidthList.
                    borderWidthList.DataSource = widths;
                    borderWidthList.DataBind();
                }

            }

            // This method handles the SelectedIndexChanged event for borderColorList.
            public void ChangeBorderColor(object sender, System.EventArgs e)
            {
                // Convert the color name string to an object of type Color, 
                // and set the Color as the new border color for Label1.
                Label1.BorderColor = Color.FromName(borderColorList.SelectedItem.Text);
            }

            // This method handles the selectedIndexChanged event for boderStyleList.
            public void ChangeBorderStyle(object sender, System.EventArgs e)
            {
                // Convert the style name string to a BorderStyle enumeration value,
                // and set the BorderStyle as the new border style for Label1.
                Label1.BorderStyle = (BorderStyle)Enum.Parse(typeof(BorderStyle),
                                      borderStyleList.SelectedItem.Text);
            }

            // This method handles the SelectedIndexChanged event for borderWidthList.
            public void ChangeBorderWidth(object sender, System.EventArgs e)
            {
                // Convert the border width string to a object of type Unit,
                // and set the Unit as the new border width for Label1.
                Label1.BorderWidth = Unit.Parse(borderWidthList.SelectedItem.Text);
            }
    </SCRIPT>
    </HEAD>

    <BODY>
        <form runat="server">

            <h3> Border Properties Example </h3>

            <table border="0" cellpadding="6">
                <tr>
                    <td>
                        <asp:Label Runat="server" BorderColor="Black" 
                            BorderStyle="Solid" BorderWidth="4px" ID="Label1" 
                            Text="Border Properties Example" Height="75" 
                            Width="200"><center><br>Border Properties Example
                            </center></asp:Label>
                    </td>

                    <td>
                        <asp:DropDownList Runat="server" ID="borderColorList" 
                            OnSelectedIndexChanged="ChangeBorderColor" AutoPostBack="True" 
                            EnableViewState="True"></asp:DropDownList>
                        <br>
                        <br>
                        <asp:DropDownList Runat="server" ID="borderStyleList" 
                            OnSelectedIndexChanged="ChangeBorderStyle" AutoPostBack="True" 
                            EnableViewState="True"></asp:DropDownList>
                        <br>            
                        <br>
                        <asp:DropDownList Runat="server" ID="borderWidthList" 
                            OnSelectedIndexChanged="ChangeBorderWidth" AutoPostBack="True"
                            EnableViewState="True"></asp:DropDownList>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</HTML>

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

WebControl Class | WebControl Members | System.Web.UI.WebControls Namespace | System.Drawing.Color | Style | Table | Panel | DataGrid | Calendar | ValidationSummary | CheckBoxList | RadioButtonList | DataList | RepeatLayout

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.