Esporta (0) Stampa
Espandi tutto

Classe ControlBuilderAttribute

Specifica una classe ControlBuilder da utilizzare per la generazione di un controllo personalizzato all'interno del parser ASP.NET. La classe non può essere ereditata.

Spazio dei nomi: System.Web.UI
Assembly: System.Web (in system.web.dll)

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class ControlBuilderAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class ControlBuilderAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Class) 
public final class ControlBuilderAttribute extends Attribute

Questo attributo specifica l'oggetto Type del generatore da utilizzare per la creazione di un controllo personalizzato come illustrato nel seguente codice:

[ControlBuilderAttribute(typeof(ControlBuilderType))]

Nell'esempio di codice riportato di seguito viene creato un elenco di selezione personalizzato per visualizzare un messaggio in base ai valori SelectedIndex e Message definiti in fase di esecuzione. La riga di comando seguente viene utilizzata per generare il file eseguibile.

csc /t:library /out:myWebAppPath/Bin/cs_MyControlBuilderAtt.dll ControlBuilderAtt.cs

/* File name: controlBuilderAttribute.cs. */

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


namespace CustomControls

{
  public class MyCS_Item : Control 
  /* Class name: MyCS_Item. 
   * Defines the child control class.
   */
    {

      private String _message;

      public String Message 
      {
        get 
        {
          return _message;
        }
        set 
        {
           _message = value;
        }
     }
    }


    public class CustomParseControlBuilder : ControlBuilder 
    /* Class name: CustomParserControlBuilder.
     * Defines the functions and data to be used in building custom controls. 
     * This class is referenced using the ControlBuilderAttribute class. See class below.
     */
    {
      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      public override Type GetChildControlType(String tagName, IDictionary attributes) 
      {
        if (String.Compare(tagName, "customitem", true) == 0) 
        {
           return typeof(MyCS_Item);
        }
        return null;
      }
    }


    [ 
       ControlBuilderAttribute(typeof(CustomParseControlBuilder)) 
    ]
    public class MyCS_CustomParse : Control 
    /* Class name: MyCS_CustomParse.
     * Performs custom parsing of a MyCS_CustomParse control type 
     * child control. 
     * If the child control is of the allowed type, it is added to an 
     * array list. This list is accessed, using the container control attribute 
     * SelectedIndex, to obtain the related child control Message attribute to be displayed.
     */
    {

       private ArrayList _items         = new ArrayList();
       private int       _selectedIndex = 0;

       public int SelectedIndex 
       { 
           get 
           {
              return _selectedIndex;
           }
           set 
           {
              _selectedIndex = value;
           }
       }

       [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
       protected override void AddParsedSubObject(Object obj) 
       /* Function name: AddParsedSubObject.
        * Updates the array list with the allowed child objects.
        * This function is called during the parsing of the child controls and 
        * after the GetChildControlType function defined in the associated control 
        * builder class.
        */
       {
          if (obj is MyCS_Item) 
         {
              _items.Add(obj);
           }
       }

       [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
       protected override void Render(HtmlTextWriter output) 
       /* Function name: Render.
        * Establishes the rules to render the built control. In this case, a message is
        * rendered that is a function of the parent control SelectedIndex attribute and 
        * the related child Message attribute.
        */
       {
          if (SelectedIndex < _items.Count) 
         {
              output.Write("<span style='background-color:aqua; color:red; font:8pt tahoma, verdana;'><b>" +
              ((MyCS_Item) _items[SelectedIndex]).Message + "</b></span>" );
         }
       }
    }    
}


package CustomControls;

/* File name: controlBuilderAttribute.jsl. */
import System.*;
import System.Web.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;
import System.Collections.*;

public class MyJSL_Item extends Control
{
    /* Class name: MyJSL_Item. 
       Defines the child control class.
     */
    private String _message;
    /** @property 
     */
    public String get_Message()
    {
        return _message;
    } //get_Message

    /** @property 
     */
    public void set_Message(String value)
    {
        _message = value;
    } //set_Message
} //MyJSL_Item

public class CustomParseControlBuilder extends ControlBuilder
{
    /* Class name: CustomParserControlBuilder.
       Defines the functions and data to be used in building custom controls. 
       This class is referenced using the ControlBuilderAttribute class.
       See class below.
     */
    public Type GetChildControlType(String tagName, IDictionary attributes)
    {
        if (String.Compare(tagName, "customitem", true) == 0) {
            return MyJSL_Item.class.ToType();
        }
        return null;
    } //GetChildControlType
} //CustomParseControlBuilder

/** @attribute ControlBuilderAttribute(CustomParseControlBuilder.class)
 */
public class MyJSL_CustomParse extends Control
{
    /* Class name: MyJSL_CustomParse.
       Performs custom parsing of a MyJSL_CustomParse control type 
       child control. 
       If the child control is of the allowed type, it is added to an 
       array list. This list is accessed, using the container control attribute 
       SelectedIndex, to obtain the related child control Message attribute
       to be displayed.
     */
    private ArrayList _items = new ArrayList();
    private int _selectedIndex = 0;

    /** @property 
     */
    public int get_SelectedIndex()
    {
        return _selectedIndex;
    } //get_SelectedIndex

    /** @property 
     */
    public void set_SelectedIndex(int value)
    {
        _selectedIndex = value;
    } //set_SelectedIndex

    protected void AddParsedSubObject(Object obj)
    {
        /* Function name: AddParsedSubObject.
           Updates the array list with the allowed child objects.
           This function is called during the parsing of the child controls and 
           after the GetChildControlType function defined in the associated control 
           builder class.
        */
        if (obj instanceof MyJSL_Item) {
            _items.Add(obj);
        }
    } //AddParsedSubObject

    protected void Render(HtmlTextWriter output)
    {
        /* Function name: Render.
           Establishes the rules to render the built control. In this case,
           a message is rendered that is a function of the parent control
           SelectedIndex attribute and the related child Message attribute.
        */
        if (get_SelectedIndex() < _items.get_Count()) {
            output.Write("<span style='background-color:aqua; color:red;"
                + " font:8pt tahoma, verdana;'><b>"
                + ((MyJSL_Item)_items.get_Item(get_SelectedIndex())).get_Message()
                + "</b></span>");
        }
    } //Render
} //MyJSL_CustomParse

Nell'esempio seguente viene utilizzato il controllo personalizzato definito in precedenza. In particolare, vengono assegnati i valori SelectedIndex e Message in fase di esecuzione per determinare il messaggio da visualizzare. I valori riportati nella direttiva Register si basano sulla riga di comando precedente.

<%@ Register TagPrefix="custom" Assembly="myControlBuilderAtt" Namespace="CustomControls" %>
 <h4>Using ControlBuilderAttribute Class<h4>
 <form runat="server">
  <custom:MyCS_CustomParse SelectedIndex="2" runat=server>
  <customitem Message="C# version. Item One selected"/>
  <customitem Message="C# version. Item Two selected"/>
  <customitem Message="C# version. Item Three selected"/>
  <customitem Message="C# version. Item Four selected"/>
  </custom:MyCS_CustomParse>
 </form>

System.Object
   System.Attribute
    System.Web.UI.ControlBuilderAttribute

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

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 non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft