ControlBuilder.InDesigner-Eigenschaft

Gibt zurück, ob der ControlBuilder im Designer ausgeführt wird.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected ReadOnly Property InDesigner As Boolean
'Usage
Dim value As Boolean

value = Me.InDesigner

protected bool InDesigner { get; }

protected:
property bool InDesigner {
    bool get ();
}

/** @property */
protected boolean get_InDesigner ()

protected function get InDesigner () : boolean

Eigenschaftenwert

true, wenn der ControlBuilder im Designer ausgeführt wird, andernfalls false.

Beispiel

Im folgenden Beispiel wird die InDesigner-Eigenschaft verwendet, wenn die NeedsTagInnerText-Methode aufgerufen wird. Wenn ein Steuerelement mit diesem Generator verknüpft ist, bestimmt die NeedsTagInnerText-Methode, ob zur Entwurfszeit mit einem Designer auf das Steuerelement zugegriffen wird. NeedsTagInnerText gibt den Wert der InDesigner-Eigenschaft zurück, und anschließend wird die SetTagInnerText-Methode aufgerufen. Wenn die InDesigner-Eigenschaft auf false festgelegt ist, wird eine Exception ausgelöst. Andernfalls wird beim Aufruf von SetTagInnerText der innere Text des Steuerelements zurückgegeben.

<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

[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;
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlBuilder-Klasse
ControlBuilder-Member
System.Web.UI-Namespace