ClientScriptManager Class

Definition

Definisce i metodi per la gestione di script client nelle applicazioni Web.Defines methods for managing client scripts in Web applications.

public ref class ClientScriptManager sealed
public sealed class ClientScriptManager
type ClientScriptManager = class
Public NotInheritable Class ClientScriptManager
Inheritance
ClientScriptManager

Examples

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo RegisterClientScriptBlock della classe ClientScriptManager.The following code example demonstrates the use of the RegisterClientScriptBlock method of the ClientScriptManager class. Nella pagina sono definiti due script client: PopupScript, che visualizza un messaggio di avviso quando viene caricata la pagina e ButtonClickScript, che definisce un gestore client per l'evento onClick di un pulsante HTML.Two client scripts are defined in the page: PopupScript, which displays an alert message when the page is loaded, and ButtonClickScript, which defines a client handler for an HTML button's onClick event.

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

Remarks

La classe ClientScriptManager viene utilizzata per gestire gli script client e aggiungerli alle applicazioni Web.The ClientScriptManager class is used to manage client scripts and add them to Web applications. È possibile ottenere un riferimento alla classe ClientScriptManager dalla proprietà ClientScript dell'oggetto Page.You can get a reference to the ClientScriptManager class from the ClientScript property of the Page object.

È possibile aggiungere uno script client a una pagina Web in modo dichiarativo includendo lo script nel markup HTML della pagina.You can add a client script to a Web page declaratively by including the script in the HTML markup of the page. In alcune situazioni, tuttavia, è necessario aggiungere lo script client in modo dinamico.However, there are situations when adding client script dynamically is needed. Per aggiungere uno script in modo dinamico, usare il metodo RegisterClientScriptBlock, il metodo RegisterClientScriptInclude, il metodo RegisterStartupScript o il metodo RegisterOnSubmitStatement, a seconda di quando e come si vuole aggiungere lo script.To add a script dynamically, use the RegisterClientScriptBlock method, the RegisterClientScriptInclude method, the RegisterStartupScript method, or the RegisterOnSubmitStatement method, depending on when and how you want to add the script. Per altre informazioni, vedere procedura: aggiungere script client in modo dinamico a pagine Web ASP.NET.For more information, see How to: Add Client Script Dynamically to ASP.NET Web Pages.

La classe ClientScriptManager identifica in modo univoco gli script in base a una chiave String e a un Type.The ClientScriptManager class uniquely identifies scripts by a key String and a Type. Gli script con la stessa chiave e tipo sono considerati duplicati.Scripts with the same key and type are considered duplicates. L'utilizzo del tipo di script consente di evitare confusione di script simili di diversi controlli utente che potrebbero essere in uso nella pagina.Using the script type helps to avoid confusing similar scripts from different user controls that might be in use on the page.

È possibile utilizzare la classe ClientScriptManager per richiamare callback client in situazioni in cui è consigliabile eseguire codice server dal client senza eseguire un postback.The ClientScriptManager class can be used to invoke client callbacks in situations when it is desirable to run server code from the client without performing a postback. Questa operazione viene definita esecuzione di un callback fuori banda al server.This is referred to as performing an out-of-band callback to the server. In un callback client una funzione script client invia una richiesta asincrona a una pagina Web ASP.NET.In a client callback, a client script function sends an asynchronous request to an ASP.NET Web page. La pagina Web esegue una versione modificata del ciclo di vita normale per elaborare il callback.The Web page runs a modified version of its normal life cycle to process the callback. Utilizzare il metodo GetCallbackEventReference per ottenere un riferimento a una funzione client che, quando richiamata, avvia un callback client a un evento del server.Use the GetCallbackEventReference method to obtain a reference to a client function that, when invoked, initiates a client callback to a server event. Per altre informazioni, vedere implementazione di callback client senza postback.For more information, see Implementing Client Callbacks Without Postbacks.

Note

