وظائف EncodeHTML وEncodeUrl وPlainText

تنطبق على: تطبيقات اللوحة تدفقات سطح المكتب التطبيقات التي تستند إلى النماذج Power Pages Power Platform CLI

ترميز وفك ترميز السلاسل.

الوصف

تقوم وظيفة EncodeUrl بترميز سلسلة URL، واستبدال أحرف معينة غير أبجدية رقمية بـ % ورقم سداسي عشري.

تقوم وظيفة EncodeHTML‎ بتشفير سلسلة، واستبدال أحرف معينة تحتاج إلى الهروب لتظهر بشكل صحيح في سياق HTML. على سبيل المثال، يتم استبدال الأحرف <، و>، و& بـ <، و>، و&، على التوالي.

تقوم وظيفة PlainText بإزالة علامات HTML وXML، مع تحويل علامات معينة مثل هذه العلامات إلى رمز مناسب:

  • "

قيمه الإرجاع من هذه الوظائف هي السلسلة المرمزة أو التي تم فك ترميزها. لا تقوم هذه الوظيفة بإزالة جميع علامات HTML وXML.

بناء الجملة

EncodeUrl( سلسلة )

  • سلسلة - مطلوبة. عنوان URL المُراد ترميزه.

EncodeHTML( سلسلة )

  • سلسلة - مطلوبة. عنوان HTML المُراد ترميزه.

PlainText( سلسلة )

  • سلسلة - مطلوبة. السلسلة التي يتم تجريد علامات HTML وXML منها.

الأمثلة

إذا قمت بإظهار موجز RSS في معرض نصوص، ثم قمت بتعيين خاصية Text للتسمية في هذا المعرض إلى ThisItem.description، قد تظهر التسمية رمز HTML أو XML أوليًا في هذا المثال:

<p>
  We have done an unusually&nbsp;&quot;deep&quot; globalization and
  localization.
</p>

إذا قمت بتعيين خاصية Text الخاصة بالتسمية إلى PlainText(ThisItem.description)، يظهر النص كما في المثال التالي:

    We have done an unusually "deep" globalization and localization.

باستخدام الصيغة EncodeHTML(ThisItem.description)، يتم ترميز علامات HTML بحيث تظهر كنص عند تفسيرها على أنها HTML، وهو ما قد يكون مفيدًا لرؤية بنية HTML:

&lt;p&gt;
  We have done an unusually&amp;nbsp;&amp;quot;deep&amp;quot; globalization and
  localization.
&lt;/p&gt;

إذا كان لديك بدلاً من التسمية عنصر تحكم نص ‏‎‎‏‎HTML في المعرض، وقمت بتعيين خاصية HtmlText إلى ThisItem.description فإنك ترى أيضًا النص الذي تم فك ترميزه، لأن عنصر تحكم نص HTML يفسر العلامات على أنها HTML .