CheckBoxDesigner-Klasse

Artikel
08/20/2007

Erweitert das Entwurfszeitverhalten für das CheckBox-Webserversteuerelement.

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

Syntax

'Declaration
Public Class CheckBoxDesigner
    Inherits ControlDesigner
'Usage
Dim instance As CheckBoxDesigner

public class CheckBoxDesigner : ControlDesigner

public ref class CheckBoxDesigner : public ControlDesigner

public class CheckBoxDesigner extends ControlDesigner

public class CheckBoxDesigner extends ControlDesigner

Hinweise

Die CheckBoxDesigner-Klasse überschreibt die GetDesignTimeHtml-Methode der ControlDesigner-Klasse, um sicherzustellen, dass das Steuerelement zur Entwurfszeit aussagekräftig dargestellt wird. Wenn die Text-Eigenschaft leer ist, legt die GetDesignTimeHtml-Methode dieser Klasse die Text-Eigenschaft des Steuerelements auf die Control.ID-Eigenschaft des Steuerelements fest.

Beispiel

Im folgenden Codebeispiel wird eine benutzerdefinierte Designerklasse mit dem Namen SampleCheckBoxDesigner erstellt, die von der CheckBoxDesigner-Klasse erbt. Diese überschreibt die GetDesignTimeHtml-Methode. Wenn die CheckBox.Text-Eigenschaft zuvor nicht festgelegt wurde, wird diese Methode aufgerufen, um die Eigenschaft auf eine Zeichenfolge festzulegen und diese Zeichenfolge auf der Entwurfsoberfläche anzuzeigen. Wenn die Text-Eigenschaft festgelegt wurde, wird der vorhandene Eigenschaftenwert angezeigt.

Imports System
'Imports System.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
'Imports Examples.AspNet

Namespace Examples.AspNet '.Design

    ' Create a class, named SampleCheckBoxDesigner, that overrides the
    ' GetDesignTimeHtml method to display the control on the design
    ' surface.

    Public Class SampleCheckBoxDesigner
        Inherits System.Web.UI.Design.WebControls.CheckBoxDesigner

        ' Override the GetDesignTimeHtml method to display a border on the 
        ' control if the BorderStyle property has not been set by the user.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleCheckBox As SampleCheckBox = CType(Component, _
                SampleCheckBox)
            Dim designTimeHtml As String = Nothing

            ' Check the control's BorderStyle property.
            If (sampleCheckBox.BorderStyle = BorderStyle.NotSet) Then

                ' Save the current value of the BorderStyle property.
                Dim oldBorderStyle As BorderStyle = _
                    sampleCheckBox.BorderStyle

                ' Change the value of the BorderStyle property and 
                ' generate the design-time HTML.
                Try
                    sampleCheckBox.BorderStyle = BorderStyle.Groove
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' If an exception occurs, call the GetErrorDesignTimeHtml
                    ' method.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Restore the BorderStyle property to its original value.
                Finally
                    sampleCheckBox.BorderStyle = oldBorderStyle
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml
        End Function
    End Class
End Namespace

Im folgenden Codebeispiel wird eine einfache Klasse mit dem Namen SampleCheckBox veranschaulicht, die von der CheckBox-Klasse erbt und mithilfe der DesignerAttribute-Klasse der SampleCheckBoxDesigner-Klasse zugeordnet wird.

Namespace Examples.AspNet

    ' The SampleCheckBox class that uses the SampleCheckBoxDesigner class.
    <Designer(GetType( _
        Examples.AspNet.SampleCheckBoxDesigner))> _
    Public Class SampleCheckBox
        Inherits CheckBox
        ' To customize the CheckBox class, insert code here.
    End Class

End Namespace

Vererbungshierarchie

System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
       System.Web.UI.Design.ControlDesigner
        System.Web.UI.Design.WebControls.CheckBoxDesigner

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

CheckBoxDesigner-Member
System.Web.UI.Design.WebControls-Namespace

Weitere Ressourcen

Übersicht über ASP.NET-Steuerelement-Designer
Exemplarische Vorgehensweise: Erstellen eines einfachen Steuerelement-Designers für ein Webserver-Steuerelement

Freigeben über