ControlBuilder.InDesigner プロパティ

定義

ControlBuilder がデザイナーで実行されているかどうかを示す値を返します。Returns whether the ControlBuilder is running in the designer.

protected:
 property bool InDesigner { bool get(); };
protected bool InDesigner { get; }
member this.InDesigner : bool
Protected ReadOnly Property InDesigner As Boolean

プロパティ値

ControlBuilder がデザイナーで実行されている場合は true。それ以外の場合は falsetrue if the ControlBuilder is running in the designer; otherwise, false.

次の例ではInDesignerNeedsTagInnerTextメソッドが呼び出されたときにプロパティを使用します。The following example uses the InDesigner property when the NeedsTagInnerText method is called. コントロールにこのビルダーがアタッチされている場合NeedsTagInnerText 、メソッドは、デザイン時にデザイナーを使用してコントロールにアクセスしているかどうかを判断します。When a control has this builder attached to it, the NeedsTagInnerText method determines whether the control is being accessed at design-time through a designer. NeedsTagInnerText InDesignerSetTagInnerTextプロパティの値を返してから、メソッドを呼び出します。The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. プロパティがInDesignerfalse設定されている場合は、がスローされます。ExceptionIf the InDesigner property is set to false, an Exception is thrown. それ以外の場合は、コントロールの内部テキストがSetTagInnerText呼び出し時に返されます。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

適用対象