언어

HtmlImage.RenderAttributes(HtmlTextWriter) 메서드

정의

네임스페이스:
System.Web.UI.HtmlControls
어셈블리:
System.Web.dll

HtmlImage 컨트롤의 특성을 지정된 HtmlTextWriter 개체에 렌더링합니다.

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)

매개 변수

writer
HtmlTextWriter

HtmlTextWriter 클라이언트에서 렌더링할 출력 스트림을 포함하는 항목입니다.

예외

HttpException

속성 Src 에 잘못된 형식의 URL이 포함되어 있습니다.

예제

다음 코드 예제에서는 도구 설명으로 액세스할 수 있는 특정 대체 텍스트가 항상 컨트롤과 함께 표시 되도록 사용자 지정 서버 컨트롤에서 메서드를 재정 RenderAttributes 의 HtmlImage 하는 방법을 보여 줍니다.

<%@ 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

설명

속성 값 Src 이 잘못된 URL인 경우 메서드는 RenderAttributes 예외를 HttpException throw합니다.

이 메서드는 RenderAttributes 기본 클래스의 메서드를 재정의 RenderAttributes 하여 렌더링된 src 컨트롤의 특성을 작성 HtmlImage 합니다.

이 RenderAttributes 메서드는 주로 컨트롤의 기능을 확장 하는 컨트롤 개발자에 HtmlImage 의해 사용 됩니다.

적용 대상

참고 항목