Image.RenderContents(HtmlTextWriter) Image.RenderContents(HtmlTextWriter) Image.RenderContents(HtmlTextWriter) Image.RenderContents(HtmlTextWriter) Method

定義

イメージ コントロールの内容を指定したライターに出力します。Renders the image control contents to the specified writer.

protected public:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected internal override void RenderContents (System.Web.UI.HtmlTextWriter writer);
override this.RenderContents : System.Web.UI.HtmlTextWriter -> unit
Protected Friend Overrides Sub RenderContents (writer As HtmlTextWriter)

パラメーター

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

クライアントに HTML コンテンツを表示する出力ストリームを表す HtmlTextWriterAn HtmlTextWriter that represents the output stream to render HTML content on the client.

次のコード例では、一部のRenderContentsテキストが常にのImage後に表示されるように、カスタムサーバーコントロールのメソッドをオーバーライドする方法を示します。The following code example demonstrates how to override the RenderContents method in a custom server control so that some text is always displayed after the Image.

<%@ 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 Image - RenderContents - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Image - RenderContents - C# Example</h3>
            
            <aspSample:CustomImageRenderContents 
              id="Image1" 
              runat="server" 
              ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif" 
              AlternateText="Microsoft Home" />
            
        </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 Image - RenderContents - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Image - RenderContents - VB.NET Example</h3>
            
            <aspSample:CustomImageRenderContents id="Image1" runat="server" 
             ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif" 
             AlternateText="Microsoft Home" />
            
        </form>
    </body>
</html>
using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomImageRenderContents : System.Web.UI.WebControls.Image
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Call the base RenderContents method.
      base.RenderContents(writer);

      // Append some text to the Image.
      writer.Write("<BR>Experience Windows Server 2003 and Visual Studio® .NET 2003.");
    }
  }
}
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomImageRenderContents
    Inherits System.Web.UI.WebControls.Image

    Protected Overrides Sub RenderContents(ByVal writer As System.Web.UI.HtmlTextWriter)

        ' Call the base RenderContents method.
        MyBase.RenderContents(writer)

        ' Append some text to the Image.
        writer.Write("<BR>Experience Windows Server 2003 and Visual Studio .NET 2003.")
    End Sub
End Class

注釈

メソッドRenderContentsは、主にコントロールの開発者によって使用されます。The RenderContents method is primarily used by control developers. コントロールImageは、メソッドRenderContentsを実装して、子コントロールのレンダリングをスキップします。The Image control implements the RenderContents method to skip rendering of any child controls.

適用対象

こちらもご覧ください