HtmlTextWriter.TagName プロパティ

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

HtmlTextWriter.TagName プロパティ

出力されるマークアップ要素のタグ名を取得または設定します。

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

Visual Basic (宣言)

Protected Property TagName As
 String

Visual Basic (使用法)

Dim value As String

value = Me.TagName

Me.TagName = value

C#

protected string TagName { get;
 set; }

C++

protected:
property String^ TagName {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
protected String get_TagName ()

/** @property */
protected void set_TagName (String value)

JScript

protected function get TagName
 () : String

protected function set TagName
 (value : String)

プロパティ値
出力されるマークアップ要素のタグ名。

解説

TagName プロパティは、HtmlTextWriter から継承するクラスにだけ使用されます。TagName プロパティの読み取り、または設定は、RenderBeginTag メソッドの呼び出しでのみ行うようにしてください。このプロパティには、このメソッドの呼び出しでのみ値が設定されます。

使用例

HtmlTextWriter クラスから派生したクラスのオーバーライドされたバージョンの RenderBeforeTag メソッドのコード例を次に示します。このコード例では、String.Compare メソッドを呼び出し、TagName プロパティ値と文字列 "label" をパラメータ引数として渡して、出力する要素が <label> 要素かどうかをチェックします。出力する要素が <label> の場合、<label> 要素の開始タグの前に、color 属性が red に設定された <font> 要素の開始タグを出力します。出力する要素が <label> ではない場合、基本クラスのバージョンの RenderBeforeTag メソッドが呼び出されます。

Visual Basic

' Override the RenderBeforeTag method to add the 
' opening tag of a Font element before the 
' opening tag of any Label elements rendered by this 
' custom markup writer. 
Protected Overrides Function
 RenderBeforeTag() As String
    ' Compare the TagName property value to the
    ' string label to determine whether the element to 
    ' be rendered is a Label. If it is a Label,
    ' the opening tag of the Font element, with a Color
    ' style attribute set to red, is added before
    ' the Label.
    If String.Compare(TagName, "label")
 = 0 Then
        Return "<font color=""red"">"
        ' If a Label is not being rendered, use 
        ' the base RenderBeforeTag method.
    Else
        Return MyBase.RenderBeforeTag()
    End If
End Function 'RenderBeforeTag

C#

// Override the RenderBeforeTag method to add the 
// opening tag of a Font element before the 
// opening tag of any Label elements rendered by this 
// custom markup writer. 
protected override string RenderBeforeTag()
{
    // Compare the TagName property value to the
    // string label to determine whether the element to 
    // be rendered is a Label. If it is a Label,
    // the opening tag of the Font element, with a Color
    // style attribute set to red, is added before
    // the Label.
    if (String.Compare(TagName, "label") == 0)
    {
        return "<font color=\"red\">";
    }
    // If a Label is not being rendered, use 
        // the base RenderBeforeTag method.
    else
    {
        return base.RenderBeforeTag();
    }
}

C++

// Override the RenderBeforeTag method to add the
// opening tag of a Font element before the
// opening tag of any Label elements rendered by this
// custom markup writer.
virtual String^ RenderBeforeTag() override
{
   // Compare the TagName property value to the
   // String* label to determine whether the element to
   // be rendered is a Label. If it is a Label,
   // the opening tag of the Font element, with a Color
   // style attribute set to red, is added before
   // the Label.
   if ( String::Compare( TagName, "label" ) == 0 )
   {
      return "<font color=\"red\">";
   }
   // If a Label is not being rendered, use
   // the base RenderBeforeTag method.
   else
   {
      return __super::RenderBeforeTag();
   }
}

J#

// Override the RenderBeforeTag method to add the 
// opening tag of a Font element before the 
// opening tag of any Label elements rendered by this 
// custom markup writer. 
protected String RenderBeforeTag()
{
    // Compare the TagName property value to the
    // string label to determine whether the element to 
    // be rendered is a Label. If it is a Label,
    // the opening tag of the Font element, with a Color
    // style attribute set to red, is added before
    // the Label.
    if (String.Compare(get_TagName(), "label") == 0)
 {
        return "<font color=\"red\">";
    }
        // If a Label is not being rendered, use 
        // the base RenderBeforeTag method.
    else  {
        return super.RenderBeforeTag();
    }
} //RenderBeforeTag

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HtmlTextWriter クラス
HtmlTextWriter メンバ
System.Web.UI 名前空間
TextWriter
HtmlTextWriterTag
RenderBeginTag
HtmlTextWriter.TagKey プロパティ