ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Methode

Definition

Registriert unter Verwendung eines Typs, eines Schlüssels sowie eines Skriptliterals eine OnSubmit-Anweisung für das Page-Objekt.Registers an OnSubmit statement with the Page object using a type, a key, and a script literal. Die Anweisung wird beim Übermitteln des HtmlForm ausgeführt.The statement executes when the HtmlForm is submitted.

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

Parameter

type
Type

Der Typ der zu registrierenden OnSubmit-Anweisung.The type of the OnSubmit statement to register.

key
String

Der Schlüssel der zu registrierenden OnSubmit-Anweisung.The key of the OnSubmit statement to register.

script
String

Das Skriptliteral der zu registrierenden OnSubmit-Anweisung.The script literal of the OnSubmit statement to register.

Ausnahmen

type ist null.type is null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung RegisterOnSubmitStatement der-Methode veranschaulicht.The following code example demonstrates the use of the RegisterOnSubmitStatement method.

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

Hinweise

Eine OnSubmit-Anweisung wird eindeutig durch Ihren Schlüssel und deren Typ identifiziert.An OnSubmit statement is uniquely identified by its key and its type. Anweisungen mit dem gleichen Schlüssel und Typ werden als Duplikate angesehen.Statements with the same key and type are considered duplicates. Bei der Seite kann nur eine Anweisung mit einem bestimmten Typ und Schlüsselpaar registriert werden.Only one statement with a given type and key pair can be registered with the page. Wenn Sie versuchen, eine Anweisung zu registrieren, die bereits registriert ist, wird kein Duplikat der-Anweisung erstellt.Attempting to register a statement that is already registered will not create a duplicate of the statement.

Ruft die IsOnSubmitStatementRegistered -Methode auf, um zu bestimmen, ob eine OnSubmit-Anweisung bereits mit einem bestimmten Schlüssel und typpaar registriert ist, und vermeidet unnötige Versuche, das Skript hinzuzufügen.Call the IsOnSubmitStatementRegistered method to determine whether an OnSubmit statement is already registered with a given key and type pair and avoid unnecessarily attempting to add the script.

Der script -Parameter RegisterOnSubmitStatement der-Methode kann mehrere Skript Befehle enthalten, solange Sie durch ein Semikolon (;)) ordnungsgemäß getrennt sind.The script parameter of the RegisterOnSubmitStatement method can contain multiple script commands as long as they are properly delimited with a semicolon (;).

Das RegisterOnSubmitStatement fügt ein Skript hinzu, das vor dem übermitteln der Seite ausgeführt wird, und bietet Ihnen die Möglichkeit, die Übermittlung abzubrechen.The RegisterOnSubmitStatement adds a script that is executed before the page is submitted and gives you an opportunity to cancel the submission.

Weitere Informationen zu HTML-Formularen und zum OnSubmit -Attribut finden Sie auf der World Wide Web Consortium-Website (W3C).For more information on HTML forms and the OnSubmit attribute, see the World Wide Web Consortium (W3C) Web site.

Gilt für:

Siehe auch