HtmlTextWriter.TagKey プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したマークアップ要素の 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, setProtected Property TagKey As HtmlTextWriterTagプロパティ値
開始タグがレンダリングされているマークアップ要素。
例外
プロパティ値を設定できません。
例
次のコード例は、HtmlTextWriter クラスから派生するクラス内のRenderBeforeContent メソッドのオーバーライドされたバージョンを示しています。
TagKey プロパティの値を使用して、カスタム HtmlTextWriter オブジェクトを使用するサーバー コントロールが<label>マークアップ要素をレンダリングしているかどうかを判断します。 その場合は、color属性が red に設定された<font>要素が返され、<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 メソッドの呼び出しでのみ読み取りまたは設定する必要があります。これは、一貫性のある値に設定される唯一の時間です。
