ControlBuilder.NeedsTagInnerText Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Determina se o construtor de controle precisa obter seu texto interno. Se sim, o método SetTagInnerText(String) deve ser chamado. Esse método é chamado pela estrutura de página ASP.NET.

public:
 virtual bool NeedsTagInnerText();

public virtual bool NeedsTagInnerText ();

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

Public Overridable Function NeedsTagInnerText () As Boolean

Retornos

Boolean

true se o construtor de controle precisar obter seu texto interno. O padrão é false.

Exemplos

O exemplo a seguir usa a InDesigner propriedade quando o NeedsTagInnerText método é chamado. Quando um controle tem esse construtor anexado a ele, determina NeedsTagInnerText se o controle está sendo acessado em tempo de design por meio de um designer. O NeedsTagInnerText retorna o valor da InDesigner propriedade e, em seguida, o SetTagInnerText método é chamado. Se a InDesigner propriedade estiver definida como false, uma Exception será lançada. Caso contrário, o texto interno do controle é retornado na SetTagInnerText chamada.

[AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class MyControlControlBuilder : ControlBuilder
{
    private string _innerText;

    public override bool NeedsTagInnerText()
    {
        return InDesigner;
    }

    public override void SetTagInnerText(string text)
    {
        if (!InDesigner)
            throw new Exception("The control is not in design mode.");
        else
            _innerText = text;
    }
}

<AspNetHostingPermission(SecurityAction.Demand, _
  Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class MyControlControlBuilder
  Inherits ControlBuilder
    
    Private _innerText As String
    
    Overrides Public Function NeedsTagInnerText() As Boolean
      Return InDesigner
    End Function
    
    Overrides Public Sub SetTagInnerText(ByVal text As String)        
       If InDesigner = False
         Throw New System.Exception("The control is not in design mode.")
       Else
         _innerText = text
       End If
    End Sub
    
End Class

Comentários

O texto interno é o texto entre as marcas de abertura e fechamento do controle.

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.