إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
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"))" />
النهج ذات الصلة
المحتوى ذو الصلة
لمزيد من المعلومات حول العمل مع النُهج، راجع:
- البرنامج التعليمي: تحويل واجهة برمجة التطبيقات الخاصة بك وحمايتها
- Policy reference لقائمة كاملة من بيانات النُهج وإعداداتها
- تعبيرات النهج
- تعيين النهج أو تحريرها
- إعادة استخدام التكوينات الخاصة بالنهج
- مستودع القصاصات البرمجية للنهج
- مستودع ملعب النهج
- مجموعة أدوات نهج إدارة واجهة برمجة تطبيقات Azure
- الحصول على مساعدة Copilot لإنشاء النهج وشرحها واستكشاف الأخطاء وإصلاحها