Exporter (0) Imprimer
Développer tout

ClientScriptManager.RegisterClientScriptInclude, méthode (Type, String, String)

Inscrit le script client Include avec l'objet Page à l'aide d'un type, d'une clé et d'une URL.

Espace de noms: System.Web.UI
Assembly : System.Web (dans system.web.dll)

public void RegisterClientScriptInclude (
	Type type,
	string key,
	string url
)
public void RegisterClientScriptInclude (
	Type type, 
	String key, 
	String url
)
public function RegisterClientScriptInclude (
	type : Type, 
	key : String, 
	url : String
)
Non applicable.

Paramètres

type

Type du script client Include à inscrire.

key

Clé du script client Include à inscrire.

url

URL du script client Include à inscrire.

Type d'exceptionCondition

ArgumentNullException

Le type du script client Include est référence Null (Nothing en Visual Basic).

ArgumentException

L'URL est référence Null (Nothing en Visual Basic).

- ou -

L'URL est vide.

Cette surcharge de la méthode RegisterClientScriptInclude accepte les paramètres key et url pour identifier le script, ainsi qu'un paramètre type pour spécifier l'identification du script client Include. Vous spécifiez le type en fonction de l'objet qui accédera à la ressource. Par exemple, lorsque vous utilisez une instance de Page pour accéder à la ressource, vous spécifiez le type Page.

RemarqueRemarque :

Pour résoudre l'URL cliente, utilisez la méthode ResolveClientUrl. Cette méthode utilise le contexte de l'URL à partir de laquelle elle est appelée pour résoudre le chemin d'accès.

Cette méthode ajoute un bloc de script en haut de la page rendue.

L'exemple de code suivant illustre l'utilisation de la méthode RegisterClientScriptInclude. Notez que, si la logique à vérifier pour le bloc de script client Include existant était supprimée, il n'y aurait toujours aucun doublon de scripts clients dans la page rendue, car la méthode RegisterClientScriptInclude vérifie la présence de doublons. L'avantage de cette vérification tient dans la réduction du traitement superflu.

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    public void Page_Load(Object sender, EventArgs e)
    {
        // Define the name, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
  </body>
</html>

Cet exemple nécessite un fichier JavaScript nommé Script_include.js, avec le contenu suivant :

function DoClick() {Form1.Message.value='Text from include script.'}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft