ClientScriptManager Klas

Definitie

Naamruimte:: System.Web.UI

Assembly:: System.Web.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.

Definieert methoden voor het beheren van clientscripts in webtoepassingen.

public ref class ClientScriptManager sealed

public sealed class ClientScriptManager

type ClientScriptManager = class

Public NotInheritable Class ClientScriptManager

Overname: Object
ClientScriptManager

Voorbeelden

In het volgende codevoorbeeld ziet u hoe de RegisterClientScriptBlock methode van de ClientScriptManager klasse wordt gebruikt. Er worden twee clientscripts gedefinieerd op de pagina: PopupScript, waarin een waarschuwingsbericht wordt weergegeven wanneer de pagina wordt geladen en ButtonClickScript, waarmee een clienthandler wordt gedefinieerd voor de gebeurtenis van onClick een HTML-knop.

<%@ 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 and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 and type of the client scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
      cs.RegisterStartupScript(cstype, csname1, cstext1, True)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), False)
      
    End If
    
  End Sub
  
</script>

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

Opmerkingen

De ClientScriptManager klasse wordt gebruikt om clientscripts te beheren en toe te voegen aan webtoepassingen. U kunt een verwijzing naar de ClientScriptManager klasse ophalen uit de ClientScript eigenschap van het Page object.

U kunt een clientscript declaratief toevoegen aan een webpagina door het script op te geven in de HTML-opmaak van de pagina. Er zijn echter situaties waarin het dynamisch toevoegen van clientscripts nodig is. Als u dynamisch een script wilt toevoegen, gebruikt u de RegisterClientScriptBlock methode, de RegisterClientScriptInclude methode, de RegisterStartupScript methode of de RegisterOnSubmitStatement methode, afhankelijk van wanneer en hoe u het script wilt toevoegen. Zie Hoe to: Clientscript dynamisch toevoegen aan ASP.NET webpagina's voor meer informatie.

De ClientScriptManager klasse identificeert scripts op unieke wijze door een sleutel String en een Type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten. Als u het scripttype gebruikt, voorkomt u verwarrende vergelijkbare scripts van verschillende gebruikersbesturingselementen die mogelijk op de pagina worden gebruikt.

De ClientScriptManager klasse kan worden gebruikt om callbacks van clients aan te roepen in situaties waarin het wenselijk is om servercode van de client uit te voeren zonder een postback uit te voeren. Dit wordt een out-of-band callback naar de server genoemd. In een client callback verzendt een clientscriptfunctie een asynchrone aanvraag naar een ASP.NET webpagina. De webpagina voert een gewijzigde versie van de normale levenscyclus uit om de callback te verwerken. Gebruik de GetCallbackEventReference methode om een verwijzing te verkrijgen naar een clientfunctie die, wanneer deze wordt aangeroepen, een client-callback naar een servergebeurtenis initieert. Zie Client callbacks zonder postbacks implementeren voor meer informatie.

Note

Script callbacks werken niet in oudere browsers die geen ondersteuning bieden voor het Document Object Model (DOM) en ze vereisen dat ECMAScript is ingeschakeld op de client. Als u wilt controleren of de browser callbacks ondersteunt, gebruikt u de eigenschap SupportsCallback, die toegankelijk is via de eigenschap Browser van het ASP.NET intrinsieke Request-object.

Gebruik de GetPostBackEventReference methode en de GetPostBackClientHyperlink methode om een client-postback-gebeurtenis te definiëren. Met deze methoden kunnen clientscriptfuncties, wanneer deze worden aangeroepen, ertoe leiden dat de server wordt teruggezet naar de pagina. Een client-postback-gebeurtenis verschilt van een client-callback omdat de webpagina een normale levenscyclus heeft voltooid om de clientback-gebeurtenis te verwerken.

Note

Als u een Button besturingselement gebruikt en de UseSubmitBehavior eigenschap is ingesteld op false, kunt u de GetPostBackEventReference methode gebruiken om de client-postback-gebeurtenis voor het Button besturingselement te retourneren.

