Connexion

Select the product you need help with

Utilisation des ressources Web dans ASP.NET 2.0

Num�ro d'article: 910442 - Voir les produits auxquels s'applique cet article

ATTENTION : Cet article est issu du syst�me de traduction automatique

Cliquez ici si vous souhaitez afficher en c�te � c�te l?article anglais et sa traduction automatique en fran�ais

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

Colonne vocale d'assistance ASP.NET

Utilisation des ressources Web dans ASP.NET 2.0

Pour personnaliser cette colonne � vos besoins, nous souhaitons vous inviter � soumettre vos id�es sur les sujets qui vous int�ressent et probl�mes que vous souhaitez voir trait�s dans de futurs articles de la Base de connaissances et des colonnes Support Voice. Vous pouvez soumettre vos id�es et commentaires � l'aide de la Demandez-le
(http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=)
. Il existe �galement un lien vers le formulaire au bas de cette colonne.

Agrandir tout | R�duire tout

Sommaire

Introduction

Bonjour ! Mon nom est Praveen Yerneni et je suis une travail responsable technique avec le groupe de prise en charge ASP.NET chez Microsoft. Dans l'article de mois-ci ce, je vais pour discuter des ressources Web et comment les impl�menter dans votre application.

Si vous �tes un d�veloppeur qui travaille de mani�re intensive avec COM contr�les, vous pouvez trouver cet article utile dans adressage quelques-unes des principales probl�mes que vous pouvez rencontrer lors du d�veloppement de contr�les. Auparavant, dans Microsoft ASP.NET 1.1, si vous souhaitez d�ployer les fichiers statiques tels que les fichiers .html, .css fichiers, les fichiers image et les fichiers de script � l'aide d'un contr�le COM, vous deviez cr�er un programme d'installation et d'une offre group�e ces fichiers ainsi que de la COM de contr�le. Bien que Cela a fonctionn�, il pr�sente de nombreux probl�mes lors du d�ploiement du contr�le. Pour exemple, vous disposiez des probl�mes de conflits de version, avec assurant que les fichiers tels que les images ont �t� d�ploy�s sur le m�me emplacement ou avec endommag� ou suppression des fichiers statiques qui pourraient provoquer l'�chec du contr�le.

Web Ressources dans Microsoft ASP.NET 2.0 r�sout ces probl�mes en vous permettant du d�veloppeur incorporer ces ressources dans l'assembly en tant que .resources. Pour acc�der � ces ressources statiques, vous pouvez simplement appeler une m�thode dans le contr�le code.

Retour au d�but | Envoyer des commentaires

Comment fonctionnent les ressources Web

Ressources Web se fier � un gestionnaire sp�cial nomm� WebResource.axd, qui est con�u pour r�cup�rer des ressources de l'assembly et servir leur navigateur Web. Le type de gestionnaire de WebResource.axd est AssemblyResourceLoader.

Lorsqu'une demande arrive � partir du client pour WebResource.axd, le gestionnaire recherche l'identificateur de ressource Web dans la m�thode QueryString de l'objet Request . Selon la valeur de l'identificateur de ressource Web, le Gestionnaire essaie de charger l'assembly qui contient cette ressource. Si ce op�ration est r�ussie, le gestionnaire recherche ensuite l'attribut d'assembly et charger le flux de ressources � partir de l'assembly. Enfin, le gestionnaire s'emparer les donn�es � partir de la ressource de flux et l'envoyer au client avec le type de contenu que vous sp�cifiez dans l'attribut d'assembly.

L'URL pour WebResource.axd ressemble � ceci :

WebResource.axd?d=SbXSD3uTnhYsK4gMD8fL84_mHPC5jJ7lfdnr1_WtsftZiUOZ6IXYG8QCXW86UizF0&t=632768953157700078

Le format de cette URL est WebResource.axd?d=crypt� identificateur& t =cachet. Le � d � signifie la ressource Web demand�e. Le � t � est l'horodatage de la assembly demand�, ce qui peut vous aider � d�terminer s'il y a aucune modifications � la ressource.

Plonger dans le code

