ClientScriptManager.IsOnSubmitStatementRegistered Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Bestimmt, ob die OnSubmit-Anweisung beim Page Objekt registriert ist.

Überlädt

Name Beschreibung
IsOnSubmitStatementRegistered(Type, String)

Bestimmt, ob die OnSubmit-Anweisung mit dem Page angegebenen Schlüssel und Typ beim Objekt registriert ist.
IsOnSubmitStatementRegistered(String)

Bestimmt, ob die OnSubmit-Anweisung mit dem Page angegebenen Schlüssel beim Objekt registriert ist.

IsOnSubmitStatementRegistered(Type, String)

Bestimmt, ob die OnSubmit-Anweisung mit dem Page angegebenen Schlüssel und Typ beim Objekt registriert ist.

public:
 bool IsOnSubmitStatementRegistered(Type ^ type, System::String ^ key);
public bool IsOnSubmitStatementRegistered(Type type, string key);
member this.IsOnSubmitStatementRegistered : Type * string -> bool
Public Function IsOnSubmitStatementRegistered (type As Type, key As String) As Boolean

Parameter

type
Type

Der Typ der OnSubmit-Anweisung, nach der gesucht werden soll.

key
String

Der Schlüssel der OnSubmit-Anweisung, nach der gesucht werden soll.

Gibt zurück

Boolean

truewenn die OnSubmit-Erklärung registriert ist; andernfalls . false

Ausnahmen

ArgumentNullException

Der OnSubmit-Anweisungstyp ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsOnSubmitStatementRegistered Methode veranschaulicht. Ein benanntes OnSubmitScript Skript wird mit der Page Betreffenden registriert, sodass das Skript aufgerufen wird, wenn das Formular der Seite übermittelt wird.

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

Rufen Sie diese Methode auf, bevor Sie die RegisterOnSubmitStatement Methode aufrufen, um doppelte Anweisungen zu vermeiden. Dies ist besonders wichtig, wenn für die Anweisung eine große Menge Serverressourcen erstellt werden müssen.

Eine Anweisung wird eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Anweisungen mit demselben Schlüssel und Typ werden als Duplikate betrachtet. Sie geben den Typ basierend auf dem Objekt an, das auf die Ressource zugreift. Wenn Sie beispielsweise eine Page Instanz für den Zugriff auf die Ressource verwenden, geben Sie den Page Typ an.

Weitere Informationen

Gilt für:

IsOnSubmitStatementRegistered(String)

Bestimmt, ob die OnSubmit-Anweisung mit dem Page angegebenen Schlüssel beim Objekt registriert ist.

public:
 bool IsOnSubmitStatementRegistered(System::String ^ key);
public bool IsOnSubmitStatementRegistered(string key);
member this.IsOnSubmitStatementRegistered : string -> bool
Public Function IsOnSubmitStatementRegistered (key As String) As Boolean

Parameter

key
String

Der Schlüssel der OnSubmit-Anweisung, nach der gesucht werden soll.

Gibt zurück

Boolean

truewenn die OnSubmit-Erklärung registriert ist; andernfalls . false

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterOnSubmitStatement Methode aufrufen, um doppelte OnSubmit-Anweisungen zu vermeiden. Dies ist besonders wichtig, wenn für die Anweisung eine große Menge Serverressourcen erstellt werden müssen.

Eine Anweisung wird eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Anweisungen mit demselben Schlüssel und Typ werden als Duplikate betrachtet.

Diese Überladung der IsOnSubmitStatementRegistered Methode ruft die Überladung auf, die sowohl einen key Parameter als auch einen type Parameter mit dem Typ verwendet, der als Objekt festgelegt ist.Page

Weitere Informationen

Gilt für: