استخدام reCAPTCHA مع ASP.NET

ملاحظة: لم يعُد الإصدار 1.0 من reCAPTCHA API متاحًا، لذا يُرجى الترقية إلى الإصدار 2.0. مزيد من المعلومات

توفّر مكتبة ASP.NET لخدمة reCAPTCHA طريقة بسيطة لوضع اختبار CAPTCHA على موقع ASP.NET الإلكتروني، ما يساعدك في منع برامج التتبّع من إساءة استخدام هذه المكتبة. تشمل المكتبة واجهة برمجة تطبيقات ReCAPTCHA. يمكنك استخدام المكتبة من أي لغة .NET بما في ذلك C# وVisual Basic .NET.

لاستخدام reCAPTCHA مع ASP.NET، يمكنك تنزيل مكتبة ReCAPTCHA ASP.NET.

البدء بسرعة

بعد الاشتراك في مفاتيح واجهة برمجة التطبيقات، في ما يلي التعليمات الأساسية لتثبيت reCAPTCHA على موقعك الإلكتروني باستخدام ASP.NET:

  1. أضف مرجعًا إلى موقعك على الويب إلى library/bin/Release/Recaptcha.dll: من قائمة Visual Studio Website، اختر إضافة مرجع، ثم انقر على علامة التبويب .NET في مربع الحوار. حدد مكون Recaptcha.dll من قائمة مكونات .NET ثم انقر فوق "OK" (موافق). إذا لم يظهر لك المكون، فانقر على علامة التبويب "تصفح" وابحث عن ملف التجميع على محرك الأقراص الثابتة.
  2. أدخِل عنصر تحكّم reCAPTCHA في النموذج الذي تريد حمايته عن طريق إضافة مقتطفات الرمز التالية:

    في أعلى صفحة FOS، أدرِج ما يلي:

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

    ستحتاج إلى استبدال المفتاح العام والخاص بك في المفتاح العام والمفتاح الخاص على التوالي.

  3. تأكد من استخدام عملية التحقق من ASP.NET للتحقق من صحة النموذج (يجب عليك التحقق من Page.IsHealth عند الإرسال).

في ما يلي عبارة "Hello World" مع reCAPTCHA باستخدام Visual Basic. يتم تضمين عينة 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>

قراءات إضافية

  • تخصيص الشكل والمظهر
  • نصائح وإرشادات
  • تحديد المشاكل وحلّها