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 vnitřní text. Pokud ano, SetTagInnerText(String) musí být volána metoda. Tato metoda je volána rozhraním stránky 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

Návraty

Boolean

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

Příklady

Následující příklad používá InDesigner vlastnost při NeedsTagInnerText zavolání metody. Pokud má ovládací prvek tento tvůrce připojený k němu, určuje, NeedsTagInnerText zda 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 je volána metoda. Pokud je vlastnost nastavena InDesigner na false, je Exception vyvolán. V opačném případě se vnitřní text ovládacího prvku vrátí ve 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 analýzy a není určena k volání přímo v kódu.