Funções EncodeHTML, EncodeUrl e PlainText

  • Artigo

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages Power Platform CLI

Codifica e decodifica as cadeias de caracteres.

Descrição

A função EncodeUrl codifica uma cadeia de caracteres de URL, substituindo certos caracteres não alfanuméricos por % e um número hexadecimal.

A função EncodeHTML codifica uma cadeia de caracteres, substituindo determinados caracteres que precisam ser escapados para serem exibidos corretamente em um contexto HTML. Por exemplo, os caracteres <, > e & são substituídos por <, > e &, respectivamente.

A função PlainText remove as marcas HTML e XML, convertendo certas marcas em um símbolo apropriado:

  •  
  • "

O valor de retorno dessas funções é a cadeia de caracteres codificada ou decodificada. Esta função não remove todas as tags HTML e XML.

Sintaxe

EncodeUrl( String )

  • String - Obrigatório. URL a ser codificada.

CodificarHTML( String )

  • String - Obrigatório. HTML a ser codificada.

Texto Simples( String )

  • String - Obrigatório. A cadeia de caracteres da qual as marcas HTML e XML são removidas.

Exemplos

Se você mostrar um RSS feed em uma galeria de texto e definir a propriedade Text de um rótulo nessa galeria como ThisItem.description, o rótulo mostrará o código HTML ou XML bruto como neste exemplo:

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

Se você definir a propriedade Text do rótulo como PlainText(ThisItem.description), o texto aparecerá como neste exemplo:

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

Com a fórmula EncodeHTML(ThisItem.description), as marcas HTML são codificadas para que sejam mostradas 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 um rótulo, você tiver um controle de texto HTML na galeria, e você definir a propriedade HtmlText desse controle como ThisItem.description você também verá o texto decodificado, pois o controle de texto HTML está interpretando as marcas como HTML.