ControlBuilder.NeedsTagInnerText Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Determina se il generatore di controllo deve ottenere il testo interno. In questo caso, è necessario chiamare il metodo SetTagInnerText(String). Questo metodo viene chiamato dal framework per le pagine 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

Restituisce

Boolean

true se il generatore di controllo deve ottenere il testo interno. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene utilizzata la InDesigner proprietà quando viene chiamato il NeedsTagInnerText metodo . Quando a un controllo è associato questo generatore, determina NeedsTagInnerText se il controllo è accessibile in fase di progettazione tramite una finestra di progettazione. Restituisce NeedsTagInnerText il valore della InDesigner proprietà e quindi viene chiamato il SetTagInnerText metodo . Se la InDesigner proprietà è impostata su false, viene generata un'eccezione Exception . In caso contrario, il testo interno del controllo viene restituito nella SetTagInnerText chiamata.

[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

Commenti

Il testo interno è il testo tra i tag di apertura e chiusura del controllo.

Questo metodo viene chiamato dal framework di pagina ASP.NET durante l'analisi e non deve essere chiamato direttamente nel codice.