Composition et rendu

Article
04/11/2008

Alors qu'il est relativement aisé de créer un contrôle composite, la composition altère les performances, car elle doit créer des contrôles enfants. Si vous recherchez des performances optimales de la part de votre contrôle, vous pouvez implémenter vous-même la logique de rendu en substituant la méthode Render. En outre, vous devez implémenter tout traitement des données de publication ainsi que la gestion des événements de publication requis par votre contrôle.

L'exemple suivant illustre le contrôle Rendered, qui rend une interface utilisateur équivalente à celle fournie dans l'exemple de contrôle serveur composite. Rendered n'utilise pas la composition et est donc plus complexe à créer.

Dans Rendered, les membres suivants sont identiques à ceux de l'exemple de contrôle serveur composite.

La propriété Text publique. (Toutefois, dans ce cas, la propriété n'est pas déléguée à un contrôle enfant.)
La propriété Number publique.
La propriété Sum privée.
L'événement Check personnalisé.

Comme Rendered ne possède pas de contrôle enfant, il doit exécuter les tâches supplémentaires suivantes.

Fournir sa propre implémentation pour les zones de texte.
Fournir sa propre implémentation pour un bouton d'envoi.
Implémenter IPostBackEventHandler.
Implémenter IPostBackDataHandler.
Substituer la méthode Render.

Remarquez que Rendered n'utilise pas ViewState pour rendre les propriétés persistantes entre les allers-retours, car la restauration de l'état n'est pas nécessaire dans ce scénario. Remarquez aussi que dans cet exemple, la méthode Render écrit du code HTML brut dans la méthode Write de HtmlTextWriter. Pour obtenir un exemple d'utilisation des méthodes utilitaires de HtmlTextWriter pour le rendu, consultez Rendu d'exemples de contrôles serveur.

Pour générer l'exemple, consultez les instructions fournies dans Exemples de contrôles serveur.

using System;
using System.Web;
using System.Web.UI;
using System.Collections.Specialized;

namespace CustomControls
{
   
   public class Rendered : Control, IPostBackDataHandler, IPostBackEventHandler
   {
   
      private String text1;
      private String text2;
      private String text = "Press the button to see if you won.";
      private int number = 100;
      

      private int Sum
      {
         get 
         {        
            return Int32.Parse(text1) + 
               Int32.Parse(text2);
         }  
      }
      
      public int Number
      {
         get
         {
            return number;
         }
         set
         {
            number = value;
         }
      }
      
      
      public String Text {
         get {
            return text;
         }
         set { 
            text = value;
         }        
      }
      
      public event CheckEventHandler Check;
      
      protected virtual void OnCheck(CheckEventArgs ce)
      {
         if (Check != null)
         {
            Check(this,ce);
         }
      }
      
      public virtual bool LoadPostData(string postDataKey, 
         NameValueCollection values) {
         text1 = values[UniqueID + "t1"];
         text2 = values[UniqueID+ "t2"];
         Page.RegisterRequiresRaiseEvent(this);
         return false;
      }
      
      public virtual void RaisePostDataChangedEvent() {
      }
      
      public void RaisePostBackEvent(string eventArgument){
         
         OnCheck(new CheckEventArgs(Sum - Number));
      }
      
      
      protected override void Render(HtmlTextWriter output) {
         output.Write ("<h3>Enter a number : ");
            output.Write("<INPUT type= text name = " + this.UniqueID + "t1" + 
            " value = '0' >");
            output.Write("</h3><br>");   
            output.Write ("<br><h3>Enter another number : ");
         output.Write("<INPUT type= text name = " + this.UniqueID + "t2" + 
            " value =  '0' >");
         output.Write("</h3><br>");   
         output.Write("<br><br><input type= submit name = " + 
            this.UniqueID + " value= 'Submit'>");
         output.Write("<br><br><span style='height:50px;width:500px;'>"
            + Text + "</span>");
      }
   }     

} 

// CheckEvent.cs.
// Contains the code for the custom event data class CheckEventArgs.
// Also defines the event handler for the Check event.
using System;

namespace CustomControls
{
      public class CheckEventArgs : EventArgs
      {
            private bool match = false;
            
            public CheckEventArgs (int difference)
            {
                  if (difference == 0)
                  {
                        match = true;
                  }
            }
            public bool Match
            {
                  get
                  {
                        return match;
                  }
            }
      }
      
      public delegate void CheckEventHandler(object sender, CheckEventArgs ce);
}

[Visual Basic]
Option Explicit
Option Strict

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Collections.Specialized

Namespace CustomControls
   Public Class Rendered
      Inherits Control
      Implements IPostBackDataHandler, IPostBackEventHandler
      
      Private text1 As String
      Private text2 As String
      Private _text As String = "Press enter to see if you won."
      Private _number As Integer = 100
      
      Private ReadOnly Property Sum() As Integer
         Get
            Return Int32.Parse(text1) + Int32.Parse(text2)
         End Get
      End Property
      
      Public Property Number() As Integer
         Get
            Return _number
         End Get
         Set
            _number = value
         End Set
      End Property
      
      Public Property Text() As String
         Get
            Return _text
         End Get
         Set
            _text = value
         End Set
      End Property
      
      Public Event Check As CheckEventHandler
      
      Protected Overridable Sub OnCheck(ce As CheckEventArgs)
         RaiseEvent Check(Me, ce)
      End Sub
      
      Public Overridable Function LoadPostData(postDataKey As String, values As NameValueCollection) As Boolean Implements IPostBackDataHandler.LoadPostData
         text1 = values(UniqueID & "t1")
         text2 = values(UniqueID & "t2")
         Page.RegisterRequiresRaiseEvent(Me)
         Return False
      End Function
      
      Public Overridable Sub RaisePostDataChangedEvent() Implements IPostBackDataHandler.RaisePostDataChangedEvent
      End Sub
      
      Public Sub RaisePostBackEvent(eventArgument As String) Implements IPostBackEventHandler.RaisePostBackEvent
         OnCheck(New CheckEventArgs(Sum - Number))
      End Sub
      
      Protected Overrides Sub Render(output As HtmlTextWriter)
         output.Write("<h3>Enter a number : ")
         output.Write("<INPUT type= text name = " & _
                        Me.UniqueID & "t1" & _
                        " value = '0' >")
         output.Write("</h3><br>")
         output.Write("<br><h3>Enter another number : ")
         output.Write("<INPUT type= text name = " & _
                        Me.UniqueID & "t2" & _
                        " value =  '0' >")
         output.Write("</h3><br>")
         output.Write("<br><br><input type= submit name = " & _
                        Me.UniqueID & _
                        " value= 'Submit'>")
         output.Write("<br><br><span style='height:50px;width:500px;'>" & _
                        Text & "</span>")
      End Sub
   End Class
End Namespace

' CheckEvent.vb
' Contains the code for the custom event data class CheckEventArgs.
' Also defines the event handler for the Check event.
Imports System
Namespace CustomControls
   Public Class CheckEventArgs
      Inherits EventArgs
      Private _match As Boolean = False
      
      Public Sub New(difference As Integer)
         If difference = 0 Then
            _match = True
         End If
      End Sub
      
      Public ReadOnly Property Match() As Boolean
         Get
            Return _match
         End Get
      End Property
   End Class
   
   Public Delegate Sub CheckEventHandler(sender As Object, ce As CheckEventArgs)
End Namespace

Utilisation d'un contrôle Rendered sur une page

La page suivante utilise le contrôle personnalisé Rendered, défini dans l'exemple précédent. Remarquez que cette page est identique à la page de l'exemple de contrôle serveur composite, qui utilise un contrôle composite plutôt qu'un contrôle Rendered.

<%@ Register TagPrefix="Custom" Namespace="CustomControls" Assembly = "CustomControls" %>

<script language="VB" runat=server>
   Private Sub Sum_Checked(sender As Object, e As CheckEventArgs)
      If e.Match = True Then
         Rendered.Text = "<h2> You won a million dollars!!!! </h2>"
      Else
         Rendered.Text = "Sorry, try again. The numbers you entered don't add up to" & _
                  " the hidden number."
      End If
   End Sub
</script>

<html>            
<body>
<h1> The Mystery Sum Game </h1><br>             
<form runat=server>                             
<Custom:Rendered id = "Rendered" OnCheck = "Sum_Checked" Number= "10" runat = server/>                                                                          
</form>                                               
</body>                                         
</html>

Voir aussi

Développement d'un contrôle composite

Partager via

Composition et rendu

Utilisation d'un contrôle Rendered sur une page

Voir aussi

Ressources supplémentaires