I callback di script non funzioneranno nei browser meno recenti che non supportano la Document Object Model (DOM) e richiedono che ECMAScript sia abilitato nel client.Script callbacks will not work in older browsers that do not support the Document Object Model (DOM), and they require that ECMAScript is enabled on the client. Per verificare se il browser supporta i callback, utilizzare la proprietà SupportsCallback, accessibile tramite la proprietà Browser dell'oggetto Request intrinseco ASP.NET.To check if the browser supports callbacks, use the SupportsCallback property, which is accessible through the Browser property of the ASP.NET intrinsic Request object.

Usare il metodo GetPostBackEventReference e il metodo GetPostBackClientHyperlink per definire un evento di postback del client.Use the GetPostBackEventReference method and the GetPostBackClientHyperlink method to define a client postback event. Questi metodi abilitano le funzioni di script client, quando richiamate, per fare in modo che il server invii nuovamente la pagina.These methods enable client script functions, when invoked, to cause the server to post back to the page. Un evento di postback del client è diverso da un callback client perché la pagina Web completa un normale ciclo di vita per elaborare l'evento di postback del client.A client postback event is different from a client callback in that the Web page completes a normal life cycle to process the client postback event.

Note

Se si usa un controllo Button e la proprietà UseSubmitBehavior è impostata su false, è possibile usare il metodo GetPostBackEventReference per restituire l'evento di postback del client per il controllo Button.If you are using a Button control and the UseSubmitBehavior property is set to false, then you can use the GetPostBackEventReference method to return the client postback event for the Button control.

Per eseguire lo script client, è possibile usare la proprietà OnClientClick del controllo Button, del controllo ImageButton e del controllo LinkButton.The OnClientClick property of the Button control, ImageButton control, and LinkButton control can be used to run client script.

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCallbackEventReference(Control, String, String, String)

Ottiene un riferimento a una funzione client che, quando richiamata, avvia un callback client a un evento server.Obtains a reference to a client function that, when invoked, initiates a client call back to a server event. La funzione client per questo metodo di overload include un controllo, un argomento, uno script client e un contesto specificati.The client function for this overloaded method includes a specified control, argument, client script, and context.

GetCallbackEventReference(Control, String, String, String, Boolean)

Ottiene un riferimento a una funzione client che, quando richiamata, avvia un callback client agli eventi server.Obtains a reference to a client function that, when invoked, initiates a client call back to server events. La funzione client per questo metodo di overload include un controllo, un argomento, uno script client, un contesto e un valore Boolean specificati.The client function for this overloaded method includes a specified control, argument, client script, context, and Boolean value.

GetCallbackEventReference(Control, String, String, String, String, Boolean)

Ottiene un riferimento a una funzione client che, quando richiamata, avvia un callback client agli eventi server.Obtains a reference to a client function that, when invoked, initiates a client call back to server events. La funzione client per questo metodo di overload include un controllo, un argomento, uno script client, un contesto, un gestore errori e un valore Boolean specificati.The client function for this overloaded method includes a specified control, argument, client script, context, error handler, and Boolean value.

GetCallbackEventReference(String, String, String, String, String, Boolean)

Ottiene un riferimento a una funzione client che, quando richiamata, avvia un callback client agli eventi server.Obtains a reference to a client function that, when invoked, initiates a client call back to server events. La funzione client per questo metodo di overload include una destinazione, un argomento, uno script client, un contesto, un gestore errori e un valore Boolean specificati.The client function for this overloaded method includes a specified target, argument, client script, context, error handler, and Boolean value.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetPostBackClientHyperlink(Control, String)

Ottiene un riferimento, all'inizio del quale viene aggiunto javascript:, utilizzabile in un evento client per eseguire il postback nel server per il controllo specificato e con gli argomenti dell'evento specificati.Gets a reference, with javascript: appended to the beginning of it, that can be used in a client event to post back to the server for the specified control and with the specified event arguments.

GetPostBackClientHyperlink(Control, String, Boolean)

