WebControl.BorderWidth-Eigenschaft

Artikel
08/20/2007

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property BorderWidth As Unit
'Usage
Dim instance As WebControl
Dim value As Unit

value = instance.BorderWidth

instance.BorderWidth = value

public virtual Unit BorderWidth { get; set; }

public:
virtual property Unit BorderWidth {
    Unit get ();
    void set (Unit value);
}

/** @property */
public Unit get_BorderWidth ()

/** @property */
public void set_BorderWidth (Unit value)

public function get BorderWidth () : Unit

public function set BorderWidth (value : Unit)

Eigenschaftenwert

Eine Unit, die die Rahmenbreite eines Webserversteuerelements darstellt. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die angegebene Rahmenbreite ist ein negativer Wert.

Hinweise

Mit der BorderWidth-Eigenschaft geben Sie die Rahmenbreite für ein Steuerelement an.

Hinweis

Diese Eigenschaft wird nicht bei allen Webserversteuerelementen unterstützt. Sie kann nur bei als Tabelle angezeigten Steuerelementen angewendet werden, z. B. Table und DataGrid.

Diese Eigenschaft wird mit einem Unit-Objekt festgelegt. Wenn die Value-Eigenschaft der Unit eine negative Zahl enthält, wird eine Ausnahme ausgelöst.

Hinweis

In älteren Browsern als Microsoft Internet Explorer, Version 5, kann die Rahmenbreite nur in Pixel angegeben werden. Ab Microsoft Internet Explorer, Version 5, werden alle Arten von Einheiten unterstützt. Weitere Einzelheiten finden Sie unter den Ausführungen zum entsprechenden Steuerelement.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die BorderWidth-Eigenschaft des von der WebControl-Basisklasse geerbten Table-Steuerelements festgelegt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderWidth Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderWidth=10
 >
 
    <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>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderWidth Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderWidth=10
 >
 
    <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>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BorderWidth Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    
    BorderWidth=10
 >
 
    <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>

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
Unit-Struktur
Style-Klasse

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über

WebControl.BorderWidth-Eigenschaft

Syntax

Eigenschaftenwert

Ausnahmen

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen