ListControlDataBindingHandler Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt die Datenbindung eines ListControl-Webserversteuerelements in einem visuellen Designer aus.
public ref class ListControlDataBindingHandler : System::Web::UI::Design::DataBindingHandler
public class ListControlDataBindingHandler : System.Web.UI.Design.DataBindingHandler
type ListControlDataBindingHandler = class
inherit DataBindingHandler
Public Class ListControlDataBindingHandler
Inherits DataBindingHandler
- Vererbung
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie sie ein Steuerelement vom RadioButtonList Steuerelement ableiten und es seinem Datenbindungshandler zuordnen. Die zweite veranschaulicht, wie eine Klasse von der ListControlDataBindingHandler -Klasse abgeleitet wird.
Im folgenden Codebeispiel wird gezeigt, wie das SimpleRadioButtonList
Steuerelement vom RadioButtonList Steuerelement abgeleitet und dann das DataBindingHandlerAttribute -Attribut angewendet wird, um das SimpleRadioButtonList
Steuerelement seinem Datenbindungshandler, der SimpleRadioButtonListDataBindingHandler
-Klasse, zuzuordnen.
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The SimpleRadioButtonList is a copy of the RadioButtonList.
// It uses the SimpleRadioButtonListDesigner for design-time support.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
SimpleRadioButtonListDesigner))]
[DataBindingHandler(typeof(Examples.CS.WebControls.Design.
SimpleRadioButtonListDataBindingHandler))]
public class SimpleRadioButtonList : RadioButtonList
{
} // SimpleRadioButtonList
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The SimpleRadioButtonList is a copy of the RadioButtonList.
' It uses the SimpleRadioButtonListDesigner for design-time support.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<DesignerAttribute(GetType(Examples.VB.WebControls.Design. _
SimpleRadioButtonListDesigner))> _
<DataBindingHandler(GetType(Examples.VB.WebControls.Design. _
SimpleRadioButtonListDataBindingHandler))> _
Public Class SimpleRadioButtonList
Inherits RadioButtonList
End Class
End Namespace ' Examples.VB.WebControls.Design
Im folgenden Codebeispiel wird gezeigt, wie die SimpleRadioButtonListDataBindingHandler
-Klasse von der ListControlDataBindingHandler -Klasse abgeleitet wird. Es überschreibt die DataBindControl -Methode, um dem zugeordneten SimpleRadioButtonList
Steuerelement eine Nachricht hinzuzufügen, wenn dieses Steuerelement datengebunden ist.
using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Web.UI;
using System.Web.UI.Design.WebControls;
namespace Examples.CS.WebControls.Design
{
// Derive the SimpleRadioButtonListDataBindingHandler.
public class SimpleRadioButtonListDataBindingHandler :
ListControlDataBindingHandler
{
// Override the DataBindControl.
public override void DataBindControl(IDesignerHost designerHost,
Control control)
{
// Create a reference, named dataSourceBinding,
// to the control DataSource binding.
DataBinding dataSourceBinding =
((IDataBindingsAccessor)control).DataBindings["DataSource"];
// If the binding exists, create a reference to the
// list control, clear its ListItemCollection, and then add
// an item to the collection.
if (! (dataSourceBinding == null))
{
SimpleRadioButtonList simpleControl =
(SimpleRadioButtonList)control;
simpleControl.Items.Clear();
simpleControl.Items.Add("Data-bound Radio Button.");
}
} // DataBindControl
} // SimpleRadioButtonListDataBindingHandler
} // Examples.CS.WebControls.Design
' Imports System.Design
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Web.UI
Imports System.Web.UI.Design.WebControls
Namespace Examples.VB.WebControls.Design
' Derive the SimpleRadioButtonListDataBindingHandler.
Public Class SimpleRadioButtonListDataBindingHandler
Inherits ListControlDataBindingHandler
' Override the DataBindControl.
Public Overrides Sub DataBindControl( _
ByVal designerHost As IDesignerHost, _
ByVal control As Control)
' Create a reference, named dataSourceBinding,
' to the control's DataSource binding.
Dim dataSourceBinding As DataBinding _
= CType( _
control, _
IDataBindingsAccessor).DataBindings("DataSource")
' If the binding exists, create a reference to the
' list control, clear its ListItemCollection, and then add
' an item to the collection.
If Not (dataSourceBinding Is Nothing) Then
Dim simpleControl As SimpleRadioButtonList = _
CType(control, SimpleRadioButtonList)
simpleControl.Items.Clear()
simpleControl.Items.Add("Data-bound Radio Button.")
End If
End Sub
End Class
End Namespace ' Examples.VB.WebControls.Design
Hinweise
Die ListControlDataBindingHandler -Klasse führt die Entwurfszeit-Datenbindung eines ListControl Steuerelements aus. Auf ListControlDataBindingHandler die -Klasse wird mithilfe der ListControlDataBindingHandlerAttribute -Klasse verwiesen.
Die DataBindControl -Methode führt die Entwurfszeitdatenbindung aus.
Konstruktoren
ListControlDataBindingHandler() |
Initialisiert eine neue Instanz der ListControlDataBindingHandler-Klasse. |
Methoden
DataBindControl(IDesignerHost, Control) |
Führt eine Datenbindung für das angegebene Steuerelement durch. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Gilt für:
Weitere Informationen
- ListControl
- ListControlDesigner
- DataBindingHandler
- DataBindingHandlerAttribute
- Übersicht über ASP.NET-Steuerelement-Designer
- Exemplarische Vorgehensweise: Erstellen eines Einfachen Steuerelement-Designers für ein Webserversteuerelement
- Erweitern der Entwurfszeitunterstützung
- Gewusst wie: Erweitern der Darstellung und des Verhaltens von Steuerelementen im Entwurfsmodus