ScriptManager.RegisterClientScriptResource Méthode

  • Référence

Définition

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

Inscrit le script client incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.

Surcharges

RegisterClientScriptResource(Page, Type, String)

Inscrit un fichier de script client incorporé dans un assembly avec le contrôle ScriptManager chaque fois qu'une publication (postback) a lieu.
RegisterClientScriptResource(Control, Type, String)

Inscrit le script client incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.

RegisterClientScriptResource(Page, Type, String)

Inscrit un fichier de script client incorporé dans un assembly avec le contrôle ScriptManager chaque fois qu'une publication (postback) a lieu.

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 page qui inscrit le script.

type
Type

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

resourceName
String

Identificateur pour la ressource.

Exceptions

ArgumentNullException

La ressource cliente type 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’une publication 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 inscrit 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 de pages partielles et si vous souhaitez inscrire le bloc de script une seule fois lors du 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 contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.

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é 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.

resourceName
String

Identificateur pour la ressource.

Exceptions

ArgumentNullException

La ressource cliente type 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 du contrôle de la page.

Remarques

Vous utilisez la RegisterClientScriptResource méthode pour inscrire un script compatible avec le rendu de page partielle 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 se rapporte pas aux 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 à