ToolboxDataAttribute クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ToolboxDataAttribute クラス

Microsoft Visual Studio などのツールでツールボックスからドラッグされるときに、カスタムコントロールに生成される既定のタグを指定します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class
 ToolboxDataAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As ToolboxDataAttribute

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class ToolboxDataAttribute :
 Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class ToolboxDataAttribute sealed
 : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class ToolboxDataAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class) 
public final class ToolboxDataAttribute extends
 Attribute

解説

既定では、Visual Studio などのツールのビジュアルデザイナで、空のタグが作成されます。このタグは、コントロールをビジュアルデザイナのツールボックスからデザインサーフェイスにドロップするときの、既定の状態のコントロールを表すタグです。初期既定値を指定する場合、コントロールはこの属性を利用できます。この属性を使用すると、コントロールがツールボックスからフォームにドラッグされるときにデザイナに配置される初期の HTML の内容をカスタマイズできます。

Topic	Location
チュートリアル : カスタムサーバーコントロールの開発と使用	ASP.NET コントロールの作成

使用例

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

上記のコードによって MyLabel に固有のプロパティをいくつか設定する例を次に示します。すべての {0} が、デザイナによって、MyLabel クラスに関連付けられているタグプリフィックスに置換されます。

Visual Basic

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