ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Registra un'istruzione OnSubmit con l'oggetto Page utilizzando un tipo, una chiave e un valore letterale di script. L'istruzione viene eseguita quando viene inviato il controllo HtmlForm.

public:
 void RegisterOnSubmitStatement(Type ^ type, System::String ^ key, System::String ^ script);
public void RegisterOnSubmitStatement (Type type, string key, string script);
member this.RegisterOnSubmitStatement : Type * string * string -> unit
Public Sub RegisterOnSubmitStatement (type As Type, key As String, script As String)

Parametri

type
Type

Tipo di istruzione OnSubmit da registrare.

key
String

Chiave dell'istruzione OnSubmit da registrare.

script
String

Valore letterale dell'istruzione OnSubmit da registrare.

Eccezioni

ArgumentNullException

type è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso RegisterOnSubmitStatement del metodo.

<%@ 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 script on the page.
    String csname = "OnSubmitScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the OnSubmit statement is already registered.
    if (!cs.IsOnSubmitStatementRegistered(cstype, csname))
    {
      String cstext = "document.write('Text from OnSubmit statement');";
      cs.RegisterOnSubmitStatement(cstype, csname, cstext);
    }

  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <input type="submit"
            value="Submit" />
     </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 script on the page.
    Dim csname As String = "OnSubmitScript"
    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 OnSubmit statement is already registered.
    If (Not cs.IsOnSubmitStatementRegistered(cstype, csname)) Then
      
      Dim cstext As String = "document.write('Text from OnSubmit statement.');"
      cs.RegisterOnSubmitStatement(cstype, csname, cstext)
      
    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="submit"
            value="Submit" />
     </form>
  </body>
</html>

Commenti

Un'istruzione OnSubmit viene identificata in modo univoco dalla chiave e dal relativo tipo. Le istruzioni con la stessa chiave e il tipo vengono considerati duplicati. È possibile registrare una sola istruzione con un determinato tipo e una coppia di chiavi con la pagina. Il tentativo di registrare un'istruzione già registrata non creerà un duplicato dell'istruzione.

Chiamare il metodo per determinare se un'istruzione IsOnSubmitStatementRegistered OnSubmit è già registrata con una determinata chiave e coppia di tipi ed evitare di tentare inutilmente di aggiungere lo script.

Il script parametro del RegisterOnSubmitStatement metodo può contenere più comandi di script purché siano delimitati correttamente con un punto e virgola (;).

Aggiunge RegisterOnSubmitStatement uno script eseguito prima dell'invio della pagina e offre l'opportunità di annullare l'invio.

Per altre informazioni sui moduli HTML e sull'attributo, vedere il OnSubmitsito Web World Wide Web Consortium (W3C).

Si applica a

Vedi anche