Ottiene un riferimento, all'inizio del quale viene aggiunto javascript:, utilizzabile in un evento client per eseguire il postback nel server per il controllo specificato con gli argomenti dell'evento specificati e un valore booleano che indica se registrare o meno il postback per la convalida dell'evento.Gets a reference, with javascript: appended to the beginning of it, that can be used in a client event to post back to the server for the specified control with the specified event arguments and Boolean indication whether to register the post back for event validation.

GetPostBackEventReference(Control, String)

Restituisce una stringa utilizzabile in un evento client per causare il postback nel server.Returns a string that can be used in a client event to cause postback to the server. La stringa del riferimento è definita dal controllo specificato che gestisce il postback e da un argomento stringa contenente informazioni aggiuntive sull'evento.The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

GetPostBackEventReference(Control, String, Boolean)

Restituisce una stringa utilizzabile in un evento client per causare il postback nel server.Returns a string to use in a client event to cause postback to the server. La stringa del riferimento è definita dal controllo specificato che gestisce il postback e da un argomento stringa contenente informazioni aggiuntive sull'evento.The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Facoltativamente, registra un riferimento all'evento per la convalida.Optionally, registers the event reference for validation.

GetPostBackEventReference(PostBackOptions)

Restituisce una stringa utilizzabile in un evento client per causare il postback nel server.Returns a string that can be used in a client event to cause postback to the server. La stringa del riferimento è definita dall'istanza PostBackOptions specificata.The reference string is defined by the specified PostBackOptions instance.

GetPostBackEventReference(PostBackOptions, Boolean)

Restituisce una stringa utilizzabile in un evento client per causare il postback nel server.Returns a string that can be used in a client event to cause postback to the server. La stringa di riferimento è definita dall'oggetto PostBackOptions specificato.The reference string is defined by the specified PostBackOptions object. Facoltativamente, registra un riferimento all'evento per la convalida.Optionally, registers the event reference for validation.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetWebResourceUrl(Type, String)

Ottiene un riferimento URL a una risorsa in un assembly.Gets a URL reference to a resource in an assembly.

IsClientScriptBlockRegistered(String)

Determina se il blocco di script client è stato registrato con l'oggetto Page utilizzando la chiave specificata.Determines whether the client script block is registered with the Page object using the specified key.

IsClientScriptBlockRegistered(Type, String)

Determina se il blocco di script client è stato registrato con l'oggetto Page utilizzando una chiave e un tipo.Determines whether the client script block is registered with the Page object using a key and type.

IsClientScriptIncludeRegistered(String)

Determina se l'inclusione di script client è stata registrata con l'oggetto Page utilizzando la chiave specificata.Determines whether the client script include is registered with the Page object using the specified key.

IsClientScriptIncludeRegistered(Type, String)

Determina se l'inclusione di script client è stata registrata con l'oggetto Page utilizzando una chiave e un tipo.Determines whether the client script include is registered with the Page object using a key and type.

