HtmlImage.RenderAttributes-Methode

Rendert die Attribute des HtmlImage-Steuerelements in das angegebene HtmlTextWriter-Objekt.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overrides Sub RenderAttributes ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.RenderAttributes(writer)

protected override void RenderAttributes (
    HtmlTextWriter writer
)

protected:
virtual void RenderAttributes (
    HtmlTextWriter^ writer
) override

protected void RenderAttributes (
    HtmlTextWriter writer
)

protected override function RenderAttributes (
    writer : HtmlTextWriter
)

Parameter

writer
Der HtmlTextWriter, der den Ausgabestream enthält, der auf dem Client gerendert werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
HttpException	Die Src-Eigenschaft enthält einen fehlerhaften URL.

Hinweise

Wenn der Wert der Src-Eigenschaft ein fehlerhafter URL ist, löst die RenderAttributes-Methode eine HttpException-Ausnahme aus.

Die RenderAttributes-Methode überschreibt die RenderAttributes-Methode der Basisklasse, um das src-Attribut des gerenderten HtmlImage-Steuerelements zu schreiben.

Die RenderAttributes-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des HtmlImage-Steuerelements verwendet.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der RenderAttributes-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass im HtmlImage-Steuerelement immer ein bestimmter alternativer Text angezeigt wird, der auch als QuickInfo verfügbar ist.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
  <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>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
  <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.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlImage - RenderAttributes - VJ# Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom HtmlImage - RenderAttributes - VJ# Example</h3>

      <aspSample:CustomHtmlImageRenderAttributes id="Img1"
        runat="server"
        border="0"
        src="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />
    </form>
  </body>
</HTML>

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

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.\"");
        }
    }
}

package Samples.AspNet.JSL.Controls;

public class CustomHtmlImageRenderAttributes
    extends System.Web.UI.HtmlControls.HtmlImage
{
    protected void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
    {
        // Call the base's RenderAttributes method.
        super.RenderAttributes(writer);
        // Write out Title tag
        writer.Write(" alt=\"Text from custom RenderAttributes method.\"");
    } //RenderAttributes
} //CustomHtmlImageRenderAttributes

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlImage-Klasse
HtmlImage-Member
System.Web.UI.HtmlControls-Namespace
Src

Weitere Ressourcen

HTML-Serversteuerelemente

Last updated on 2007-08-20

Freigeben über