ControlBuilder.SetTagInnerText(String) 方法

定義

提供控制項標記內部文字給 ControlBuilderProvides 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)

參數

text
String

要提供的文字。The text to be provided.

範例

InDesigner當呼叫方法時,下列範例會使用屬性 NeedsTagInnerTextThe following example uses the InDesigner property when the NeedsTagInnerText method is called. 當控制項附加此產生器時, NeedsTagInnerText 會決定是否要在設計階段透過設計工具存取控制項。When a control has this builder attached to it, the NeedsTagInnerText determines whether the control is being accessed at design-time through a designer. NeedsTagInnerText會傳回屬性的值 InDesigner ,然後 SetTagInnerText 呼叫方法。The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. 如果 InDesigner 屬性設定為 falseException 就會擲回。If the InDesigner property is set to false, an Exception is thrown. 否則,會在呼叫時傳回控制項的內部文字 SetTagInnerTextOtherwise, 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

備註

只有在先前傳回這個方法時,才會呼叫這個方法 NeedsTagInnerText trueThis method is called only if NeedsTagInnerText previously returned true.

適用於