ScriptManager.RegisterClientScriptInclude Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Registrerar en klientskriptfil med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till en skriptfilreferens på sidan.

Överlagringar

Name Description
RegisterClientScriptInclude(Control, Type, String, String)

Registrerar en klientskriptfil med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till en skriptfilreferens på sidan.
RegisterClientScriptInclude(Page, Type, String, String)

Registrerar klientskriptet ScriptManager med kontrollen varje gång en asynkron postback inträffar och lägger sedan till en skriptfilreferens på sidan.

RegisterClientScriptInclude(Control, Type, String, String)

Registrerar en klientskriptfil med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till en skriptfilreferens på sidan.

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)

Parametrar

control
Control

Kontrollen som registrerar klientskriptfilen.

type
Type

Typen av klientskriptfil. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

key
String

En unik identifierare för skriptfilen.

url
String

URL:en för skriptfilen.

Undantag

ArgumentNullException

Klientskriptfilen type är null.

-eller-

Kontrollen som registrerar skriptfilen är null.

ArgumentException

Kontrollen som registrerar skriptfilen finns inte i sidans kontrollträd.

-eller-

url är null.

-eller-

url är tom.

Exempel

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

Kommentarer

Du använder RegisterClientScriptInclude metoden för att registrera en klientskriptfil för en sida eller en del av en sida som deltar i partiella siduppdateringar. Klientskriptfiler som registreras med den här metoden skickas endast till sidan när control representerar en kontroll som finns i en UpdatePanel kontroll som uppdateras. Om du vill registrera en skriptfil varje gång en asynkron postback inträffar använder du överlagringen av den RegisterClientScriptInclude(Page, Type, String, String) här metoden.

Om du vill registrera ett skriptblock som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptblocket en gång under den första sidåtergivningen RegisterClientScriptBlock , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Metoden RegisterClientScriptInclude registrerar en klientskriptfil på sidan genom att återge ett script element vars öppningstagg innehåller ett src attribut. Parametern url används för att ange attributet src . Använd metoden för ResolveClientUrl att lösa URL:er. Den här metoden använder kontexten för den URL som den anropas för för att lösa sökvägen.

Både metoderna RegisterClientScriptInclude och RegisterClientScriptResource renderar skriptfiler till webbläsaren. Om ett skript med samma typ och nyckel (för en skriptfil) eller samma typ och resursnamn (för en inbäddad resurs) redan återges återges inte skriptet igen.

Se även

Gäller för

RegisterClientScriptInclude(Page, Type, String, String)

Registrerar klientskriptet ScriptManager med kontrollen varje gång en asynkron postback inträffar och lägger sedan till en skriptfilreferens på sidan.

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)

Parametrar

page
Page

Det sidobjekt som registrerar klientskriptfilen.

type
Type

Typen av klientskriptfil. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

key
String

En unik identifierare för skriptfilen.

url
String

URL:en för skriptfilen.

Undantag

ArgumentNullException

Klientskriptfilen type är null.

-eller-

Sidan som registrerar skriptfilen är null.

ArgumentException

url är null.

-eller-

url är tom.

Kommentarer

När du registrerar en skriptfil med den här metoden återges skriptet varje gång en asynkron postback sker. Om du vill registrera en skriptfil för en kontroll som finns i en UpdatePanel kontroll så att skriptet endast registreras när UpdatePanel kontrollen uppdateras använder du överlagringen av den RegisterClientScriptInclude(Control, Type, String, String) här metoden.

Om du vill registrera ett skriptblock som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptblocket en gång under den första sidåtergivningen RegisterClientScriptBlock , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Se även

Gäller för