HtmlAnchor.RenderAttributes(HtmlTextWriter) Metodo

Definizione

Esegue il rendering degli attributi del controllo HtmlAnchor nell'oggetto HtmlTextWriter specificato.

protected override void RenderAttributes (System.Web.UI.HtmlTextWriter writer);

Parametri

writer
HtmlTextWriter

Oggetto HtmlTextWriter contenente il flusso di output per il rendering sul client.

Eccezioni

La proprietà HRef contiene un URL non valido.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del RenderAttributes metodo in un controllo server personalizzato in modo che il testo del titolo specifico, accessibile come descrizione comando, venga sempre visualizzato per il HtmlAnchor controllo.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Custom HtmlAnchor - RenderAttributes - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>>

      <h3>Custom HtmlAnchor - RenderAttributes - C# Example</h3>
      <p>Place the mouse pointer over the HtmlAnchor1 tag (above). A Title attribute was added from within the RenderAttributes override method.</p>
      <p>Jump to <a href="#HtmlAnchor2">HtmlAnchor2</a> below.</p>

      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>

      <p>Jump to <a href="#HtmlAnchor1">HtmlAnchor1</a> above.</p>
      <p> </p>Bottom of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>>
    </form>
  </body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomHtmlAnchorRenderAttributes : System.Web.UI.HtmlControls.HtmlAnchor
    {
        protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
        {
            // Call the base class's RenderAttributes method.
            base.RenderAttributes(writer);
            
            // Write out the HtmlAnchor control's Title tag.
            writer.Write(" Title=\"Text from RenderAttributes.\"");
        }
    }
}

Commenti

Se il valore della HRef proprietà è un URL non valido, il RenderAttributes metodo genera un'eccezione HttpException .

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Vedi anche