Dans mon exemple, j'ai d�velopp� un contr�le COM qui est consomm� par une application Web ASP.NET pour illustrer cette nouvelle fonctionnalit�.

Contr�le de COM pour la ressource Web

Pour la cr�ation et l'incorporation d'une ressource Web, j'ai d�velopp� une COM contr�le (SimpleControl). Il a les ressources incorpor�es suivantes :

Deux fichiers nomm�s smallFail.gif d'image et smallSuccess.gif. ces fichiers image sont utilis�s pour les effets de substitution dans le contr�le et qui sont consomm�s dans le code de contr�le.
Un fichier HTML nomm� Help.htm. Ce fichier n'existe pas contiennent la quantit� de texte et est seulement pour la d�monstration.
Un seul fichier JavaScript nomm� MyScript.js. Ce fichier contient du code JavaScript qui montre �galement la fonctionnalit� de substitution Pour obtenir une r�f�rence � une autre ressource incorpor�e dans le m�me assembly.
Un seul fichier .css est nomm� MyStyleSheet.css. Ce style feuille est ensuite consomm� directement � partir de l'application Web ASP.NET.

Dans cet article, j'aborderai les parties qui sont n�cessaires pour Ressources Web.

Incorporer des ressources Web

Vous devez d'abord vous assurer que tous les fichiers statiques sont ajout� � la biblioth�que de contr�les Web sont de projet dans Microsoft Visual Studio 2005 ressources incorpor�es. Pour incorporer ces ressources, tout ce que vous avez � faire est d'ajouter Ces fichiers dans Visual Studio, puis modifiez les propri�t�s de ces fichiers ainsi que l'action de g�n�ration a la valeur Incorpor� Ressource.

Apr�s cela, vous devez aussi rendre assurer que ces ressources ont �t� r�f�renc�s par l'attribut d'assembly dans le fichier AssemblyInfo.cs WebResource , comme indiqu� ci-dessous.

[assembly: WebResource("SimpleControl.Help.htm", "text/html")]
[assembly: WebResource("SimpleControl.MyStyleSheet.css", "text/css")]
[assembly: WebResource("SimpleControl.smallFail.gif", "image/gif")]
[assembly: WebResource("SimpleControl.smallSuccess.gif", "image/gif")]
[assembly: WebResource("SimpleControl.MyScript.js", "text/javascript", PerformSubstitution = true)]

L'attribut d'assembly WebResource a trois param�tres comme suit :

Ressource Web: le nom de la ressource est incorpor�e dans l'assembly
ContentType: type de fichier le MIME de la ressource
PerformSubstitution: une valeur bool�enne qui d�termine si autres URL de la ressource Web qui sont r�f�renc�s dans cette ressource sont analys�es et remplac�es par le chemin complet de la ressource

L'extraction de ressources Web

Pour l'obtention de la ressource Web, j'ai utilis� la m�thode GetWebResourceUrl , qui est une m�thode de la classe ClientScriptManager qui est g�n�ralement utilis�e pour g�rer des scripts c�t� client. Cette m�thode retourne une r�f�rence URL � la ressource c�t� serveur incorpor� dans un assembly. La m�thode GetWebResourceUrl accepte deux param�tres suivants :

Type: le type de la ressource c�t� serveur
Nom de la ressource: le nom de la ressource c�t� serveur

Pour utiliser cette m�thode, vous devez d'abord cr�er une instance de la classe ClientScriptManager et obtenir le type de la classe, comme illustr� ci-dessous.

ClientScriptManager cs = Page.ClientScript;
            Type rsType = this.GetType();

Lorsque vous avez une instance de cette classe, vous devez ensuite appeler cette m�thode m�thode et passer les param�tres appropri�s comme indiqu� ci-dessous, o� je cr�e un bouton de lien hypertexte et d�finir la m�thode NavigateURL pour pointer vers une ressource HTML incorpor�e.

