ScriptManager.RegisterClientScriptInclude Méthode

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Inscrit un fichier de script client auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle, puis ajoute une référence de fichier de script à la page.

Surcharges

Nom	Description
RegisterClientScriptInclude(Control, Type, String, String)	Inscrit un fichier de script client auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle, puis ajoute une référence de fichier de script à la page.
RegisterClientScriptInclude(Page, Type, String, String)	Inscrit le script client auprès du ScriptManager contrôle chaque fois qu’une publication asynchrone se produit, puis ajoute une référence de fichier de script à la page.

RegisterClientScriptInclude(Control, Type, String, String)

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é à l’aide de l’opérateur typeof (C#) ou de l’opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key: String

Identificateur unique du fichier de script.

url: String

URL du fichier de script.

Exceptions

ArgumentNullException

Le fichier type de script client 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 de 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 le control contrôle représente un contrôle à 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 partielles de page et si vous souhaitez inscrire le bloc de script une seule fois pendant le rendu de page initial, 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 qu’elle est appelée pour résoudre le chemin d’accès.

Les méthodes et RegisterClientScriptResource les RegisterClientScriptInclude fichiers de script restituent les 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) sont déjà affichés, le script n’est pas rendu à nouveau.

Voir aussi

RegisterClientScriptInclude(Page, Type, String, String)

S’applique à

RegisterClientScriptInclude(Page, Type, String, String)

Inscrit le script client auprès du ScriptManager contrôle chaque fois qu’une publication asynchrone se produit, 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 de page qui inscrit le fichier de script client.

type: Type

key: String

Identificateur unique du fichier de script.

url: String

URL du fichier de script.

Exceptions

ArgumentNullException

Le fichier type de script client 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’un postback 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 enregistré uniquement lorsque le UpdatePanel contrôle est mis à jour, utilisez la RegisterClientScriptInclude(Control, Type, String, String) surcharge de cette méthode.

Voir aussi

RegisterClientScriptBlock(Control, Type, String, String, Boolean)

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

ScriptManager.RegisterClientScriptInclude Méthode

Définition

Surcharges

RegisterClientScriptInclude(Control, Type, String, String)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

RegisterClientScriptInclude(Page, Type, String, String)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Commentaires