ControlBuilder.SetTagInnerText(String) Methode

Definition

Stellt den inneren Text des Steuerelementtags für den ControlBuilder bereit.Provides the ControlBuilder with the inner text of the control tag.

public:
 virtual void SetTagInnerText(System::String ^ text);
public virtual void SetTagInnerText (string text);
abstract member SetTagInnerText : string -> unit
override this.SetTagInnerText : string -> unit
Public Overridable Sub SetTagInnerText (text As String)

Parameter

text
String

Der bereitzustellende Text.The text to be provided.

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

Diese Methode wird nur aufgerufen, NeedsTagInnerText wenn zuvor truezurückgegeben wurde.This method is called only if NeedsTagInnerText previously returned true.

Gilt für: