FAQ ASP.NET/VB.NET

Sommaire > Les contr�les personnalis�s
        Comment cr�er un composant personnalis� (customControl) ?
        Quelle est la diff�rence entre un composant personnalis� et un contr�le utilisateur ?
        Comment utiliser un contr�le personnalis� ?
        Comment cr�er un composant personnalis� � partir d'un contr�le existant ?
        Comment faire le rendu d'un composant personnalis� ?
        Comment faire pour r�f�rencer automatiquement un contr�le dans toutes les pages ?

� Version hors-ligne (Miroir)

Comment cr�er un composant personnalis� (customControl) ?

[haut]

auteur : nico-pyright(c)

On cr�e un composant personnalis� lorsqu'on a besoin de cr�er un contr�le propre qui doit se comporter comme un WebControl.
Il s'agit de cr�er une classe qui h�rite de WebControl.
add -> new item -> class


					Public Class MonWebControl
    Inherits WebControl
End Class

Toute la logique interne doit ensuite etre impl�ment�e, �v�nement, rendu, etc ...
Voir aussi : quelle est la diff�rence entre un composant personnalis� et un contr�le utilisateur ?

Quelle est la diff�rence entre un composant personnalis� et un contr�le utilisateur ?

[haut]

auteur : nico-pyright(c)

Un contr�le utilisateur (userControl) et un contr�le personnalis� (customControl) sont tous les deux des contr�les. Ils ont en g�n�ral tous les deux pour but d'�tre des composants r�utilisables.
Les contr�les utilisateurs sont en g�n�ral des contr�les compos�s d'autres contr�les de base � utiliser dans des situations pr�cises. Ca peut etre le cas par exemple pour un contr�le utilisateur de login, qui poss�de deux labels, deux textbox et un bouton valider, ainsi que le traitement associ� au bouton valider.
Les contr�les personnalis�s sont en g�n�ral des contr�les unitaires qui font une tache unique et qui sont cr��s de A � Z ou en d�rivant d'un contr�le existant. Il peut s'agir par exemple d'un textbox num�rique qui sera exactement comme un textbox sauf qu'on pourra saisir uniquement des nombres.
En g�n�ral, on cr�e un contr�le personnalis� lorsqu'il a pour vocation d'etre utilis� dans plusieurs applications. Si le contr�le ne doit etre utilis� que dans un seul site web, on cr�era en g�n�ral un contr�le utilisateur.
Un contr�le utilisateur est une page dont l'extension est .ascx alors qu'un contr�le personnalis� sera une assembly

Comment utiliser un contr�le personnalis� ?

[haut]

auteur : nico-pyright(c)

Il s'agit d'abord d'utiliser la directive Register en pr�cisant un pr�fixe, le namespace et l'assembly qui contient le contr�le.



					<%@ Register TagPrefix="Exemple" Namespace="testWeb" Assembly="testWeb" %>

Pour utiliser le contr�le, on fera ensuite :


					<Exemple:MonControle ID="monId" runat="server" ... />

Comment cr�er un composant personnalis� � partir d'un contr�le existant ?

[haut]

auteur : nico-pyright(c)

Il faudra faire d�river notre custom control du contr�le p�re et surcharger les m�thodes qui nous int�ressent.
Exemple : voici l'impl�mentation d'un custom control qui d�rive du composant Image pour proposer l'ajout d'un rollover.


					Public Class MonImageRollOver
    Inherits Image

    Private _imageOverUrl As String
    Public Property ImageOverUrl() As String
        Get
            Return _imageOverUrl
        End Get
        Set(ByVal value As String)
            _imageOverUrl = value
        End Set
    End Property

    Protected Overrides Sub OnPreRender(ByVal e As System.EventArgs)
        Attributes.Add("onmouseover", String.Format("this.src = '{0}'", _imageOverUrl))
        Attributes.Add("onmouseout", String.Format("this.src = '{0}'", ImageUrl))
        MyBase.OnPreRender(e)
    End Sub
End Class

On a rajout� ici la propri�t� ImageOverUrl et surcharg� le rendu en ajoutant les attributs javascript onmouseover et onmouseout.
On pourra utiliser le contr�le de cette facon :


					<Exemple:MonImageRollOver ID="IdImageRollover" runat="server" ImageUrl="image.gif" ImageOverUrl="image_Over.gif" />

Comment faire le rendu d'un composant personnalis� ?

[haut]

auteur : nico-pyright(c)

il faudra surcharger la m�thode


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

et utiliser l'objet HtmlTextWriter pour faire le rendu.
Exemple : voici l'impl�mentation d'un contr�le hyperlink de A � Z qui g�re le rollover



					Public Class MonHyperLinkRollOver
    Inherits WebControl

    Private _imageOverUrl As String
    Public Property ImageOverUrl() As String
        Get
            Return _imageOverUrl
        End Get
        Set(ByVal value As String)
            _imageOverUrl = value
        End Set
    End Property

    Private _imageUrl As String
    Public Property ImageUrl() As String
        Get
            Return _imageUrl
        End Get
        Set(ByVal value As String)
            _imageUrl = value
        End Set
    End Property

    Private _navigateUrl As String
    Public Property NavigateUrl() As String
        Get
            Return _navigateUrl
        End Get
        Set(ByVal value As String)
            _navigateUrl = value
        End Set
    End Property

    Private _alt As String
    Public Property Alt() As String
        Get
            Return _alt
        End Get
        Set(ByVal value As String)
            _alt = value
        End Set
    End Property

    Protected Overrides Sub Render(ByVal writer As System.Web.UI.HtmlTextWriter)
        writer.WriteBeginTag("a")
        writer.WriteAttribute("href", ResolveUrl(_navigateUrl))
        writer.Write(HtmlTextWriter.TagRightChar)

        writer.WriteBeginTag("img")
        writer.WriteAttribute("id", ID)
        writer.WriteAttribute("src", _imageUrl)
        writer.WriteAttribute("style", "border:none;")
        writer.WriteAttribute("alt", _alt)
        writer.WriteAttribute("onmouseover", String.Format("this.src = '{0}'", _imageOverUrl))
        writer.WriteAttribute("onmouseout", String.Format("this.src = '{0}'", _imageUrl))
        writer.Write(HtmlTextWriter.SlashChar)
        writer.Write(HtmlTextWriter.TagRightChar)

        writer.WriteEndTag("a")
    End Sub

End Class

On a d'abord le code pour les propri�t�s et ensuite le rendu.
On utilise WriteBeginTag / WriteAttribute / Write / WriteEndTag pour �crire du html.
Ici l'appel :


					<Exemple:MonHyperLinkRollOver ID="MonImageRollOver1" NavigateUrl="~/Default.aspx" runat="server" ImageUrl="image.gif" ImageOverUrl="image_Over.gif" alt="mon alt"/>

produira en sortie :


					<a href="/Default.aspx"><img id="MonImageRollOver1" src="image.gif" style="border:none;" 
	alt="mon alt" onmouseover="this.src = 'image_Over.gif'" onmouseout="this.src = 'image.gif'"/></a>

Comment faire pour r�f�rencer automatiquement un contr�le dans toutes les pages ?

[haut]

auteur : nico-pyright(c)

il faut placer sa d�finition dans le web.config :


					<pages>
  <controls>
      <add tagPrefix="Exemple" namespace="testWeb" assembly="testWeb" />
  </controls>
</pages>

� Version hors-ligne (Miroir)

Consultez les autres F.A.Q's

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2007 Dotnet Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.