Freigeben über


ControlDesigner.UsePreviewControl Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob der Steuerelement-Designer ein temporäres Vorschausteuerelement verwendet, um das HTML-Markup zur Entwurfszeit zu generieren.

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

Eigenschaftswert

true, wenn der Steuerelement-Designer eine temporäre Kopie des Steuerelements für die Vorschau zur Entwurfszeit verwendet. Andernfalls false, wenn der Steuerelement-Designer die Component-Eigenschaft für das Steuerelement im Steuerelement-Designer verwendet.

Hinweise

Wenn die UsePreviewControl -Eigenschaft ist true, gibt die ViewControl -Eigenschaft eine temporäre Kopie des Steuerelements zurück. Änderungen am temporären Steuerelement werden nicht im Dokument beibehalten.

Wenn die UsePreviewControl -Eigenschaft ist false, gibt die ViewControl -Eigenschaft eine Instanz der Component -Eigenschaft für das -Steuerelement zurück. Änderungen an der Instanz des Steuerelements werden beibehalten.

Die SupportsPreviewControl Einstellung im SupportsPreviewControlAttribute -Objekt wird verwendet, um den Wert der UsePreviewControl -Eigenschaft festzulegen. Daher bestimmt die Einstellung den SupportsPreviewControl Typ des Steuerelements, das von der ViewControl -Eigenschaft in der Basisklasse ControlDesigner zurückgegeben wird. Wenn in SupportsPreviewControlAttribute der Steuerelement-Designer-Deklaration nicht angegeben ist, entspricht das ControlDesigner Objektverhalten der Angabe der SupportsPreviewControl -Eigenschaft als false.

Hinweise für Vererber

Benutzerdefinierte Designer, die von der ControlDesigner -Klasse abgeleitet sind, können die UsePreviewControl -Eigenschaft überschreiben und das SupportsPreviewControlAttribute Objekt ignorieren. Um anzugeben, dass die ViewControl -Eigenschaft immer eine temporäre Kopie des Steuerelements zurückgibt, überschreiben Sie im Allgemeinen die UsePreviewControl -Eigenschaft, um immer zurückzugeben true. Um anzugeben, dass die ViewControl -Eigenschaft immer eine Instanz des -Steuerelements zurückgibt, überschreiben Sie die UsePreviewControl -Eigenschaft, um immer zurückzugeben false. Beispielsweise leitet die PreviewControlDesigner -Klasse von ab ControlDesigner und gibt immer für die UsePreviewControl -Eigenschaft zurücktrue.

Gilt für:

Weitere Informationen