Freigeben über


ToolboxDataAttribute-Klasse

Gibt das Standardtag an, das für ein benutzerdefiniertes Steuerelement generiert wird, wenn es in einem Tool wie Microsoft Visual Studio aus einer Toolbox gezogen wird.

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

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class ToolboxDataAttribute
    Inherits Attribute
'Usage
Dim instance As ToolboxDataAttribute
[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class ToolboxDataAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class ToolboxDataAttribute sealed : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class ToolboxDataAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Class) 
public final class ToolboxDataAttribute extends Attribute

Hinweise

In der Standardeinstellung erstellt der visuelle Designer eines Tools wie Visual Studio ein leeres Tag. Mit diesem Tag wird ein Steuerelement in seinem Standardzustand dargestellt, wenn das Steuerelement aus der Toolbox eines visuellen Designers auf die Entwurfsoberfläche gezogen wird. Für ein Steuerelement lassen sich mit diesem Attribut anfängliche Standardwerte angeben. Sie können mithilfe dieses Attributs den anfänglichen HTML-Inhalt anpassen, der im Designer platziert wird, wenn das Steuerelement aus der Toolbox in das Formular gezogen wird.

Thema Position
Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Serversteuerelements Entwickeln von ASP.NET-Steuerelementen
Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Serversteuerelements Erstellen von Anwendungen mit Visual Web Developer

Beispiel

[ ToolboxData("<{0}:MyLabel runat= server Text= 
       MyLabel><{0}:MyLabel>") ]public class MyLabel : Label {...}

Im folgenden Codebeispiel legt der vorherige Code mehrere Eigenschaften auf MyLabel fest. Alle Vorkommen von {0} werden vom Designer durch das mit der MyLabel-Klasse verknüpfte Tagpräfix ersetzt.

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls


Namespace CustomControls
  <ToolboxData("<{0}:MyLabel Text='MyLabel' BorderColor='Yellow' BackColor='Magenta' BorderWidth = '10'  runat='server'></{0}:MyLabel>")>  _
  Public Class MyLabel
    Inherits Label
     
    Public Sub New()
      'Your code goes here.
    End Sub 'New
    
  End Class 'MyLabel
  
End Namespace 'CustomControls

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;


namespace CustomControls
{

  [ ToolboxData("<{0}:MyLabel Text='MyLabel' BorderColor='Yellow' BackColor='Magenta' BorderWidth = '10'  runat='server'></{0}:MyLabel>") ] 
  public class MyLabel : Label 
  {
    public  MyLabel()
    { 
      // Your code goes here.
    } 
  }

}
import System.*;
import System.Web.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;

/** @attribute ToolboxData("<{0}:MyLabel Text='MyLabel' BorderColor='Yellow'"
    + "BackColor='Magenta' BorderWidth = '10'  runat='server'></{0}:MyLabel>")
 */
public class MyLabel extends Label
{
    public MyLabel()
    {
        // Your code goes here.
    } //MyLabel
} //MyLabel

Vererbungshierarchie

System.Object
   System.Attribute
    System.Web.UI.ToolboxDataAttribute

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

ToolboxDataAttribute-Member
System.Web.UI-Namespace
Attribute

Weitere Ressourcen

Erweitern von Metadaten mithilfe von Attributen