ControlBuilder.NeedsTagInnerText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bestimmt, ob der Steuerelement-Generator seinen inneren Text abrufen muss. Wenn ja, muss die SetTagInnerText(String) Methode aufgerufen werden. Diese Methode wird vom ASP.NET Seitenframework aufgerufen.
public:
virtual bool NeedsTagInnerText();public virtual bool NeedsTagInnerText();abstract member NeedsTagInnerText : unit -> bool
override this.NeedsTagInnerText : unit -> boolPublic Overridable Function NeedsTagInnerText () As BooleanGibt zurück
true wenn der Steuerelement-Generator seinen inneren Text abrufen muss. Der Standardwert lautet false.
Beispiele
Im folgenden Beispiel wird die InDesigner Eigenschaft verwendet, wenn die NeedsTagInnerText Methode aufgerufen wird. Wenn ein Steuerelement mit diesem Generator verbunden ist, bestimmt dies NeedsTagInnerText , ob über einen Designer auf das Steuerelement zur Entwurfszeit 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" festgelegt ist, wird ein Exception Fehler ausgelöst. Andernfalls wird der innere Text des Steuerelements für den SetTagInnerText Aufruf 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 den öffnenden und schließenden Tags des Steuerelements.
Diese Methode wird während der Analyse vom ASP.NET Seitenframework aufgerufen und soll nicht direkt im Code aufgerufen werden.
