ControlBuilder.SetTagInnerText-Methode

Stellt den inneren Text des Steuerelementtags für den ControlBuilder bereit.

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

Syntax

'Declaration
Public Overridable Sub SetTagInnerText ( _
    text As String _
)
'Usage
Dim instance As ControlBuilder
Dim text As String

instance.SetTagInnerText(text)

public virtual void SetTagInnerText (
    string text
)

public:
virtual void SetTagInnerText (
    String^ text
)

public void SetTagInnerText (
    String text
)

public function SetTagInnerText (
    text : String
)

Parameter

• text
  Der bereitzustellende Text.

Hinweise

Diese Methode wird nur aufgerufen, wenn NeedsTagInnerText vorher true zurückgegeben hat.

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