ScriptManager.RegisterClientScriptResource Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Egy szerelvénybe beágyazott ügyfélszkript regisztrálása a ScriptManager részbenoldalas megjelenítésben részt vevő vezérlővel való használatra.
Túlterhelések
| Name | Description |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Regisztrál egy olyan ügyfélszkriptfájlt, amely egy szerelvénybe van ágyazva, minden alkalommal, ScriptManager amikor a visszavétel történik. |
| RegisterClientScriptResource(Control, Type, String) |
Regisztrálja a szerelvénybe ágyazott ügyfélszkriptet a ScriptManager részbenoldalas megjelenítésben részt vevő vezérlővel való használatra. |
RegisterClientScriptResource(Page, Type, String)
Regisztrál egy olyan ügyfélszkriptfájlt, amely egy szerelvénybe van ágyazva, minden alkalommal, ScriptManager amikor a visszavétel történik.
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 -> unitPublic Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)Paraméterek
- page
- Page
A szkriptet regisztráló lapobjektum.
- type
- Type
Az ügyfélszkript típusa. Ezt a paramétert általában a typeof operátor (C#) vagy a GetType operátor (Visual Basic) használatával adhatja meg a szkriptet regisztráló vezérlő típusának lekéréséhez.
- resourceName
- String
Az erőforrás azonosítója.
Kivételek
Az ügyfélerőforrás type a következő null: .
-vagy-
A szkriptet regisztráló lap az null.
Megjegyzések
Amikor ezzel a módszerrel regisztrál egy szkriptfájlt, a szkript minden alkalommal renderel, amikor aszinkron utólagos visszaállítás történik. Ha egy vezérlőn belüli UpdatePanel vezérlőelemhez szeretne szkriptet regisztrálni, hogy a szkript csak a UpdatePanel vezérlő frissítésekor legyen regisztrálva, használja a RegisterClientScriptResource(Control, Type, String) metódus túlterhelését.
Ha olyan szkriptblokkot szeretne regisztrálni, amely nem vonatkozik részleges oldalfrissítésre, és a szkriptblokkot csak egyszer szeretné regisztrálni a kezdeti lapmegjelenítés során, használja az RegisterClientScriptBlockClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.
Lásd még
A következőre érvényes:
RegisterClientScriptResource(Control, Type, String)
Regisztrálja a szerelvénybe ágyazott ügyfélszkriptet a ScriptManager részbenoldalas megjelenítésben részt vevő vezérlővel való használatra.
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 -> unitPublic Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)Paraméterek
- control
- Control
A szkriptet regisztráló vezérlő.
- type
- Type
Az ügyfélszkript típusa. Ezt a paramétert általában a typeof operátor (C#) vagy a GetType operátor (Visual Basic) használatával adhatja meg a szkriptet regisztráló vezérlő típusának lekéréséhez.
- resourceName
- String
Az erőforrás azonosítója.
Kivételek
Az ügyfélerőforrás type a következő null: .
-vagy-
A szkriptet regisztráló vezérlő az null.
A szkriptet regisztráló vezérlő nem szerepel a lap vezérlőfán.
Megjegyzések
A RegisterClientScriptResource metódussal olyan szkriptet regisztrálhat, amely kompatibilis a részleges oldalmegjelenítéssel, és amely nem rendelkezik Microsoft Ajax-kódtár-függőségekkel. Az ezzel a módszerrel regisztrált szkripterőforrások csak akkor lesznek regisztrálva, ha control egy frissített vezérlőn belüli UpdatePanel vezérlőt jelölnek. Ha minden alkalommal regisztrálni szeretne egy szkriptet, amikor aszinkron visszavétel történik, használja ennek a metódusnak a RegisterStartupScript(Page, Type, String, String, Boolean) túlterhelését.
Ha olyan szkriptblokkot szeretne regisztrálni, amely nem vonatkozik részleges oldalfrissítésre, és a szkriptblokkot csak egyszer szeretné regisztrálni a kezdeti lapmegjelenítés során, használja az RegisterClientScriptBlockClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.
Ezt RegisterClientScriptResource a módszert akkor használja a rendszer, ha a szerelvényekből származó erőforrások egy HTTP-kezelőn keresztül érhetők el. Ez a metódus tartalmazza az erőforrás URL-címének tartalmát egy script elemben.
A szkriptfájlokat a metódus és a RegisterClientScriptIncludeRegisterClientScriptResource metódus is betölti a böngészőbe. Ha egy azonos típusú és kulccsal rendelkező szkript (szkriptfájl esetén) vagy ugyanazzal a típussal és erőforrásnévvel (beágyazott erőforrás esetén) már be van töltve, a szkript nem töltődik be újra.
