将 reCAPTCHA 与 ASP.NET 搭配使用

重要提示:reCAPTCHA API 1.0 版已不再受支持,请升级到 2.0 版。了解详情

reCAPTCHA ASP.NET 库提供了一种在 ASP.NET 网站上设置人机识别系统的简单方法,可帮助您阻止漫游器滥用网站。该库封装了 reCAPTCHA API。 您可以通过任何 .NET 语言(包括 C# 和 Visual Basic .NET)使用该库。

如需将 reCAPTCHA 与 ASP.NET 配合使用,您可以下载 reCAPTCHA ASP.NET 库

快速入门

注册 API 密钥后,以下是使用 ASP.NET 在网站上安装 reCAPTCHA 的基本说明:

  1. 在您的网站上将引用添加到 library/bin/Release/Recaptcha.dll:在 Visual Studio Website 菜单中,选择“Add Reference”(添加引用),然后点击对话框中的 .NET 标签页。从 .NET 组件列表中选择 Recaptcha.dll 组件,然后点击“确定”。如果您没有看到此组件,请点击“浏览”标签页,然后在硬盘上查找汇编文件。
  2. 通过添加以下代码段,将 reCAPTCHA 控件插入您希望保护的表单中:

    在 aspx 页面的顶部,插入以下内容:

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

    然后将 reCAPTCHA 控件插入 <form runat="server"> 标记内:

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

    您需要将自己的公钥和私钥分别替换为 PublicKey 和 PrivateKey。

  3. 确保使用 ASP.NET 验证来验证表单(应该在提交时检查 Page.IsValid)。

下面是一个使用 Visual Basic 的 reCAPTCHA 的“Hello World”。下载的库中包含 C# 示例。

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

延伸阅读

  • 自定义外观和风格
  • 提示和指南
  • 问题排查