Utilizzo di reCAPTCHA con ASP.NET

Importante: la versione 1.0 dell'API reCAPTCHA non è più supportata, esegui l'upgrade alla versione 2.0. Scopri di più

La libreria reCAPTCHA ASP.NET fornisce un modo semplice per inserire un CAPTCHA nel sito web ASP.NET, aiutandoti a impedire ai bot di utilizzarlo in modo illecito. La libreria racchiude l'API reCAPTCHA. Puoi utilizzare la libreria da qualsiasi linguaggio .NET, inclusi C# e Visual Basic .NET.

Per utilizzare reCAPTCHA con ASP.NET, puoi scaricare la libreria ASP.NET di reCAPTCHA.

Avvio rapido

Dopo aver effettuato la registrazione per le chiavi API, di seguito sono riportate le istruzioni di base per installare reCAPTCHA sul tuo sito con ASP.NET:

  1. Aggiungere un riferimento sul tuo sito web a libreria/bin/Release/Recaptcha.dll: nel menu Sito web di Visual Studio, scegli Aggiungi riferimento, quindi fai clic sulla scheda .NET nella finestra di dialogo. Seleziona il componente reCAPTCHA.dll dall'elenco dei componenti .NET e fai clic su OK. Se il componente non è visibile, fai clic sulla scheda Sfoglia e cerca il file Assembly sul disco rigido.
  2. Inserisci il controllo reCAPTCHA nel modulo che vuoi proteggere aggiungendo i seguenti snippet di codice:

    Nella parte superiore della pagina aspx inserisci:

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

    Quindi, inserisci il controllo reCAPTCHA all'interno del tag <form runat="server">:

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

    Dovrai sostituire la chiave pubblica e quella privata rispettivamente con PublicKey e PrivateKey.

  3. Assicurati di utilizzare la convalida di ASP.NET per convalidare il modulo (devi controllare Page.IsValid al momento dell'invio).

Di seguito è riportato un esempio "Hello World" con reCAPTCHA che utilizza Visual Basic. Un esempio di C# è incluso nel download della libreria.

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

Per approfondire

  • Personalizzazione di aspetto e design
  • Suggerimenti e linee guida
  • Risoluzione dei problemi