ControlBuilder.NeedsTagInnerText Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Určuje, jestli tvůrce ovládacích prvků potřebuje získat jeho vnitřní text. Pokud ano, SetTagInnerText(String) musí být volána metoda. Tato metoda je volána ASP.NET stránkovou architekturou.

public:
 virtual bool NeedsTagInnerText();

public virtual bool NeedsTagInnerText ();

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

Public Overridable Function NeedsTagInnerText () As Boolean

Návraty

Boolean

true pokud tvůrce ovládacích prvků potřebuje získat jeho vnitřní text. Výchozí formát je false.

Příklady

Následující příklad používá InDesigner vlastnost při NeedsTagInnerText volání metody. Pokud k němu ovládací prvek připojí tento tvůrce, určuje, NeedsTagInnerText jestli je ovládací prvek přístupný v době návrhu prostřednictvím návrháře. Vrátí NeedsTagInnerText hodnotu InDesigner vlastnosti a pak SetTagInnerText se volá metoda. InDesigner Pokud je vlastnost nastavena na false, Exception je vyvolán. V opačném případě se vnitřní text ovládacího prvku vrátí na SetTagInnerText volání.

[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

Poznámky

Vnitřní text je text mezi levou a pravou značkou ovládacího prvku.

Tato metoda je volána rozhraním stránky ASP.NET během parsování a není určena k volání přímo v kódu.