ControlBuilder.AllowWhitespaceLiterals Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Determina se literais de espaço em branco são permitidos no conteúdo entre marcas de abertura e fechamento do controle. Esse método é chamado pela estrutura de página ASP.NET.

public:
 virtual bool AllowWhitespaceLiterals();

public virtual bool AllowWhitespaceLiterals ();

abstract member AllowWhitespaceLiterals : unit -> bool
override this.AllowWhitespaceLiterals : unit -> bool

Public Overridable Function AllowWhitespaceLiterals () As Boolean

Retornos

Boolean

Sempre retorna true.

Exemplos

// Create a class that does not allow white space generated by a control
// to be created as a LiteralControl.   
[AspNetHostingPermission(SecurityAction.Demand, 
   Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class NoWhiteSpaceControlBuilder : ControlBuilder 
{  
     public override bool AllowWhitespaceLiterals() 
     {
        return false;
     } 
}

' Create a class that does not allow white space generated by a control
' to be created as a LiteralControl.   

<AspNetHostingPermission(SecurityAction.Demand, _
  Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class NoWhiteSpaceControlBuilder
  Inherits ControlBuilder
  
  Public Overrides Function AllowWhitespaceLiterals() As Boolean
     Return False
  End Function 'AllowWhitespaceLiterals
End Class

Comentários

O AllowWhitespaceLiterals método é usado para determinar se literais de espaço em branco são permitidos no conteúdo entre as marcas de abertura e fechamento de um controle. Quando esse método retorna false, os literais de espaço em branco são cortados do conteúdo antes que o conteúdo seja processado pelo analisador de páginas. Quando esse método retorna true, os literais de espaço em branco não são removidos.

Esse método é chamado pela estrutura de página ASP.NET durante a análise e não se destina a ser chamado diretamente no código.

Notas aos Herdeiros

Você pode substituir esse método em sua classe derivada para indicar se literais de espaço em branco são permitidos em seu controle personalizado.