HyperLink hlHelpFile = new HyperLink();
            hlHelpFile.NavigateUrl = cs.GetWebResourceUrl(rsType, "SimpleControl.Help.htm");
            hlHelpFile.Attributes.Add("onmouseover", "ChangeImage('image1','Red')");
            hlHelpFile.Attributes.Add("onmouseout", "RollbackImage('image1','Green')");
            
            this.Controls.Add(hlHelpFile);

            Image imgTest = new Image();
            imgTest.ImageUrl = cs.GetWebResourceUrl(rsType, "SimpleControl.smallFail.gif");
            imgTest.ID = "image1";
            hlHelpFile.Controls.Add(imgTest);

Dans le m�me code ci-dessus, j'ai �galement cr�� un bouton d'Image et de l'attribut ImageUrl est l'obtention de sa valeur d'une autre image .gif incorpor� ressource.

� l'aide de la fonctionnalit� de Substitution

Une autre fonctionnalit� utile de l'utilisation des ressources Web est la propri�t� PerformSubstitution de l'attribut WebResource , comme indiqu� dans la section "L'incorporation de the Resources Web" ci-dessus. Cette fonctionnalit� vous permet d'obtenir effectivement ressources Web � l'int�rieur d'un autre incorpor� ressource. Si cette propri�t� est activ�e, le gestionnaire WebResource analyser la ressource incorpor�e et remplacer la syntaxe pour l'attribut d'assembly WebResource des ressources r�elles avant de servir la page.

Dans le code ci-dessus, vous remarquerez que le contr�le de lien hypertexte a un �v�nement c�t� client qui est nomm� ChangeImage. Cette fonction de ChangeImage se trouve dans un fichier de script. Voici le code Pour ce script.

function ChangeImage(imgControl,varcolor){
   document.getElementById(imgControl).src = '<%= WebResource("SimpleControl.smallSuccess.gif")%>';
    document.getElementById('Label1').style.color = varcolor;
}

function RollbackImage(imgControl, varcolor){
   document.getElementById(imgControl).src = '<%= WebResource("SimpleControl.smallFail.gif")%>';
   document.getElementById('Label1').style.color = varcolor;
}

Ce fichier de script nomm� MyScript.js est �galement une ressource incorpor�e dans le m�me contr�le COM. Et notez que j'utilise la m�thode WebResource pour faire r�f�rence � une autre ressource incorpor�e dans le script .

En outre, pour vous assurer que ce fichier JavaScript est enregistr� dans la page, j'utilise la m�thode RegisterClientScriptInclude de la classe ClientScriptManager comme indiqu� ci-dessous.

cs.RegisterClientScriptInclude("MyScript", cs.GetWebResourceUrl(rsType, "SimpleControl.MyScript.js"));

Utilisation du contr�le dans ASP.NET

Une fois que vous avez cr�� avec succ�s le contr�le COM, vous devez consommer ce contr�le dans un projet ASP.NET de client. Pour ce faire, vous devez Ajoutez le contr�le � la bo�te � outils dans ASP.NET. Vous pouvez alors ajouter le contr�le � n'importe quel Formulaire Web dans le concepteur.

Lorsque vous ajoutez le contr�le � la bo�te � outils, le contr�le est enregistr� pour vous et le code suivant est ajout� lorsque vous regardez la syntaxe HTML.

<cc1:MSButton ID="MSButton1" runat="server" strText="Problems?"></cc1:MSButton>

Dans mon contr�le COM, j'ai �galement incorpor� un fichier de feuille de style, je vais � l'aide de mon application ASP.NET. Pour acc�der � cette feuille de style, vous devez ajouter un lien HtmlControl dans la page HTML et d�finissez la propri�t� runatserver comme indiqu� ci-dessous.

<link rel="Stylesheet"  id="lnkStyle" runat="server"  />

Apr�s cela, vous pouvez d�finir par programme l'attribut Href de ce contr�le pour pointer vers l'attribut d'assembly WebResource dans l'�v�nement Page_Load , comme indiqu� ci-dessous.

protected void Page_Load(object sender, EventArgs e)
    {
        //Get the name of the Web Resource.
        String rsname = "SimpleControl.MyStyleSheet.css";
        
        //Get the type of the class.
        Type rstype = typeof(SimpleControl.MSButton);

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;
        lnkStyle.Href = cs.GetWebResourceUrl(rstype, rsname);
     }

