Funções EncodeHTML, EncodeUrl e PlainText

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Codifica e descodifica cadeias.

Descrição

A função EncodeUrl codifica uma cadeia de URL ao substituir determinados carateres não alfanuméricos por % e um número hexadecimal.

A função EncodeHTML codifica uma cadeia de carateres, substituindo determinados carateres que precisam de ser incluídos em sequências de escape para que apareçam corretamente num contexto HTML. Por exemplo, os carateres < e > & são substituídos por <, > e &, respetivamente.

A função PlainText remove tags de HTML e XML e converte determinados tags como as seguintes para um símbolo adequado:

  • "

O valor devolvido por estas funções é a cadeia codificada ou descodificada. Esta função não remove todas as tags HTML e XML.

Sintaxe

EncodeUrl( Cadeia )

  • Cadeia – Obrigatório. URL a codificar.

EncodeHTML( Cadeia )

  • Cadeia – Obrigatório. HTML a codificar.

PlainText( Cadeia )

  • Cadeia – Obrigatório. Cadeia da qual as tags de HTML e XML são eliminadas.

Exemplos

Se apresentar um feed RSS na galeria de texto e, em seguida, definir a propriedade Text de uma etiqueta nessa galeria para ThisItem.description, a etiqueta poderá apresentar código HTML ou XML não processado como neste exemplo:

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

Se definir a propriedade Text da etiqueta para PlainText(ThisItem.description), o texto é apresentado como neste exemplo:

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

Com a fórmula EncodeHTML (ThisItem.description), as tags de HTML são codificadas para que apareçam como texto quando interpretadas como HTML, o que pode ser útil para ver a estrutura HTML:

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

Se, em vez de uma etiqueta, tiver um controlo de texto de HTML na galeria e definir a propriedade HtmlText desse controlo como ThisItem.description, também verá o texto descodificado, porque o controlo de texto HTML está a interpretar as etiquetas como HTML.