De OnClientClick eigenschap van het besturingselement, ImageButton besturingselement Button en LinkButton besturingselement kan worden gebruikt om clientscripts uit te voeren.

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetCallbackEventReference(Control, String, String, String, Boolean)	Haalt een verwijzing op naar een clientfunctie die, wanneer deze wordt aangeroepen, een clientoproep naar servergebeurtenissen start. De clientfunctie voor deze overbelaste methode bevat een opgegeven besturingselement, argument, clientscript, context en Booleaanse waarde.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Haalt een verwijzing op naar een clientfunctie die, wanneer deze wordt aangeroepen, een clientoproep naar servergebeurtenissen start. De clientfunctie voor deze overbelaste methode bevat een opgegeven besturingselement, argument, clientscript, context, fouthandler en Booleaanse waarde.
GetCallbackEventReference(Control, String, String, String)	Haalt een verwijzing op naar een clientfunctie die, wanneer deze wordt aangeroepen, een clientoproep naar een servergebeurtenis start. De clientfunctie voor deze overbelaste methode bevat een opgegeven besturingselement, argument, clientscript en context.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Haalt een verwijzing op naar een clientfunctie die, wanneer deze wordt aangeroepen, een clientoproep naar servergebeurtenissen start. De clientfunctie voor deze overbelaste methode bevat een opgegeven doel, argument, clientscript, context, fouthandler en Booleaanse waarde.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetPostBackClientHyperlink(Control, String, Boolean)	Hiermee haalt u een verwijzing op, waaraan `javascript:` het begin ervan is toegevoegd, die kan worden gebruikt in een clientgebeurtenis om terug te plaatsen naar de server voor het opgegeven besturingselement met de opgegeven gebeurtenisargumenten en Booleaanse indicatie of de postback moet worden geregistreerd voor gebeurtenisvalidatie.
GetPostBackClientHyperlink(Control, String)	Hiermee haalt u een verwijzing op, waaraan `javascript:` het begin ervan is toegevoegd, die kan worden gebruikt in een clientgebeurtenis om terug te plaatsen naar de server voor het opgegeven besturingselement en met de opgegeven gebeurtenisargumenten.
GetPostBackEventReference(Control, String, Boolean)	Retourneert een tekenreeks die moet worden gebruikt in een client gebeurtenis om terug te zetten naar de server. De referentietekenreeks wordt gedefinieerd door het opgegeven besturingselement dat de postback verwerkt en een tekenreeksargument van aanvullende gebeurtenisgegevens. Optioneel registreert u de gebeurtenisreferentie voor validatie.
GetPostBackEventReference(Control, String)	Retourneert een tekenreeks die kan worden gebruikt in een client gebeurtenis om terugzending naar de server te veroorzaken. De referentietekenreeks wordt gedefinieerd door het opgegeven besturingselement dat de postback verwerkt en een tekenreeksargument van aanvullende gebeurtenisgegevens.
GetPostBackEventReference(PostBackOptions, Boolean)	Retourneert een tekenreeks die kan worden gebruikt in een client gebeurtenis om terugzending naar de server te veroorzaken. De referentietekenreeks wordt gedefinieerd door het opgegeven PostBackOptions object. Optioneel registreert u de gebeurtenisreferentie voor validatie.
GetPostBackEventReference(PostBackOptions)	Retourneert een tekenreeks die kan worden gebruikt in een client gebeurtenis om terugzending naar de server te veroorzaken. De referentietekenreeks wordt gedefinieerd door het opgegeven PostBackOptions exemplaar.
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetWebResourceUrl(Type, String)	Haalt een URL-verwijzing op naar een resource in een assembly.
IsClientScriptBlockRegistered(String)	Bepaalt of het clientscriptblok is geregistreerd bij het Page object met behulp van de opgegeven sleutel.
IsClientScriptBlockRegistered(Type, String)	Bepaalt of het clientscriptblok is geregistreerd bij het Page object met behulp van een sleutel en type.
IsClientScriptIncludeRegistered(String)	Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel.
IsClientScriptIncludeRegistered(Type, String)	Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van een sleutel en type.
IsOnSubmitStatementRegistered(String)	Bepaalt of de OnSubmit-instructie is geregistreerd bij het Page object met behulp van de opgegeven sleutel.
IsOnSubmitStatementRegistered(Type, String)	Bepaalt of de OnSubmit-instructie is geregistreerd bij het Page object met behulp van de opgegeven sleutel en het opgegeven type.
IsStartupScriptRegistered(String)	Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel.
IsStartupScriptRegistered(Type, String)	Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel en het opgegeven type.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
RegisterArrayDeclaration(String, String)	Registreert een JavaScript-matrixdeclaratie met het Page object met behulp van een matrixnaam en matrixwaarde.
RegisterClientScriptBlock(Type, String, String, Boolean)	Registreert het clientscript bij het Page object met behulp van een type, sleutel, letterlijk script en Booleaanse waarde die aangeeft of scripttags moeten worden toegevoegd.
RegisterClientScriptBlock(Type, String, String)	Registreert het clientscript met het Page object met behulp van een type, sleutel en letterlijk script.
RegisterClientScriptInclude(String, String)	Registreert het clientscript met het Page object met behulp van een sleutel en een URL, waarmee het script kan worden aangeroepen vanaf de client.
RegisterClientScriptInclude(Type, String, String)	Registreert het clientscript met het Page object met behulp van een type, een sleutel en een URL.
RegisterClientScriptResource(Type, String)	Registreert de clientscriptresource met het Page object met behulp van een type en een resourcenaam.
RegisterExpandoAttribute(String, String, String, Boolean)	Registreert een naam/waardepaar als een aangepast (expando) kenmerk van het opgegeven besturingselement op basis van een besturingselement-id, een kenmerknaam, een kenmerkwaarde en een Booleaanse waarde die aangeeft of de kenmerkwaarde moet worden gecodeerd.
RegisterExpandoAttribute(String, String, String)	Registreert een naam/waardepaar als een aangepast (expando)-kenmerk van het opgegeven besturingselement op basis van een besturingselement-id, kenmerknaam en kenmerkwaarde.
RegisterForEventValidation(PostBackOptions)	Registreert een gebeurtenisreferentie voor validatie met PostBackOptions.
RegisterForEventValidation(String, String)	Registreert een gebeurtenisverwijzing voor validatie met een unieke besturings-id en gebeurtenisargumenten die het clientbeheer vertegenwoordigen dat de gebeurtenis genereert.
RegisterForEventValidation(String)	Registreert een gebeurtenisverwijzing voor validatie met een unieke besturings-id die het clientbeheer vertegenwoordigt dat de gebeurtenis genereert.
RegisterHiddenField(String, String)	Registreert een verborgen waarde bij het Page object.
RegisterOnSubmitStatement(Type, String, String)	Registreert een OnSubmit-instructie bij het Page object met behulp van een type, een sleutel en een letterlijke script. De instructie wordt uitgevoerd wanneer de HtmlForm aanvraag is ingediend.
RegisterStartupScript(Type, String, String, Boolean)	Registreert het opstartscript bij het Page object met behulp van een type, een sleutel, een letterlijk script en een Booleaanse waarde die aangeeft of er scripttags moeten worden toegevoegd.
RegisterStartupScript(Type, String, String)	Registreert het opstartscript bij het Page object met behulp van een type, een sleutel en een letterlijk script.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
ValidateEvent(String, String)	Valideert een clientgebeurtenis die is geregistreerd voor gebeurtenisvalidatie met behulp van de RegisterForEventValidation(String, String) methode.
ValidateEvent(String)	Valideert een clientgebeurtenis die is geregistreerd voor gebeurtenisvalidatie met behulp van de RegisterForEventValidation(String) methode.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?