ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Metódus

Definíció

Névtér:
System.Web.UI
Szerelvény:
System.Web.dll

Egy OnSubmit utasítást regisztrál az Page objektummal egy típus, egy kulcs és egy szkriptkonstans használatával. Az utasítás a HtmlForm beküldéskor fut.

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)

Paraméterek

type
Type

A regisztrálandó OnSubmit utasítás típusa.

key
String

A regisztrálandó OnSubmit utasítás kulcsa.

script
String

A regisztrálandó OnSubmit utasítás szkriptkonstansa.

Kivételek

ArgumentNullException

type az null.

Példák

Az alábbi példakód a metódus használatát RegisterOnSubmitStatement mutatja be.

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

Megjegyzések

Az OnSubmit utasítást a kulcs és a típus egyedileg azonosítja. Az azonos kulccsal és típussal rendelkező utasítások duplikáltnak minősülnek. Az oldalon csak egy adott típusú és kulcspárt tartalmazó utasítás regisztrálható. Ha egy már regisztrált utasítást próbál regisztrálni, az nem hozza létre az utasítás másolatát.

Hívja meg a IsOnSubmitStatementRegistered metódust annak megállapításához, hogy egy OnSubmit utasítás már regisztrálva van-e egy adott kulccsal, és írja be a párokat, és ne próbálja meg szükségtelenül hozzáadni a szkriptet.

A script metódus paramétere RegisterOnSubmitStatement több szkriptparancsot is tartalmazhat, ha pontosvesszővel (;)) vannak megfelelően elhatárolva.

A RegisterOnSubmitStatement rendszer hozzáad egy szkriptet, amelyet a lap elküldése előtt hajtanak végre, és lehetőséget ad a beküldés megszakítására.

A HTML-űrlapokkal és az OnSubmit attribútummal kapcsolatos további információkért lásd a World Wide Web Consortium (W3C) webhelyét.

A következőre érvényes:

Lásd még