Utiliser reCAPTCHA avec ASP.NET

Important : La version 1.0 de l'API reCAPTCHA n'est plus prise en charge. Veuillez passer à la version 2.0. En savoir plus

La bibliothèque reCAPTCHA ASP.NET permet de placer facilement CAPTCHA sur votre site Web ASP.NET pour vous aider à bloquer les bots d'en abuser. La bibliothèque encapsule l'API reCAPTCHA. Vous pouvez utiliser la bibliothèque dans n'importe quel langage .NET, y compris C# et Visual Basic .NET.

Pour utiliser reCAPTCHA avec ASP.NET, vous pouvez télécharger le reCAPTCHA bibliothèque ASP.NET.

Démarrage rapide

Une fois inscrit pour recevoir vos clés API, vous trouverez ci-dessous des instructions de base pour installer reCAPTCHA sur votre site avec ASP.NET:

  1. Ajoutez une référence sur votre site Web à library/bin/Release/Recaptcha.dll: dans Visual Studio Dans le menu "Website" (Site Web), choisissez "Add Reference" (Ajouter une référence), puis cliquez sur l'onglet .NET dans la boîte de dialogue. Sélectionnez l'icône Recaptcha.dll dans la liste des composants .NET, puis cliquez sur OK. Si vous ne voyez pas cliquez sur l'onglet "Parcourir" et recherchez le fichier d'assemblage sur votre disque dur.
  2. Insérez le contrôle reCAPTCHA dans le formulaire que vous souhaitez protéger en ajoutant les extraits de code suivants:

    En haut de la page de l'application, insérez ceci:

      <%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %>
    

    Insérez ensuite le contrôle reCAPTCHA dans la balise <form runat="server"> :

      <recaptcha:RecaptchaControl
        ID="recaptcha"
        runat="server"
        PublicKey="your_public_key"
        PrivateKey="your_private_key"
        />
    

    Vous devez remplacer votre clé publique et votre clé privée par "PublicKey" et "PrivateKey", respectivement.

  3. Assurez-vous d'utiliser la validation ASP.NET pour valider votre formulaire (vous devez vérifier Page.IsValid lors de l'envoi).

Voici un exemple "Hello World" avec reCAPTCHA à l'aide de Visual Basic. Un exemple C# est inclus dans le téléchargement de la bibliothèque.

  <%@ Page Language="VB" %>
  <%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %>
  <script runat=server%gt;
      Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
          If Page.IsValid Then
              lblResult.Text = "You Got It!"
              lblResult.ForeColor = Drawing.Color.Green
          Else
              lblResult.Text = "Incorrect"
              lblResult.ForeColor = Drawing.Color.Red
          End If
      End Sub
  </script>
  <html>
  <body>
      <form runat="server">
          <asp:Label Visible=false ID="lblResult" runat="server" />
          <recaptcha:RecaptchaControl
              ID="recaptcha"
              runat="server"
              Theme="red"
              PublicKey="your_public_key"
              PrivateKey="your_private_key"
              />

          <asp:Button ID="btnSubmit" runat="server" Text="Submit" OnClick="btnSubmit_Click" />
      </form>
  </body>
  </html>

Documentation complémentaire

  • Personnaliser l'apparence
  • Conseils et consignes
  • Dépannage