ScriptManager.RegisterClientScriptInclude Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Inscrit un fichier de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute une référence de fichier de script à la page.

Surcharges

RegisterClientScriptInclude(Control, Type, String, String)

Inscrit un fichier de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute une référence de fichier de script à la page.
RegisterClientScriptInclude(Page, Type, String, String)

Inscrit le script client avec le contrôle ScriptManager chaque fois qu'une publication (postback) asynchrone a lieu, puis ajoute une référence de fichier de script à la page.

RegisterClientScriptInclude(Control, Type, String, String)

Inscrit un fichier de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute une référence de fichier de script à la page.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Control control, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Control * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (control As Control, type As Type, key As String, url As String)

Paramètres

control
Control

Contrôle qui inscrit le fichier de script client.

type
Type

Type du fichier de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key
String

Identificateur unique pour le fichier de script.

url
String

URL du fichier de script.

Exceptions

ArgumentNullException

Le fichier de script client type est null.

- ou -

Le contrôle qui inscrit le fichier de script est null.

ArgumentException

Le contrôle qui inscrit le fichier de script n'est pas dans l'arborescence du contrôle de la page.

- ou -

url a la valeur null.

- ou -

url est vide.

Exemples

<%@ 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)
    {
        if (!IsPostBack)
            Calendar1.SelectedDate = DateTime.Today;
        
    }
    protected void Page_PreRender(object sender, EventArgs e)
    {
        ScriptManager.RegisterClientScriptInclude(
            this,
            typeof(Page),
            "AlertScript",
            ResolveClientUrl("~/scripts/script_alertdiv.js"));
    }
    protected void IncrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(1.0);
    }
    protected void DecrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(-1.0);
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterClientScriptInclude</title>
    <style type="text/css">
    div.MessageStyle
    {
      background-color: Green;
      top: 95%;
      left: 1%;
      position: absolute;
      visibility: hidden;
    }
    </style>
</head>
<body>
    <form id="Form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server"/>

            <script type="text/javascript">
            Sys.WebForms.PageRequestManager.instance.add_endRequest(Notify);
            </script>

            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional"
                runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" runat="server"/>
                    <br />
                    Change the selected date: 
                    <asp:Button runat="server" ID="DecrementButton" Text="-" OnClick="DecrementButton_Click" />
                    <asp:Button runat="server" ID="IncrementButton" Text="+" OnClick="IncrementButton_Click" />
                </ContentTemplate>
            </asp:UpdatePanel>

            <div id="NotifyDiv" class="MessageStyle">
                Updates are complete.
            </div>
        </div>
    </form>
</body>
</html>

function Notify(sender, arg)
{
    ActivateAlertDiv('visible', 'NotifyDiv');
    setTimeout("ActivateAlertDiv('hidden', 'NotifyDiv')", 1000);
}
function ActivateAlertDiv(visstring, elem)
{
    var adiv = document.getElementById(elem);
    adiv.style.visibility = visstring;
}

Remarques

Vous utilisez la RegisterClientScriptInclude méthode pour inscrire un fichier de script client pour une page ou une partie d’une page qui participe à des mises à jour partielles de page. Les fichiers de script client inscrits à l’aide de cette méthode sont envoyés à la page uniquement lorsque représente control un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle en cours de mise à jour. Pour inscrire un fichier de script chaque fois qu’une publication asynchrone se produit, utilisez la RegisterClientScriptInclude(Page, Type, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire un bloc de script qui ne concerne pas les mises à jour de page partielles et si vous souhaitez inscrire le bloc de script une seule fois pendant le rendu initial de la page, utilisez la RegisterClientScriptBlock méthode de la ClientScriptManager classe . Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

La RegisterClientScriptInclude méthode inscrit un fichier de script client sur la page en rendant un script élément dont la balise d’ouverture contient un src attribut. Le url paramètre est utilisé pour définir l’attribut src . Pour résoudre les URL, utilisez la ResolveClientUrl méthode . Cette méthode utilise le contexte de l’URL pour laquelle elle est appelée pour résoudre le chemin d’accès.

Les méthodes et RegisterClientScriptResource restituent les RegisterClientScriptInclude fichiers de script dans le navigateur. Si un script avec le même type et la même clé (pour un fichier de script) ou le même type et le même nom de ressource (pour une ressource incorporée) est déjà rendu, le script n’est pas rendu à nouveau.

Voir aussi

S’applique à

RegisterClientScriptInclude(Page, Type, String, String)

Inscrit le script client avec le contrôle ScriptManager chaque fois qu'une publication (postback) asynchrone a lieu, puis ajoute une référence de fichier de script à la page.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Page page, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Page * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (page As Page, type As Type, key As String, url As String)

Paramètres

page
Page

Objet page qui inscrit le fichier de script client.

type
Type

Type du fichier de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key
String

Identificateur unique pour le fichier de script.

url
String

URL du fichier de script.

Exceptions

ArgumentNullException

Le fichier de script client type est null.

- ou -

La page qui inscrit le fichier de script est null.

ArgumentException

url a la valeur null.

- ou -

url est vide.

Remarques

Lorsque vous inscrivez un fichier de script avec cette méthode, le script est rendu chaque fois qu’une publication asynchrone se produit. Pour inscrire un fichier de script pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle afin que le script soit inscrit uniquement lorsque le UpdatePanel contrôle est mis à jour, utilisez la RegisterClientScriptInclude(Control, Type, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire un bloc de script qui ne concerne pas les mises à jour de page partielles et si vous souhaitez inscrire le bloc de script une seule fois pendant le rendu initial de la page, utilisez la RegisterClientScriptBlock méthode de la ClientScriptManager classe . Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Voir aussi

S’applique à