ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

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.

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)

Parameters

type
Type

Het type onSubmit-instructie dat moet worden geregistreerd.

key
String

De sleutel van de OnSubmit-instructie die moet worden geregistreerd.

script
String

De letterlijke scripttekst van de OnSubmit-instructie die moet worden geregistreerd.

Uitzonderingen

ArgumentNullException

type is null.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de RegisterOnSubmitStatement methode.

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

Opmerkingen

Een OnSubmit-instructie wordt uniek geïdentificeerd door de sleutel en het bijbehorende type. Instructies met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten. Er kan slechts één instructie met een bepaald type en sleutelpaar worden geregistreerd bij de pagina. Als u probeert een instructie te registreren die al is geregistreerd, wordt er geen duplicaat van de instructie gemaakt.

Roep de IsOnSubmitStatementRegistered methode aan om te bepalen of een OnSubmit-instructie al is geregistreerd bij een bepaalde sleutel en typepaar en vermijd onnodig proberen het script toe te voegen.

De script parameter van de RegisterOnSubmitStatement methode kan meerdere scriptopdrachten bevatten zolang ze juist zijn gescheiden door een puntkomma (;).

Hiermee RegisterOnSubmitStatement voegt u een script toe dat wordt uitgevoerd voordat de pagina wordt verzonden en krijgt u de mogelijkheid om de inzending te annuleren.

Zie de W3C-website (World Wide Web Consortium) voor meer informatie over HTML-formulieren en het OnSubmit kenmerk.

Van toepassing op

Zie ook