ControlBuilder.NeedsTagInnerText-Methode

Bestimmt, ob der Steuerelementgenerator seinen inneren Text abrufen muss. Wenn das der Fall ist, muss die SetTagInnerText-Methode aufgerufen werden. Diese Methode wird vom ASP.NET-Seitenframework aufgerufen.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Function NeedsTagInnerText As Boolean
'Usage
Dim instance As ControlBuilder
Dim returnValue As Boolean

returnValue = instance.NeedsTagInnerText

public virtual bool NeedsTagInnerText ()

public:
virtual bool NeedsTagInnerText ()

public boolean NeedsTagInnerText ()

public function NeedsTagInnerText () : boolean

Rückgabewert

true, wenn der Steuerelementgenerator seinen inneren Text abrufen muss. Der Standardwert ist false.

Hinweise

Der innere Text ist der Text zwischen dem öffnenden und dem schließenden Tag des Steuerelements.

Diese Methode wird vom ASP.NET-Seitenframework während der Analyse aufgerufen und ist nicht für den direkten Aufruf im Code gedacht.

Beispiel

Im folgenden Beispiel wird die InDesigner-Eigenschaft verwendet, wenn die NeedsTagInnerText-Methode aufgerufen wird. Wenn ein Steuerelement mit diesem Generator verknüpft ist, bestimmt NeedsTagInnerText, ob zur Entwurfszeit mit einem Designer auf das Steuerelement zugegriffen wird. NeedsTagInnerText gibt den Wert der InDesigner-Eigenschaft zurück, und anschließend wird die SetTagInnerText-Methode aufgerufen. Wenn die InDesigner-Eigenschaft auf false festgelegt ist, wird eine Exception ausgelöst. Andernfalls wird beim Aufruf von SetTagInnerText der innere Text des Steuerelements zurückgegeben.

<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

[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;
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlBuilder-Klasse
ControlBuilder-Member
System.Web.UI-Namespace