IsOnSubmitStatementRegistered(String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave specificata.Determines whether the OnSubmit statement is registered with the Page object using the specified key.

IsOnSubmitStatementRegistered(Type, String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave e il tipo specificati.Determines whether the OnSubmit statement is registered with the Page object using the specified key and type.

IsStartupScriptRegistered(String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave specificata.Determines whether the startup script is registered with the Page object using the specified key.

IsStartupScriptRegistered(Type, String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave e il tipo specificati.Determines whether the startup script is registered with the Page object using the specified key and type.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
RegisterArrayDeclaration(String, String)

Registra una dichiarazione di matrice JavaScript con l'oggetto Page utilizzando un nome e un valore di matrice.Registers a JavaScript array declaration with the Page object using an array name and array value.

RegisterClientScriptBlock(Type, String, String)

Registra lo script client con l'oggetto Page utilizzando un tipo, una chiave e un valore letterale di script.Registers the client script with the Page object using a type, key, and script literal.

RegisterClientScriptBlock(Type, String, String, Boolean)

Registra lo script client con l'oggetto Page utilizzando un tipo, una chiave, un valore letterale di script e un valore Boolean che indica se aggiungere tag script.Registers the client script with the Page object using a type, key, script literal, and Boolean value indicating whether to add script tags.

RegisterClientScriptInclude(String, String)

Registra lo script client con l'oggetto Page utilizzando una chiave e un URL che consente allo script di essere chiamato dal client.Registers the client script with the Page object using a key and a URL, which enables the script to be called from the client.

RegisterClientScriptInclude(Type, String, String)

Registra l'inclusione di script client con l'oggetto Page utilizzando un tipo, una chiave e un URL.Registers the client script include with the Page object using a type, a key, and a URL.

RegisterClientScriptResource(Type, String)

Registra la risorsa di script client con l'oggetto Page utilizzando un tipo e un nome di risorsa.Registers the client script resource with the Page object using a type and a resource name.

RegisterExpandoAttribute(String, String, String)

Registra una coppia nome/valore come attributo personalizzato (expando) del controllo specificato, dati un ID di controllo, un nome attributo e un valore di attributo.Registers a name/value pair as a custom (expando) attribute of the specified control given a control ID, attribute name, and attribute value.

RegisterExpandoAttribute(String, String, String, Boolean)

Registra una coppia nome/valore come attributo personalizzato (expando) del controllo specificato, dati un ID di controllo, un nome di attributo, un valore di attributo e un valore Boolean che indica se codificare il valore dell'attributo.Registers a name/value pair as a custom (expando) attribute of the specified control given a control ID, an attribute name, an attribute value, and a Boolean value indicating whether to encode the attribute value.

RegisterForEventValidation(PostBackOptions)

Registra un riferimento a un evento per la convalida con PostBackOptions.Registers an event reference for validation with PostBackOptions.

RegisterForEventValidation(String)

Registra un riferimento a un evento per la convalida con un ID di controllo univoco che rappresenta il controllo client che genera l'evento.Registers an event reference for validation with a unique control ID representing the client control generating the event.

RegisterForEventValidation(String, String)

Registra un riferimento a un evento per la convalida con un ID di controllo univoco e argomenti di evento che rappresentano il controllo client che genera l'evento.Registers an event reference for validation with a unique control ID and event arguments representing the client control generating the event.

RegisterHiddenField(String, String)

Registra un valore nascosto con l'oggetto Page.Registers a hidden value with the Page object.

RegisterOnSubmitStatement(Type, String, String)

Registra un'istruzione OnSubmit con l'oggetto Page utilizzando un tipo, una chiave e un valore letterale di script.Registers an OnSubmit statement with the Page object using a type, a key, and a script literal. L'istruzione viene eseguita quando viene inviato il controllo HtmlForm.The statement executes when the HtmlForm is submitted.

RegisterStartupScript(Type, String, String)

Registra lo script di avvio con l'oggetto Page utilizzando un tipo, una chiave e un valore letterale di script.Registers the startup script with the Page object using a type, a key, and a script literal.

RegisterStartupScript(Type, String, String, Boolean)

Registra lo script di avvio con l'oggetto Page utilizzando un tipo, una chiave, un valore letterale di script e un valore Boolean che indica se aggiungere tag script.Registers the startup script with the Page object using a type, a key, a script literal, and a Boolean value indicating whether to add script tags.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
ValidateEvent(String)

Convalida un evento client registrato per la convalida degli eventi utilizzando il metodo RegisterForEventValidation(String).Validates a client event that was registered for event validation using the RegisterForEventValidation(String) method.

ValidateEvent(String, String)

Convalida un evento client registrato per la convalida degli eventi utilizzando il metodo RegisterForEventValidation(String, String).Validates a client event that was registered for event validation using the RegisterForEventValidation(String, String) method.

Applies to

See also