ControlBuilder.NeedsTagInnerText Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public:
 virtual bool NeedsTagInnerText();

public virtual bool NeedsTagInnerText ();

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

Public Overridable Function NeedsTagInnerText () As Boolean

Gibt zurück

Boolean

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

Beispiele

Im folgenden Beispiel wird die Eigenschaft verwendet, wenn die InDesigner NeedsTagInnerText Methode aufgerufen wird. Wenn ein Steuerelement diesen Generator an ihn angefügt hat, bestimmt dies NeedsTagInnerText , ob das Steuerelement zur Entwurfszeit über einen Designer zugegriffen wird. Der NeedsTagInnerText Wert der InDesigner Eigenschaft wird zurückgegeben, und dann wird die SetTagInnerText Methode aufgerufen. Wenn die InDesigner Eigenschaft auf false"" festgelegt ist, wird eine Exception ausgelöst. Andernfalls wird der innere Text des Steuerelements auf dem SetTagInnerText Anruf zurückgegeben.

[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

Hinweise

Der innere Text ist der Text zwischen dem Öffnen und schließenden Tags des Steuerelements.

Diese Methode wird während der Analyse durch das ASP.NET Seitenframework aufgerufen und soll nicht direkt im Code aufgerufen werden.