ClientScriptManager.IsOnSubmitStatementRegistered Methode

  • Referenz

Definition

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

Bestimmt, ob die OnSubmit-Anweisung für das Page-Objekt registriert ist.

Überlädt

IsOnSubmitStatementRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob die OnSubmit-Anweisung für das Page-Objekt registriert ist.
IsOnSubmitStatementRegistered(String)

Bestimmt anhand des angegebenen Schlüssels, ob die OnSubmit-Anweisung für das Page-Objekt registriert ist.

IsOnSubmitStatementRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob die OnSubmit-Anweisung für das Page-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 zu suchenden OnSubmit-Anweisung.

key
String

Der Schlüssel der zu suchenden OnSubmit-Anweisung.

Gibt zurück

Boolean

true, wenn die OnSubmit-Anweisung registriert ist, andernfalls false.

Ausnahmen

ArgumentNullException

Der Typ der OnSubmit-Anweisung ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsOnSubmitStatementRegistered -Methode veranschaulicht. Ein Skript mit dem Namen OnSubmitScript wird bei registriert Page , sodass beim Übermitteln des Seitenformulars das Skript aufgerufen 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 zu vermeiden, dass doppelte Anweisungen registriert werden. Dies ist besonders wichtig, wenn für die -Anweisung eine große Anzahl von Serverressourcen zum Erstellen erforderlich ist.

Eine -Anweisung wird durch ihren Schlüssel und ihren Typ eindeutig 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 anhand des angegebenen Schlüssels, ob die OnSubmit-Anweisung für das Page-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 zu suchenden OnSubmit-Anweisung.

Gibt zurück

Boolean

true, wenn die OnSubmit-Anweisung registriert ist, andernfalls false.

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterOnSubmitStatement -Methode aufrufen, um zu vermeiden, dass doppelte OnSubmit-Anweisungen registriert werden. Dies ist besonders wichtig, wenn für die -Anweisung eine große Anzahl von Serverressourcen zum Erstellen erforderlich ist.

Eine -Anweisung wird durch ihren Schlüssel und ihren Typ eindeutig 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 - als auch einen type -Parameter mit dem als Page -Objekt festgelegten Typ akzeptiert.

Weitere Informationen

Gilt für: