ControlBuilder.NeedsTagInnerText Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Determina se o construtor de controlos precisa de obter o seu texto interno. Se sim, o SetTagInnerText(String) método deve ser chamado. Este método é chamado pelo framework de páginas 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
Devoluções
true Se o construtor de controlos precisa de obter o seu texto interno. A predefinição é false.
Exemplos
O exemplo seguinte utiliza a InDesigner propriedade quando o NeedsTagInnerText método é chamado. Quando um controlo tem este construtor acoplado, determina-se NeedsTagInnerText se o controlo está a ser acedido no momento do projeto através de um projetista. Devolve NeedsTagInnerText o valor da InDesigner propriedade, e depois o SetTagInnerText método é chamado. Se a InDesigner propriedade for definida para false, e Exception é lançado. Caso contrário, o texto interno do controlo é devolvido 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
Observações
O texto interior é o texto entre as etiquetas de abertura e fecho do controlo.
Este método é chamado pelo framework de páginas ASP.NET durante a análise sintática e não é pensado para ser chamado diretamente no seu código.