ControlDesigner.UsePreviewControl Eigenschaft
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.
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 : boolProtected Overridable ReadOnly Property UsePreviewControl As BooleanEigenschaftswert
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 Eigenschaft lautettrue, gibt die UsePreviewControl ViewControl Eigenschaft eine temporäre Kopie des Steuerelements zurück. Änderungen am temporären Steuerelement werden nicht im Dokument beibehalten.
Wenn die Eigenschaft lautetfalse, gibt die UsePreviewControl 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 SupportsPreviewControl Einstellung den Typ des Steuerelements, das von der Eigenschaft in der ViewControl Basisklasse ControlDesigner zurückgegeben wird. Wenn dies SupportsPreviewControlAttribute nicht in der Steuerelement-Designer-Deklaration angegeben ist, entspricht das ControlDesigner Objektverhalten dem Angeben der SupportsPreviewControl Eigenschaft als false.
Hinweise für Vererber
Benutzerdefinierte Designer, die von der ControlDesigner Klasse abgeleitet werden, können die UsePreviewControl Eigenschaft überschreiben und das SupportsPreviewControlAttribute Objekt ignorieren. Wenn Sie im Allgemeinen angeben möchten, dass die ViewControl Eigenschaft immer eine temporäre Kopie des Steuerelements zurückgibt, überschreiben Sie 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. Die Klasse leitet sich beispielsweise PreviewControlDesigner von der ControlDesigner Eigenschaft ab und gibt immer für die UsePreviewControl Eigenschaft zurücktrue.