Image.RenderContents(HtmlTextWriter) Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Génère le rendu du contrôle d'image via le writer spécifié.

protected:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);

protected public:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);

protected 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 Overrides Sub RenderContents (writer As HtmlTextWriter)

Protected Friend Overrides Sub RenderContents (writer As HtmlTextWriter)

Paramètres

writer: HtmlTextWriter

HtmlTextWriter qui représente le flux de sortie pour le rendu du contenu HTML sur le client.

Exemples

L’exemple de code suivant montre comment remplacer la RenderContents méthode dans un contrôle serveur personnalisé afin qu’une partie du texte s’affiche toujours après .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

Remarques

La RenderContents méthode est principalement utilisée par les développeurs de contrôles. Le Image contrôle implémente la méthode pour ignorer le RenderContents rendu des contrôles enfants.

S’applique à

Voir aussi

RenderContents(HtmlTextWriter)