WebControl.BorderWidth Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает ширину границы серверного веб-элемента управления.
public:
virtual property System::Web::UI::WebControls::Unit BorderWidth { System::Web::UI::WebControls::Unit get(); void set(System::Web::UI::WebControls::Unit value); };
[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.Unit BorderWidth { get; set; }
public virtual System.Web.UI.WebControls.Unit BorderWidth { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.BorderWidth : System.Web.UI.WebControls.Unit with get, set
member this.BorderWidth : System.Web.UI.WebControls.Unit with get, set
Public Overridable Property BorderWidth As Unit
Значение свойства
Объект Unit, представляющий ширину границы серверного веб-элемента управления. Значение по умолчанию равно Empty и показывает, что значение свойства не задано.
- Атрибуты
Исключения
Указанная ширина границы является отрицательной величиной.
Примеры
В следующем примере показано, как задать BorderWidth свойство Table элемента управления, наследуемое WebControl от базового класса.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Table Property</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Property of a Table Web Control</h3>
<asp:Table id="Table1" runat="server"
CellPadding = "10"
CellSpacing="0"
GridLines="Both"
BorderColor="Red"
BorderWidth="3">
<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>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Table Property</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Property of a Table Web Control</h3>
<asp:Table id="Table1" runat="server"
CellPadding = "10"
CellSpacing="0"
GridLines="Both"
BorderColor="Red"
BorderWidth="3">
<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>
</div>
</form>
</body>
</html>
Примечание
В следующем примере кода используется однофайловая модель кода, и при копировании непосредственно в файл кода программной части может работать неправильно. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением .aspx. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода веб-форм ASP.NET.
<!-- 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. -->
<!-- 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" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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)
{
// <Snippet4>
// 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);
// </Snippet4>
// 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)
{
// <Snippet5>
// 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);
// </Snippet5>
}
// This method handles the selectedIndexChanged event for boderStyleList.
public void ChangeBorderStyle(object sender, System.EventArgs e)
{
// <Snippet6>
// 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);
// </Snippet6>
}
// This method handles the SelectedIndexChanged event for borderWidthList.
public void ChangeBorderWidth(object sender, System.EventArgs e)
{
// <Snippet7>
// 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);
// </Snippet7>
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> Border Properties Example </title>
</head>
<body>
<form id="form1" 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>
<%@ Page language="VB" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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
'<Snippet4>
' 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)
'</Snippet4>
' 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)
'<Snippet5>
' 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)
'</Snippet5>
End Sub
' This method handles the selectedIndexChanged event for boderStyleList.
Public Sub ChangeBorderStyle(sender As Object, e As System.EventArgs)
'<Snippet6>
' 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)
'</Snippet6>
End Sub
' This method handles the SelectedIndexChanged event for borderWidthList.
Public Sub ChangeBorderWidth(sender As Object, e As System.EventArgs)
'<Snippet7>
' 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)
'</Snippet7>
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> Border Properties Example </title>
</head>
<body>
<form id="form1" 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>
Комментарии
Используйте свойство , BorderWidth чтобы указать ширину границы для элемента управления .
Примечание
Это свойство не работает со всеми элементами управления веб-сервера. Он применяется только к элементам управления, отображаемым в виде таблицы, таким как Table и DataGrid.
Это свойство задается с помощью Unit объекта . Value Если свойство Unit объекта содержит отрицательное число, создается исключение.
Примечание
Ширина границы может быть выражена только в пикселях для браузеров, предшествующих Microsoft Internet Explorer версии 5. Все типы единиц поддерживаются в Microsoft Internet Explorer версии 5 и более поздних. Дополнительные сведения см. в конкретном элементе управления.