HtmlTextWriter.TagKey プロパティ

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

指定したマークアップ要素の HtmlTextWriterTag 値を取得または設定します。

protected:
 property System::Web::UI::HtmlTextWriterTag TagKey { System::Web::UI::HtmlTextWriterTag get(); void set(System::Web::UI::HtmlTextWriterTag value); };

protected System.Web.UI.HtmlTextWriterTag TagKey { get; set; }

member this.TagKey : System.Web.UI.HtmlTextWriterTag with get, set

Protected Property TagKey As HtmlTextWriterTag

プロパティ値

HtmlTextWriterTag

開始タグが出力されるマークアップ要素。

例外

ArgumentOutOfRangeException

プロパティ値が設定できません。

例

次のコード例は、 クラスから派生する RenderBeforeContent クラス内のメソッドのオーバーライドされたバージョンを HtmlTextWriter 示しています。 プロパティの値を TagKey 使用して、カスタム HtmlTextWriter オブジェクトを使用するサーバー コントロールがマークアップ要素を <label> レンダリングしているかどうかを判断します。 その場合、属性が <font> にred設定された要素colorが返され、要素のテキストの書式設定が<label>変更されます。

// Override the RenderBeforeContent method to write
// a font element that applies red to the text in a Label element.

virtual String^ RenderBeforeContent() override
{
   
   // Check to determine whether the element being rendered
   // is a label element. If so, render the opening tag
   // of the font element; otherwise, call the base method.
   if ( TagKey == HtmlTextWriterTag::Label )
   {
      return "<font color=\"red\">";
   }
   else
   {
      return __super::RenderBeforeContent();
   }
}

// Override the RenderBeforeContent method to write
// a font element that applies red to the text in a Label element.
protected override string RenderBeforeContent()
{
    // Check to determine whether the element being rendered
    // is a label element. If so, render the opening tag
    // of the font element; otherwise, call the base method.
    if (TagKey == HtmlTextWriterTag.Label)
    {
        return "<font color=\"red\">";
    }
    else
    {
        return base.RenderBeforeContent();
    }
}

' Override the RenderBeforeContent method to write
' a font element that applies red to the text in a Label element.
Protected Overrides Function RenderBeforeContent() As String
    ' Check to determine whether the element being rendered
    ' is a label element. If so, render the opening tag
    ' of the font element; otherwise, call the base method.
    If TagKey = HtmlTextWriterTag.Label Then
        Return "<font color=""red"">"
    Else
        Return MyBase.RenderBeforeContent()
    End If
End Function 'RenderBeforeContent

注釈

プロパティは TagKey 、 クラスから継承するクラスにのみ使用されます HtmlTextWriter 。 プロパティは TagKey 、 メソッドの呼び出しでのみ読み取りまたは設定する RenderBeginTag 必要があります。これは、一貫性のある値に設定されている唯一の時間です。

こちらもご覧ください

• TextWriter
• HtmlTextWriterTag
• RenderBeginTag
• TagName