Partager via

ScriptManager.RegisterClientScriptResource Méthode

Définition

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

Inscrit le script client incorporé dans un assembly avec le ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle.

Surcharges

Nom Description
RegisterClientScriptResource(Page, Type, String)

Inscrit un fichier de script client incorporé dans un assembly avec le ScriptManager contrôle chaque fois qu’un postback se produit.
RegisterClientScriptResource(Control, Type, String)

Inscrit le script client incorporé dans un assembly avec le ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle.

RegisterClientScriptResource(Page, Type, String)

Inscrit un fichier de script client incorporé dans un assembly avec le ScriptManager contrôle chaque fois qu’un postback se produit.

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

Paramètres

page
Page

Objet de page qui inscrit le script.

type
Type

Type du 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.

resourceName
String

Identificateur de la ressource.

Exceptions

ArgumentNullException

La ressource type cliente est null.

- ou -

La page qui inscrit le script est null.

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 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 RegisterClientScriptResource(Control, Type, 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.

Voir aussi

S’applique à

RegisterClientScriptResource(Control, Type, String)

Inscrit le script client incorporé dans un assembly avec le ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle.

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

Paramètres

control
Control

Contrôle qui inscrit le script.

type
Type

Type du 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.

resourceName
String

Identificateur de la ressource.

Exceptions

ArgumentNullException

La ressource type cliente est null.

- ou -

Le contrôle qui inscrit le script est null.

ArgumentException

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

Remarques

Vous utilisez la RegisterClientScriptResource méthode pour inscrire un script compatible avec le rendu de pages partielles et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Les ressources de script inscrites à l’aide de cette méthode sont enregistrées uniquement lorsque control représente un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle mis à jour. Pour inscrire un script chaque fois qu’une publication asynchrone se produit, utilisez la RegisterStartupScript(Page, Type, String, String, Boolean) 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 RegisterClientScriptResource méthode est utilisée lorsque des ressources provenant d’assemblys sont accessibles via un gestionnaire HTTP. Cette méthode inclut le contenu de l’URL de ressource dans un script élément.

Les fichiers de script et la RegisterClientScriptResource méthode chargent 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) sont déjà chargés, le script n’est pas rechargé.

Voir aussi

S’applique à