HtmlImage.RenderAttributes(HtmlTextWriter) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa los atributos del control HtmlImage en el objeto HtmlTextWriter especificado.
protected:
override void RenderAttributes(System::Web::UI::HtmlTextWriter ^ writer);
protected override void RenderAttributes (System.Web.UI.HtmlTextWriter writer);
override this.RenderAttributes : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub RenderAttributes (writer As HtmlTextWriter)
Parámetros
- writer
- HtmlTextWriter
HtmlTextWriter que contiene el flujo de salida que se representará en el cliente.
Excepciones
La propiedad Src contiene una dirección URL incorrecta.
Ejemplos
En el ejemplo de código siguiente se muestra cómo invalidar el RenderAttributes método en un control de servidor personalizado para que siempre se muestre texto alternativo específico, accesible como información sobre herramientas, con el HtmlImage control .
<%@ 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 HtmlImage - RenderAttributes - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom HtmlImage - RenderAttributes - C# Example</h3>
<aspSample:CustomHtmlImageRenderAttributes id="Img1"
runat="server"
border="0"
src="image.jpg" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" 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 HtmlImage - RenderAttributes - Visual Basic Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom HtmlImage - RenderAttributes - Visual Basic Example</h3>
<aspSample:CustomHtmlImageRenderAttributes id="Img1"
runat="server"
border="0"
src="image.jpg" />
</form>
</body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomHtmlImageRenderAttributes : System.Web.UI.HtmlControls.HtmlImage
{
protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
{
// Call the base class's RenderAttributes method.
base.RenderAttributes(writer);
// Write out the HtmlImage control's alt tag.
writer.Write(" alt=\"Text from custom RenderAttributes method.\"");
}
}
}
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomHtmlImageRenderAttributes
Inherits System.Web.UI.HtmlControls.HtmlImage
Protected Overrides Sub RenderAttributes(ByVal writer As System.Web.UI.HtmlTextWriter)
' Call the base class's RenderAttributes method.
MyBase.RenderAttributes(writer)
' Write out the HtmlImage control's alt tag.
writer.Write(" alt=""Text from custom RenderAttributes method.""")
End Sub
End Class
End Namespace
Comentarios
Si el valor de la Src propiedad es una dirección URL con formato incorrecto, el RenderAttributes método produce una HttpException excepción.
El RenderAttributes método invalida el método de RenderAttributes la clase base para escribir el src
atributo del control representado HtmlImage .
El RenderAttributes método se usa principalmente por los desarrolladores de controles que amplían la funcionalidad del HtmlImage control.