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 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.
