تعيين المتغير

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

set-variableيقوم النهج بتعريف متغير سياق وتعيين قيمة محددة عبر تعبير أو سلسلة حرفية. إذا كان التعبير يحتوي على قيمة حرفية، فسيتم تحويله إلى سلسلة وسيكون System.Stringنوع القيمة .

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<set-variable name="variable name" value="Expression | String literal" />

سمات

السمة ‏‏الوصف مطلوب
الاسم اسم المتغير. تعبيرات النهج غير مسموح بها. ‏‏نعم‬
قيمة قيمة المتغير. قد يكون هذا تعبيراً أو قيمة حرفية. يتم السماح بتعبيرات النهج. ‏‏نعم‬

الاستخدام

  • أقسام النهج: واردة وصادرة وخلفية وعند الخطأ
  • نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
  • البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا

الأنواع المسموح بها

يجب أن ترجع التعبيرات المستخدمة في نهج set-variable أحد الأنواع الأساسية التالية.

  • System.Boolean
  • System.SByte
  • System.Byte
  • System.UInt16
  • System.UInt32
  • النظام.UInt64
  • System.Int16
  • System.Int32
  • System.Int64
  • النظام.عشري
  • System.Single
  • System.Double
  • System.Guid
  • System.String
  • System.Char
  • System.DateTime
  • System.TimeSpan
  • System.Byte?
  • System.UInt16?
  • System.UInt32?
  • System.UInt64?
  • System.Int16?
  • System.Int32?
  • System.Int64?
  • System.Decimal?
  • System.Single?
  • System.Double?
  • System.Guid?
  • System.String?
  • System.Char?
  • System.DateTime?

مثال

يوضح المثال التالي نهج set-variable في القسم الوارد. ينشئ نهج تعيين المتغير هذا متغير isMobile سياق منطقي يتم تعيينه على "صحيح" إذا كان User-Agent عنوان الطلب يحتوي على النص iPad أو iPhone.

<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />

لمزيد من المعلومات حول العمل مع النُهج، راجع: