ControlBuilder.NeedsTagInnerText Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Determina si el generador de controles necesita obtener su texto interno. Si es así, debe llamarse al método SetTagInnerText(String). El marco de trabajo de la página ASP.NET llama a este método.

public:
 virtual bool NeedsTagInnerText();

public virtual bool NeedsTagInnerText ();

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

Public Overridable Function NeedsTagInnerText () As Boolean

Devoluciones

Boolean

true si el generador de controles necesita obtener su texto interno. De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se usa la InDesigner propiedad cuando se llama al NeedsTagInnerText método . Cuando un control tiene asociado este generador, NeedsTagInnerText determina si se accede al control en tiempo de diseño a través de un diseñador. NeedsTagInnerText devuelve el valor de la InDesigner propiedad y, a continuación, se llama al SetTagInnerText método . Si la InDesigner propiedad se establece falseen , se produce una Exception excepción . De lo contrario, se devuelve el texto interno del control en la SetTagInnerText llamada.

[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

Comentarios

El texto interno es el texto entre las etiquetas de apertura y cierre del control.

El marco de página de ASP.NET llama a este método durante el análisis y no está pensado para llamarse directamente en el código.