ControlBuilder.NeedsTagInnerText Methode

Definition

Bestimmt, ob der Steuerelementgenerator seinen inneren Text abrufen muss.Determines if the control builder needs to get its inner text. Wenn das der Fall ist, muss die SetTagInnerText(String)-Methode aufgerufen werden.If so, the SetTagInnerText(String) method must be called. Diese Methode wird durch das ASP.NET-Seitenframework aufgerufen.This method is called by the ASP.NET page framework.

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

true, wenn der Steuerelementgenerator seinen inneren Text abrufen muss.true if the control builder needs to get its inner text. Die Standardeinstellung ist false.The default is false.

Beispiele

Im folgenden Beispiel wird die InDesigner -Eigenschaft verwendet NeedsTagInnerText , wenn die-Methode aufgerufen wird.The following example uses the InDesigner property when the NeedsTagInnerText method is called. Wenn ein Steuerelement diesen Generator angefügt hat, NeedsTagInnerText bestimmt, ob zur Entwurfszeit über einen Designer auf das Steuerelement zugegriffen wird.When a control has this builder attached to it, the NeedsTagInnerText determines whether the control is being accessed at design-time through a designer. Gibt den Wert InDesigner der-Eigenschaft zurück, und dann wird SetTagInnerText die-Methode aufgerufen. NeedsTagInnerTextThe NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. Wenn die InDesigner -Eigenschaft auf falsefestgelegt ist Exception , wird eine ausgelöst.If the InDesigner property is set to false, an Exception is thrown. Andernfalls wird der innere Text des Steuer Elements bei dem SetTagInnerText -Befehl zurückgegeben.Otherwise, the inner text of the control is returned on the SetTagInnerText call.

[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 öffnenden und dem schließenden Tag des-Steuer Elements.The inner text is the text between the opening and closing tags of the control.

Diese Methode wird während der-Verarbeitung vom ASP.NET-Seiten Framework aufgerufen und ist nicht für den direkten Aufruf im Code vorgesehen.This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

Gilt für: