Partager via


ClientScriptManager.RegisterClientScriptInclude Méthode

Définition

Inscrit le script client Include avec l'objet Page.

Surcharges

RegisterClientScriptInclude(String, String)

Enregistre le script client avec l'objet Page, à l'aide d'une clé et d'une URL, qui active le script à appeler à partir du client.

RegisterClientScriptInclude(Type, String, String)

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

RegisterClientScriptInclude(String, String)

Enregistre le script client avec l'objet Page, à l'aide d'une clé et d'une URL, qui active le script à appeler à partir du client.

public:
 void RegisterClientScriptInclude(System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude (string key, string url);
member this.RegisterClientScriptInclude : string * string -> unit
Public Sub RegisterClientScriptInclude (key As String, url As String)

Paramètres

key
String

Clé du script client Include à inscrire.

url
String

URL du script client Include à inscrire.

Exemples

Pour plus d’informations, notamment la syntaxe, l’utilisation et un exemple, consultez RegisterClientScriptInclude.

Remarques

Un script client est identifié de manière unique par sa clé et son type. Les scripts avec la même clé et le même type sont considérés comme des doublons. Un seul script avec un type et une paire de clés donnés peuvent être inscrits auprès de la page. La tentative d’inscription d’un script déjà inscrit ne crée pas de doublon du script.

Appelez la IsClientScriptIncludeRegistered méthode pour déterminer si un script client inclut une clé et une paire de types donnée est déjà inscrite et évitez inutilement d’ajouter le script.

Notes

Pour résoudre l’URL du client, utilisez la ResolveClientUrl méthode. Cette méthode utilise le contexte de l’URL sur laquelle il est appelé pour résoudre le chemin d’accès.

Cette surcharge de la RegisterClientScriptInclude méthode appelle la surcharge qui prend un , un URL``keyet un type paramètre.

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

Voir aussi

S’applique à

RegisterClientScriptInclude(Type, String, String)

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

public:
 void RegisterClientScriptInclude(Type ^ type, System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude (Type type, string key, string url);
member this.RegisterClientScriptInclude : Type * string * string -> unit
Public Sub RegisterClientScriptInclude (type As Type, key As String, url As String)

Paramètres

type
Type

Type du script client Include à inscrire.

key
String

Clé du script client Include à inscrire.

url
String

URL du script client Include à inscrire.

Exceptions

Le type du script client Include est null.

L’URL est null.

  • ou - L'URL est vide.

Exemples

L’exemple de code suivant illustre l’utilisation de la RegisterClientScriptInclude méthode. Notez que si la logique de vérification du script client existant a été supprimée, il n’y aurait toujours pas de scripts clients en double dans la page rendue, car la RegisterClientScriptInclude méthode recherche les doublons. L’avantage de la vérification est de réduire les calculs inutiles.

<%@ 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>
<%@ Page Language="VB" %>

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

<script runat="server">
    
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

        ' Define the name, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        Dim cstype As Type = Me.GetType()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript
    
        ' Check to see if the include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <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.'}  

Remarques

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

Notes

Pour résoudre l’URL du client, utilisez la ResolveClientUrl méthode. Cette méthode utilise le contexte de l’URL sur laquelle il est appelé pour résoudre le chemin d’accès.

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

Voir aussi

S’applique à