ScriptManager.RegisterClientScriptInclude Metódus

Definíció

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

Szerelvény:: System.Web.Extensions.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ál egy ügyfélszkriptfájlt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.

Túlterhelések

Name	Description
RegisterClientScriptInclude(Control, Type, String, String)	Regisztrál egy ügyfélszkriptfájlt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.
RegisterClientScriptInclude(Page, Type, String, String)	Minden alkalommal regisztrálja az ügyfélszkriptet a ScriptManager vezérlővel, amikor aszinkron utólagos visszaállítás történik, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.

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

control: Control

Az ügyfélszkriptfájlt regisztráló vezérlő.

type: Type

Az ügyfélszkriptfájl 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.

key: String

A szkriptfájl egyedi azonosítója.

url: String

A szkriptfájl URL-címe.

Kivételek

ArgumentNullException

Az ügyfélszkriptfájl type a következő null: .

-vagy-

A szkriptfájlt regisztráló vezérlő a következő null: .

ArgumentException

A szkriptfájlt regisztráló vezérlő nem szerepel a lap vezérlőfán.

-vagy-

url az null.

-vagy-

url üres.

Példák

<%@ 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;
}

Megjegyzések

Ezzel a RegisterClientScriptInclude módszerrel ügyfélszkriptfájlt regisztrálhat a részleges oldalfrissítésekben részt vevő lap vagy oldal egy részének. Az ezzel a módszerrel regisztrált ügyfélszkriptfájlokat a rendszer csak akkor küldi el a lapra, ha a control vezérlő egy UpdatePanel frissített vezérlőn belül található. Ha minden alkalommal regisztrálni szeretne egy szkriptfájlt, amikor aszinkron visszavétel történik, használja a RegisterClientScriptInclude(Page, Type, String, 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 RegisterClientScriptBlock ClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManager ClientScript oldal tulajdonságából kaphatja meg.

A RegisterClientScriptInclude metódus egy ügyfélszkriptfájlt regisztrál a lapon egy script olyan elem renderelésével, amelynek nyitócímkéje attribútumot src tartalmaz. A url paraméter az attribútum beállítására src szolgál. Az URL-címek feloldásához használja a metódust ResolveClientUrl . Ez a metódus az elérési út feloldásához szükséges URL-cím kontextusát használja.

A szkriptfájlokat mind RegisterClientScriptInclude a metódusok, mind a RegisterClientScriptResource metódusok a böngészőbe renderelik. Ha már renderelt egy azonos típusú és kulccsal rendelkező szkriptet (szkriptfájl esetén), vagy ugyanazzal a típussal és erőforrásnévvel (beágyazott erőforrás esetén), a szkript nem jelenik meg újra.

Lásd még

RegisterClientScriptInclude(Page, Type, String, String)

A következőre érvényes:

RegisterClientScriptInclude(Page, Type, String, String)

Minden alkalommal regisztrálja az ügyfélszkriptet a ScriptManager vezérlővel, amikor aszinkron utólagos visszaállítás történik, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.

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

page: Page

Az ügyfélszkriptfájlt regisztráló lapobjektum.

type: Type

key: String

A szkriptfájl egyedi azonosítója.

url: String

A szkriptfájl URL-címe.

Kivételek

ArgumentNullException

Az ügyfélszkriptfájl type a következő null: .

-vagy-

A szkriptfájlt regisztráló lap a következő null: .

ArgumentException

url az null.

-vagy-

url üres.

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 szkriptfájlt regisztrálni, hogy a szkript csak a UpdatePanel vezérlő frissítésekor legyen regisztrálva, használja a RegisterClientScriptInclude(Control, Type, String, String) metódus túlterhelését.

Lásd még

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

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?