ScriptManager.RegisterClientScriptInclude Methode

Definitie

Naamruimte:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Registreert een clientscriptbestand met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.

Overloads

Name	Description
RegisterClientScriptInclude(Control, Type, String, String)	Registreert een clientscriptbestand met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.
RegisterClientScriptInclude(Page, Type, String, String)	Registreert clientscript met het ScriptManager besturingselement telkens wanneer een asynchrone postback plaatsvindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.

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)

Parameters

control: Control

Het besturingselement dat het clientscriptbestand registreert.

type: Type

Het type clientscriptbestand. Deze parameter wordt meestal opgegeven met behulp van de typeof-operator (C#) of de GetType-operator (Visual Basic) om het type besturingselement op te halen dat het script registreert.

key: String

Een unieke id voor het scriptbestand.

url: String

De URL van het scriptbestand.

Uitzonderingen

ArgumentNullException

Het clientscriptbestand type is null.

– of –

Het besturingselement dat het scriptbestand registreert, is null.

ArgumentException

Het besturingselement dat het scriptbestand registreert, bevindt zich niet in de besturingsstructuur van de pagina.

– of –

url is null.

– of –

url is leeg.

Voorbeelden

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

Opmerkingen

U gebruikt de RegisterClientScriptInclude methode om een clientscriptbestand te registreren voor een pagina of een deel van een pagina die deelneemt aan gedeeltelijke pagina-updates. Clientscriptbestanden die zijn geregistreerd met deze methode, worden alleen naar de pagina verzonden wanneer het control een besturingselement vertegenwoordigt dat zich in een UpdatePanel besturingselement bevindt dat wordt bijgewerkt. Als u een scriptbestand wilt registreren telkens wanneer een asynchrone postback plaatsvindt, gebruikt u de RegisterClientScriptInclude(Page, Type, String, String) overbelasting van deze methode.

Als u een scriptblok wilt registreren dat niet betrekking heeft op updates van gedeeltelijke pagina's en als u het scriptblok slechts één keer wilt registreren tijdens de eerste paginaweergave, gebruikt u de RegisterClientScriptBlock methode van de ClientScriptManager klasse. U kunt een verwijzing naar het ClientScriptManager object ophalen uit de ClientScript eigenschap van de pagina.

De RegisterClientScriptInclude methode registreert een clientscriptbestand op de pagina door een script element weer te geven waarvan de tag openen een src kenmerk bevat. De url parameter wordt gebruikt om het src kenmerk in te stellen. Gebruik de methode om URL's op te ResolveClientUrl lossen. Deze methode gebruikt de context van de URL waarvoor het wordt aangeroepen om het pad op te lossen.

Zowel de RegisterClientScriptInclude als RegisterClientScriptResource de methoden geven scriptbestanden weer in de browser. Als een script met hetzelfde type en dezelfde sleutel (voor een scriptbestand) of hetzelfde type en dezelfde resourcenaam (voor een ingesloten resource) al wordt weergegeven, wordt het script niet opnieuw weergegeven.

Zie ook

RegisterClientScriptInclude(Page, Type, String, String)

Van toepassing op

RegisterClientScriptInclude(Page, Type, String, String)

Registreert clientscript met het ScriptManager besturingselement telkens wanneer een asynchrone postback plaatsvindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.

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)

Parameters

page: Page

Het paginaobject dat het clientscriptbestand registreert.

type: Type

key: String

Een unieke id voor het scriptbestand.

url: String

De URL van het scriptbestand.

Uitzonderingen

ArgumentNullException

Het clientscriptbestand type is null.

– of –

De pagina die het scriptbestand registreert, is null.

ArgumentException

url is null.

– of –

url is leeg.

Opmerkingen

Wanneer u een scriptbestand met deze methode registreert, wordt het script telkens weergegeven wanneer een asynchrone postback plaatsvindt. Als u een scriptbestand wilt registreren voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt, zodat het script alleen wordt geregistreerd wanneer het UpdatePanel besturingselement wordt bijgewerkt, gebruikt u de RegisterClientScriptInclude(Control, Type, String, String) overbelasting van deze methode.

Zie ook

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

Van toepassing op

Feedback

Is deze pagina nuttig?