Lorsque vous ex�cutez le code, vous verrez un contr�le qui ressemble � la suivant :

R�duire cette imageAgrandir cette image

Et sur le passage de la souris, le contr�le sera l'aspect suivant :

R�duire cette imageAgrandir cette image

Lorsque vous cliquez sur ce lien, il faudra vous � la page d'aide, qui est incorpor�e dans le fichier d'assembly COM.

Conclusion

Ressources Web est une nouvelle fonctionnalit� tr�s utile dans ASP.NET 2.0. Vous pouvez utiliser Cette fonctionnalit� � votre avantage si vous l'utilisez avec prudence. De nombreuses techniques de mise en cache ont �t� utilis�s pour s'assurer que les ressources Web n'affectent pas les performances de l'application.

Dans ASP.NET 2.0, WebResource.axd est utilis� en interne par le.NET Framework Microsoft pour r�cup�rer des ressources incorpor�es. Par exemple, le .NET Framework utilise WebResource.axd pour r�cup�rer le script WebUIValidation.js fichier qui est utilis� pour les contr�les de Validation et de r�cup�rer le fichier de script Menu.js pour les contr�les de Menu .

R�f�rences

Pour plus d'informations, visitez les sites Web de Microsoft aux adresses suivantes :

M�thode ClientScriptManager.GetWebResourceUrl
http://msdn2.Microsoft.com/en-us/library(d=robot) /system.web.ui.clientscriptmanager.getwebresourceurl.aspx

(http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.clientscriptmanager.getwebresourceurl.aspx)

Classe WebResourceAttribute
http://msdn2.Microsoft.com/en-us/library(d=robot) /system.web.ui.webresourceattribute.aspx

(http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.webresourceattribute.aspx)

Ressources li�es et incorpor�es
http://msdn2.Microsoft.com/en-us/library/ht9h2dk8.aspx

(http://msdn2.microsoft.com/en-us/library/ht9h2dk8.aspx)

Retour au d�but | Envoyer des commentaires

Comme toujours, n'h�sitez pas � soumettre des id�es sur des sujets que vous souhaitez adress�e dans les chroniques � venir ou dans la Base de connaissances � l'aide du Demandez-le

(http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=)

Retour au d�but | Envoyer des commentaires

Propri�t�s

Num�ro d'article: 910442 - Derni�re mise � jour: mardi 30 avril 2013 - Version: 3.0

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft ASP.NET 2.0

kbhowto kbasp kbmt KB910442 KbMtfr

Traduction automatique

IMPORTANT : Cet article est issu d'une traduction automatique r�alis�e par un logiciel Microsoft et non par un traducteur professionnel. Cette traduction automatique a pu aussi �tre r�vis�e par la communaut� Microsoft gr�ce � la technologie Community Translation Framework (CTF). Pour en savoir plus sur cette technologie, veuillez consulter la page http://support.microsoft.com/gp/machine-translation-corrections/fr. Microsoft vous propose en effet des articles traduits par des professionnels, des articles issus de traductions automatiques et des articles issus de traductions automatiques r�vis�es par la communaut� Microsoft, de mani�re � ce que vous ayez acc�s � tous les articles de notre Base de connaissances dans votre langue. Il est important de noter que les articles issus de la traduction automatique, y compris ceux r�vis�s par la communaut� Microsoft, peuvent contenir des erreurs de vocabulaire, de syntaxe ou de grammaire. Microsoft ne pourra �tre tenu responsable des impr�cisions, erreurs, ainsi que de tout dommage r�sultant d?une traduction incorrecte du contenu ou de son utilisation par les clients.

La version anglaise de cet article est la suivante: 910442

(http://support.microsoft.com/kb/910442/en-us/ )

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

Cet article concerne des produits pour lesquels Microsoft n'offre plus de support. Il est par cons�quent fourni � en l'�tat � et ne sera plus mis � jour.

Retour au d�but | Envoyer des commentaires