HtmlImage.RenderAttributes(HtmlTextWriter) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Rendert die Attribute des HtmlImage Steuerelements für das angegebene HtmlTextWriter Objekt.
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 -> unitProtected Overrides Sub RenderAttributes (writer As HtmlTextWriter)Parameter
- writer
- HtmlTextWriter
Die HtmlTextWriter , die den Ausgabedatenstrom enthält, der auf dem Client gerendert werden soll.
Ausnahmen
Die Src Eigenschaft enthält eine falsch formatierte URL.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie die RenderAttributes Methode in einem benutzerdefinierten Serversteuerelement außer Kraft setzen, sodass ein bestimmter alternativer Text, auf den als QuickInfo zugegriffen werden kann, immer mit dem HtmlImage Steuerelement angezeigt wird.
<%@ 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
Hinweise
Wenn der Wert der Src Eigenschaft eine falsch formatierte URL ist, löst die RenderAttributes Methode eine HttpException Ausnahme aus.
Die RenderAttributes Methode überschreibt die Methode der Basisklasse RenderAttributes , um das src Attribut des gerenderten HtmlImage Steuerelements zu schreiben.
Die RenderAttributes Methode wird hauptsächlich von Steuerelemententwicklern verwendet, die die Funktionalität des HtmlImage Steuerelements erweitern.
