HtmlTextWriter.TagKey Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Pobiera lub ustawia HtmlTextWriterTag wartość dla określonego elementu znaczników.

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

Wartość właściwości

HtmlTextWriterTag

Element znaczników, który ma renderowany tag otwierający.

Wyjątki

ArgumentOutOfRangeException

Nie można ustawić wartości właściwości.

Przykłady

Poniższy przykład kodu przedstawia przesłoniętą wersję RenderBeforeContent metody w klasie pochodzącej HtmlTextWriter z klasy. Używa wartości TagKey właściwości w celu określenia, czy kontrolka serwera przy użyciu obiektu niestandardowego HtmlTextWriter renderuje <label> element znaczników. Jeśli tak jest, <font> element z ustawionym red atrybutem color jest zwracany w celu zmodyfikowania formatowania <label> tekstu elementu.

// 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

Uwagi

Właściwość TagKey jest używana tylko do klas dziedzicujących po HtmlTextWriter klasie. Należy odczytać lub ustawić TagKey właściwość tylko w wywołaniu RenderBeginTag metody . Jest to jedyny czas, w którym jest ustawiona wartość spójna.

Dotyczy

Zobacz też