ClientScriptManager.RegisterClientScriptInclude Metódus

Definíció

Névtér:: System.Web.UI

Szerelvény:: System.Web.dll

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.

Regisztrálja az ügyfélszkriptet az Page objektummal együtt.

Túlterhelések

Name	Description
RegisterClientScriptInclude(String, String)	Az ügyfélszkriptet egy kulccsal és EGY URL-címmel regisztrálja az Page objektummal, amely lehetővé teszi a szkript meghívását az ügyféltől.
RegisterClientScriptInclude(Type, String, String)	Az ügyfélszkript típus, kulcs és URL-cím használatával regisztrálja az Page objektumot.

RegisterClientScriptInclude(String, String)

Az ügyfélszkriptet egy kulccsal és EGY URL-címmel regisztrálja az Page objektummal, amely lehetővé teszi a szkript meghívását az ügyféltől.

public:
 void RegisterClientScriptInclude(System::String ^ key, System::String ^ url);

public void RegisterClientScriptInclude(string key, string url);

member this.RegisterClientScriptInclude : string * string -> unit

Public Sub RegisterClientScriptInclude (key As String, url As String)

Paraméterek

key: String

Az ügyfélszkript kulcsa a regisztráció.

url: String

Az ügyfélszkript URL-címe tartalmazza a regisztrációt.

Példák

A kapcsolódó információk, beleértve a szintaxist, a használatot és egy példát, lásd: RegisterClientScriptInclude.

Megjegyzések

Az ügyfélszkripteket a kulcs és a típus egyedileg azonosítja. Az azonos kulccsal és típussal rendelkező szkriptek duplikáltnak minősülnek. A lapon csak egy adott típusú és kulcspárt tartalmazó szkript regisztrálható. Ha már regisztrált szkriptet próbál regisztrálni, az nem hozza létre a szkript másolatát.

Hívja meg a IsClientScriptIncludeRegistered metódust annak megállapításához, hogy egy ügyfélszkript tartalmaz-e már egy adott kulccsal és típuspárt, és ne próbálja meg szükségtelenül hozzáadni a szkriptet.

Note

Az ügyfél URL-címének feloldásához használja a metódust ResolveClientUrl . Ez a metódus annak az URL-címnek a környezetét használja, amelyre meghívják az elérési út feloldásához.

A metódus túlterhelése RegisterClientScriptInclude meghívja a túlterhelést, amely egy key, egy URLés egy paramétert type vesz igénybe.

A metódus egy szkriptblokkot ad hozzá a renderelt oldal tetején.

Lásd még

A következőre érvényes:

RegisterClientScriptInclude(Type, String, String)

Az ügyfélszkript típus, kulcs és URL-cím használatával regisztrálja az Page objektumot.

public:
 void RegisterClientScriptInclude(Type ^ type, System::String ^ key, System::String ^ url);

public void RegisterClientScriptInclude(Type type, string key, string url);

member this.RegisterClientScriptInclude : Type * string * string -> unit

Public Sub RegisterClientScriptInclude (type As Type, key As String, url As String)

Paraméterek

type: Type

Az ügyfélszkript típusa tartalmazza a regisztrációt.

key: String

Az ügyfélszkript kulcsa a regisztráció.

url: String

Az ügyfélszkript URL-címe tartalmazza a regisztrációt.

Kivételek

ArgumentNullException

Az ügyfélszkript tartalmazza a következő típust null: .

ArgumentException

Az URL a következő: null.

-vagy-

Az URL-cím üres.

Példák

Az alábbi példakód a metódus használatát RegisterClientScriptInclude mutatja be. Vegye figyelembe, hogy ha a meglévő ügyfélszkript ellenőrzésére szolgáló logika el lett távolítva, a renderelt lapon továbbra sem lesznek duplikált ügyfélszkriptek, mert a metódus ellenőrzi az RegisterClientScriptInclude ismétlődéseket. Az ellenőrzés előnye a szükségtelen számítások csökkentése.

<%@ 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)
    {
        // Define the name, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

        ' Define the name, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        Dim cstype As Type = Me.GetType()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript
    
        ' Check to see if the include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
</body>
</html>

Ehhez a példához egy Script_include.js nevű JavaScript-fájlra van szükség, amely a következő tartalommal rendelkezik:

function DoClick() {Form1.Message.value='Text from include script.'}

Megjegyzések

A metódus túlterhelése RegisterClientScriptInclude- és URL-paramétereket használ a szkript azonosításához, valamint egy type paramétert, amely megadja az ügyfélszkript azonosítóját. Az erőforráshoz hozzáférő objektum alapján adja meg a típust. Ha például egy Page példányt használ az erőforrás eléréséhez, meg kell adnia a típust Page .

Note

Az ügyfél URL-címének feloldásához használja a metódust ResolveClientUrl . Ez a metódus annak az URL-címnek a környezetét használja, amelyre meghívják az elérési út feloldásához.

Ez a metódus egy szkriptblokkot ad hozzá a renderelt oldal tetején.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?