ControlDesigner.UsePreviewControl Właściwość

Definicja

Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znacznika HTML w czasie projektowania.

C#
protected virtual bool UsePreviewControl { get; }

Wartość właściwości

true, jeśli projektant kontrolek używa tymczasowej kopii kontrolki do podglądu w czasie projektowania; w przeciwnym razie , falsejeśli projektant kontrolek używa Component właściwości dla kontrolki zawartej w projektancie kontrolek.

Uwagi

UsePreviewControl Jeśli właściwość ma truewartość , ViewControl właściwość zwraca tymczasową kopię kontrolki. Zmiany w kontrolce tymczasowej nie są utrwalane w dokumencie.

UsePreviewControl Jeśli właściwość ma falsewartość , ViewControl właściwość zwraca wystąpienie Component właściwości dla kontrolki. Zmiany w wystąpieniu kontrolki są utrwalane.

Ustawienie SupportsPreviewControl w SupportsPreviewControlAttribute obiekcie służy do ustawiania wartości UsePreviewControl właściwości. W związku z tym SupportsPreviewControl ustawienie określa typ kontrolki zwracanej przez ViewControl właściwość w klasie bazowej ControlDesigner . Jeśli właściwość SupportsPreviewControlAttribute nie jest określona w deklaracji projektanta kontrolek, ControlDesigner zachowanie obiektu jest równoważne określeniu SupportsPreviewControl właściwości jako false.

Uwagi dotyczące dziedziczenia

Projektanci niestandardowi, którzy pochodzą z ControlDesigner klasy, mogą zastąpić UsePreviewControl właściwość i zignorować SupportsPreviewControlAttribute obiekt. Ogólnie rzecz biorąc, aby wskazać, że ViewControl właściwość zawsze zwraca tymczasową kopię kontrolki, należy zastąpić UsePreviewControl właściwość , aby zawsze zwracała wartość true. Aby wskazać, że ViewControl właściwość zawsze zwraca wystąpienie kontrolki, zastąpij UsePreviewControl właściwość , aby zawsze zwracała wartość false. Na przykład PreviewControlDesigner klasa pochodzi z ControlDesigner klasy i zawsze zwraca true wartość dla UsePreviewControl właściwości .

Dotyczy

Produkt Wersje
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też