ControlBuilder.NeedsTagInnerText Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Détermine si le générateur de contrôles a besoin d'obtenir son texte interne. Si c'est le cas, il faut appeler la méthode SetTagInnerText(String). Cette méthode est appelée par l’infrastructure de page 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

Retours

Boolean

true si le générateur de contrôles a besoin d'obtenir son texte interne. La valeur par défaut est false.

Exemples

L’exemple suivant utilise la InDesigner propriété lorsque la NeedsTagInnerText méthode est appelée. Lorsqu’un contrôle est attaché à ce générateur, il NeedsTagInnerText détermine si le contrôle est accessible au moment du design via un concepteur. Retourne NeedsTagInnerText la valeur de la InDesigner propriété, puis la SetTagInnerText méthode est appelée. Si la InDesigner propriété est définie sur false, une Exception levée est levée. Sinon, le texte interne du contrôle est retourné sur l’appel SetTagInnerText .

[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

Remarques

Le texte interne est le texte entre les balises d’ouverture et de fermeture du contrôle.

Cette méthode est appelée par l’infrastructure de page ASP.NET pendant l’analyse et n’est pas destinée à être appelée directement dans votre code.