ClientScriptManager.IsOnSubmitStatementRegistered Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Détermine si l'instruction OnSubmit est inscrite avec l'objet Page.

Surcharges

IsOnSubmitStatementRegistered(Type, String)

Détermine si l'instruction OnSubmit est inscrite avec l'objet Page à l'aide de la clé et du type spécifiés.
IsOnSubmitStatementRegistered(String)

Détermine si l'instruction OnSubmit est inscrite avec l'objet Page à l'aide de la clé spécifiée.

IsOnSubmitStatementRegistered(Type, String)

Détermine si l'instruction OnSubmit est inscrite avec l'objet Page à l'aide de la clé et du type spécifiés.

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

Paramètres

type
Type

Type de l'instruction OnSubmit à rechercher.

key
String

Clé de l'instruction OnSubmit à rechercher.

Retours

Boolean

true si l'instruction OnSubmit est inscrite ; sinon, false.

Exceptions

ArgumentNullException

Le type de l'instruction OnSubmit est null.

Exemples

L’exemple de code suivant illustre l’utilisation de la IsOnSubmitStatementRegistered méthode. Un script nommé OnSubmitScript est inscrit avec le Page formulaire de la page afin que le script soit appelé lorsque le formulaire de la page est appelé.

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

Remarques

Appelez cette méthode avant d’appeler la méthode pour éviter d’inscrire RegisterOnSubmitStatement des instructions en double. Cela est particulièrement important si l’instruction nécessite une grande quantité de ressources serveur à créer.

Une instruction est identifiée de manière unique par sa clé et son type. Les instructions avec la même clé et le même type sont considérées comme des doublons. Vous spécifiez le type en fonction de l’objet qui accède à la ressource. Par exemple, lorsque vous utilisez une Page instance pour accéder à la ressource, vous spécifiez le Page type.

Voir aussi

S’applique à

IsOnSubmitStatementRegistered(String)

Détermine si l'instruction OnSubmit est inscrite avec l'objet Page à l'aide de la clé spécifiée.

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

Paramètres

key
String

Clé de l'instruction OnSubmit à rechercher.

Retours

Boolean

true si l'instruction OnSubmit est inscrite ; sinon, false.

Remarques

Appelez cette méthode avant d’appeler la RegisterOnSubmitStatement méthode pour éviter d’inscrire des instructions OnSubmit en double. Cela est particulièrement important si l’instruction nécessite une grande quantité de ressources serveur à créer.

Une instruction est identifiée de manière unique par sa clé et son type. Les instructions avec la même clé et le même type sont considérées comme des doublons.

Cette surcharge de la IsOnSubmitStatementRegistered méthode appelle la surcharge qui prend à la fois un paramètre et un key type paramètre avec le type défini en tant qu’objet Page

Voir aussi

S’applique à