TagPrefixAttribute クラス

カスタム コントロールを識別するために、Web ページで使用されるタグ プリフィックスを定義します。このクラスは継承できません。

この型のすべてのメンバの一覧については、TagPrefixAttribute メンバ を参照してください。

System.Object
   System.Attribute
      System.Web.UI.TagPrefixAttribute

<AttributeUsage(AttributeTargets.Assembly)>
NotInheritable Public Class TagPrefixAttribute   Inherits Attribute
[C#]
[AttributeUsage(AttributeTargets.Assembly)]
public sealed class TagPrefixAttribute : Attribute
[C++]
[AttributeUsage(AttributeTargets::Assembly)]
public __gc __sealed class TagPrefixAttribute : public Attribute
[JScript]
public
   AttributeUsage(AttributeTargets.Assembly)
class TagPrefixAttribute extends Attribute

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

TagPrefixAttribute は、カスタム コントロールのタグ プリフィックス エイリアスを指定するために必要なアセンブリ レベルの属性を定義します。この属性は、カスタム コントロールが使用される ASP.NET ページで Register ディレクティブを自動的に生成するために、Visual Studio などのツールで使用されます。

このディレクティブは名前空間にタグ プリフィックスを登録します。また、カスタム コントロール コードの実装が常駐するアセンブリを指定します。このディレクティブを適切に使用すると、Web ページのカスタム コントロールを宣言によって使用できます。

属性の使用方法の詳細については、「 属性を使用したメタデータの拡張 」を参照してください。

使用例

 

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

<assembly: TagPrefix("CustomControls", "custom")> _

Namespace CustomControls
   
   ' Simple custom control
   Public Class MyVB_Control 
   Inherits Control
      Private message As String = "Hello"
      
      Public  Property getMessage() As String
         Get
            Return message
         End Get
         Set (ByVal value As String)
            message = value
         End Set
      End Property
      
      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub Render(writer As HtmlTextWriter)
         writer.Write(("<span style='background-color:aqua; font:8pt tahoma, verdana;'> " + Me.getMessage + "<br>" + "VB version. The time on the server is " + System.DateTime.Now.ToLongTimeString() + "</span>"))
      End Sub 'Render
   End Class 'MyControl
End Namespace 'CustomControls 


[C#] 

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

[assembly:TagPrefix("CustomControls", "custom")]


namespace CustomControls
{

    // Simple custom control
    public class MyCS_Control : Control
      {
            private String message = "Hello";
            
            public virtual String Message
            {
                  get
                  {
                        return message;
                  }
                  set
                  {
                        message = value;
                  }
            }
            
            [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
            protected override void Render( HtmlTextWriter writer)
            {
            writer.Write("<span style='background-color:aqua; font:8pt tahoma, verdana;'> "
                        + this.Message + "<br>" + "C# version. The time on the server is " + System.DateTime.Now.ToLongTimeString()
                        + "</span>");
                  
            }
      
      }

}


[C++] 
#using <mscorlib.dll>
#using <System.Web.dll>
#using <System.dll>
using namespace System;
using namespace System::Web;
using namespace System::Web::UI;
using namespace System::Web::UI::WebControls;

[assembly:TagPrefixAttribute(S"CustomControls", S"custom")];
namespace CustomControls 
{
// Simple custom control
public __gc class MyCS_Control : public Control 
{
private:
   String*  message;

public:

   MyCS_Control()
   {
      message = S"Hello";
   }

   __property virtual String * get_Message() 
   {
      return message;
   }

   __property virtual void set_Message(String * value) 
   {
      message = value;      
   }

protected:
   [System::Security::Permissions::PermissionSet(System::Security::Permissions::SecurityAction::Demand, Name="FullTrust")] 
   void Render(HtmlTextWriter* writer) 
   {
      writer->Write(S"<span style='background-color:aqua; font:8pt tahoma, verdana;'> {0} <br>C# version. The time on the server is {1}</span>", this->Message, DateTime::Now.ToLongTimeString());
   }
};
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Web.UI

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Web (System.Web.dll 内)

参照

TagPrefixAttribute メンバ | System.Web.UI 名前空間 | @ Register | カスタム サーバー コントロール構文 | Attribute