Udostępnij za pośrednictwem


LabelDesigner Klasa

Definicja

Zapewnia obsługę czasu projektowania w projektancie wizualnym dla kontrolki Label serwera sieci Web.

public ref class LabelDesigner : System::Web::UI::Design::TextControlDesigner
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
type LabelDesigner = class
    inherit TextControlDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type LabelDesigner = class
    inherit TextControlDesigner
Public Class LabelDesigner
Inherits TextControlDesigner
Dziedziczenie
Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak uzyskać SampleLabel kontrolę z kontrolki Label i za pomocą DesignerAttribute atrybutu kontrolki SampleLabel skojarzyć ją z klasą SampleLabelDesigner .

Przykładowy kod pochodzi SampleLabelDesigner również z LabelDesigner klasy . Zastępuje metodę GetDesignTimeHtml , aby ustawić BorderStyle właściwość na Dashed, jeśli oryginalna BorderStyleNotSet wartość to lub None . Zwiększa to widoczność skojarzonej kontrolki w czasie projektowania.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The SampleLabel is a copy of the Label.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.SampleLabelDesigner))]
    public class SampleLabel : Label
    {
    } // SampleLabel

    // Override members of the LabelDesigner.
    public class SampleLabelDesigner : LabelDesigner
    {
        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Make the control more visible in the designer.  If the border 
            // style is None or NotSet, change the border to a dashed line. 
            SampleLabel sampleLabel = (SampleLabel)Component;
            string designTimeMarkup = null;

            // Check if the border style should be changed.
            if (sampleLabel.BorderStyle == BorderStyle.NotSet ||
                sampleLabel.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = sampleLabel.BorderStyle;

                try
                {
                    // Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed;

                    // Call the base method to generate the markup.
                    designTimeMarkup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    // If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml
    } // SampleLabelDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The SampleLabel is a copy of the Label.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.SampleLabelDesigner))> _
    Public Class SampleLabel
        Inherits Label
    End Class

    ' Override members of the LabelDesigner.
    Public Class SampleLabelDesigner
        Inherits LabelDesigner

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Make the control more visible in the designer.  If the border 
            ' style is None or NotSet, change the border to a dashed line. 
            Dim sampleLabel As SampleLabel = CType(Component, SampleLabel)
            Dim designTimeMarkup As String = Nothing

            ' Check if the border style should be changed.
            If (sampleLabel.BorderStyle = BorderStyle.NotSet Or _
                sampleLabel.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = sampleLabel.BorderStyle

                Try
                    ' Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed

                    ' Call the base method to generate the markup.
                    designTimeMarkup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    ' If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle
                End Try

            Else
                ' Call the base method to generate the markup.
                designTimeMarkup = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeMarkup
        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Uwagi

Kontrolka Label umożliwia programowe wyświetlanie tekstu na stronie sieci Web.

W projektancie wizualizacji po przełączeniu się z widoku Źródło na projekt kod źródłowy znaczników opisujący kontrolkę Label jest analizowany, a na powierzchni projektowej jest tworzona wersja kontrolki w czasie projektowania. Po przełączeniu się z powrotem do widoku źródła kontrolka czasu projektowania jest utrwalana w kodzie źródłowym znaczników i edytowana w znacznikach dla strony sieci Web. Klasa LabelDesigner zapewnia obsługę czasu projektowania dla kontrolki Label .

Metoda jest wywoływana OnComponentChanged w przypadku zmiany skojarzonej Label kontrolki.

Konstruktory

LabelDesigner()

Inicjuje nowe wystąpienie klasy LabelDesigner.

Właściwości

ActionLists

Pobiera kolekcję listy akcji dla projektanta kontrolek.

(Odziedziczone po ControlDesigner)
AllowResize

Pobiera wartość wskazującą, czy można zmienić rozmiar kontrolki w środowisku czasu projektowania.

(Odziedziczone po ControlDesigner)
AssociatedComponents

Pobiera kolekcję składników skojarzonych ze składnikiem zarządzanym przez projektanta.

(Odziedziczone po ComponentDesigner)
AutoFormats

Pobiera kolekcję wstępnie zdefiniowanych schematów automatycznego formatowania do wyświetlania w oknie dialogowym Automatyczne formatowanie skojarzonej kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
Behavior
Przestarzałe.

Pobiera lub ustawia zachowanie DHTML skojarzone z projektantem.

(Odziedziczone po HtmlControlDesigner)
Component

Pobiera składnik, który projektuje ten projektant.

(Odziedziczone po ComponentDesigner)
DataBindings

Pobiera kolekcję powiązań danych dla bieżącej kontrolki.

(Odziedziczone po HtmlControlDesigner)
DataBindingsEnabled

Pobiera wartość wskazującą, czy powiązanie danych jest obsługiwane przez region zawierający skojarzona kontrolka.

(Odziedziczone po ControlDesigner)
DesignerState

Pobiera obiekt używany do utrwalania danych skojarzonej kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
DesignTimeElement
Przestarzałe.

Pobiera obiekt czasu projektowania reprezentujący kontrolkę skojarzona z obiektem HtmlControlDesigner na powierzchni projektowej.

(Odziedziczone po HtmlControlDesigner)
DesignTimeElementView
Przestarzałe.

Pobiera obiekt kontrolki widoku dla projektanta kontrolek.

(Odziedziczone po ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Przestarzałe.

Pobiera wartość wskazującą, czy host projektu musi zakończyć ładowanie, zanim będzie można wywołać metodę GetDesignTimeHtml .

(Odziedziczone po ControlDesigner)
Expressions

Pobiera powiązania wyrażeń dla bieżącej kontrolki w czasie projektowania.

(Odziedziczone po HtmlControlDesigner)
HidePropertiesInTemplateMode

Pobiera wartość wskazującą, czy właściwości skojarzonej kontrolki są ukryte, gdy kontrolka jest w trybie szablonu.

(Odziedziczone po ControlDesigner)
ID

Pobiera lub ustawia ciąg identyfikatora dla kontrolki.

(Odziedziczone po ControlDesigner)
InheritanceAttribute

Pobiera atrybut wskazujący typ dziedziczenia skojarzonego składnika.

(Odziedziczone po ComponentDesigner)
Inherited

Pobiera wartość wskazującą, czy ten składnik jest dziedziczony.

(Odziedziczone po ComponentDesigner)
InTemplateMode

Pobiera wartość wskazującą, czy kontrolka jest w trybie wyświetlania szablonu lub edytowania na hoście projektu. Właściwość InTemplateMode jest tylko do odczytu.

(Odziedziczone po ControlDesigner)
IsDirty
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web została oznaczona jako zmieniona.

(Odziedziczone po ControlDesigner)
ParentComponent

Pobiera składnik nadrzędny dla tego projektanta.

(Odziedziczone po ComponentDesigner)
ReadOnly
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy właściwości kontrolki są tylko do odczytu w czasie projektowania.

(Odziedziczone po ControlDesigner)
RootDesigner

Pobiera projektanta kontrolek dla strony Formularze sieci Web zawierającej skojarzona kontrolkę.

(Odziedziczone po ControlDesigner)
SetTextualDefaultProperty

Zapewnia obsługę czasu projektowania w projektancie wizualnym dla kontrolki Label serwera sieci Web.

(Odziedziczone po ComponentDesigner)
ShadowProperties

Pobiera kolekcję wartości właściwości, które zastępują ustawienia użytkownika.

(Odziedziczone po ComponentDesigner)
ShouldCodeSerialize
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy podczas serializacji utworzyć deklarację pola dla kontrolki w pliku za kodem dla bieżącego dokumentu projektowego.

(Odziedziczone po HtmlControlDesigner)
Tag

Pobiera obiekt reprezentujący element znaczników HTML dla skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
TemplateGroups

Pobiera kolekcję grup szablonów zawierającą co najmniej jedną definicję szablonu.

(Odziedziczone po ControlDesigner)
UsePreviewControl

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

(Odziedziczone po ControlDesigner)
Verbs

Pobiera czasy projektowania obsługiwane przez składnik skojarzony z projektantem.

(Odziedziczone po ComponentDesigner)
ViewControl

Pobiera lub ustawia kontrolkę serwera sieci Web, która może służyć do wyświetlania podglądu znaczników HTML w czasie projektowania.

(Odziedziczone po ControlDesigner)
ViewControlCreated

Pobiera lub ustawia wartość wskazującą, czy kontrolka View została utworzona do wyświetlania na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
Visible

Pobiera wartość wskazującą, czy kontrolka jest widoczna w czasie projektowania.

(Odziedziczone po ControlDesigner)

Metody

CreateErrorDesignTimeHtml(String)

Tworzy znaczniki HTML w celu wyświetlenia określonego komunikatu o błędzie w czasie projektowania.

(Odziedziczone po ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)

Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie wyjątku w czasie projektowania.

(Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Udostępnia prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki.

(Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki, a także dodatkowe określone instrukcje lub informacje.

(Odziedziczone po ControlDesigner)
CreateViewControl()

Zwraca kopię skojarzonej kontrolki do wyświetlania lub renderowania na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
Dispose()

Zwalnia wszelkie zasoby używane przez element ComponentDesigner.

(Odziedziczone po ComponentDesigner)
Dispose(Boolean)

Zwalnia niezarządzane zasoby, które są używane przez HtmlControlDesigner obiekt i opcjonalnie zwalnia zarządzane zasoby.

(Odziedziczone po HtmlControlDesigner)
DoDefaultAction()

Tworzy podpis metody w pliku kodu źródłowego dla zdarzenia domyślnego w składniku i przechodzi kursor użytkownika do tej lokalizacji.

(Odziedziczone po ComponentDesigner)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetBounds()

Pobiera współrzędne prostokąta reprezentującego granice kontrolki wyświetlane na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
GetDesignTimeHtml()

Pobiera znaczniki używane do reprezentowania skojarzonej kontrolki w czasie projektowania.

(Odziedziczone po TextControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)

Pobiera znacznik HTML, aby wyświetlić kontrolkę i wypełnić kolekcję bieżącymi regionami projektanta kontrolek.

(Odziedziczone po ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

Zwraca zawartość dla edytowalnego regionu widoku czasu projektowania skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
GetEmptyDesignTimeHtml()

Pobiera znaczniki HTML, aby reprezentować kontrolkę serwera sieci Web w czasie projektowania, która nie będzie miała wizualnej reprezentacji w czasie wykonywania.

(Odziedziczone po ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Pobiera znacznik HTML, który zawiera informacje o określonym wyjątku.

(Odziedziczone po ControlDesigner)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetPersistenceContent()

Pobiera trwały wewnętrzny znacznik HTML kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
GetPersistInnerHtml()

Pobiera znaczniki do utrwalonego dla wewnętrznych tagów kontrolki.

(Odziedziczone po TextControlDesigner)
GetService(Type)

Próbuje pobrać określony typ usługi z witryny trybu projektowania składnika projektanta.

(Odziedziczone po ComponentDesigner)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
GetViewRendering()

Pobiera obiekt zawierający znacznik czasu projektowania zawartości i regionów skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
Initialize(IComponent)

Inicjuje projektanta z określonym składnikiem.

(Odziedziczone po TextControlDesigner)
InitializeExistingComponent(IDictionary)

Ponownie inicjuje istniejący składnik.

(Odziedziczone po ComponentDesigner)
InitializeNewComponent(IDictionary)

Inicjuje nowo utworzony składnik.

(Odziedziczone po ComponentDesigner)
InitializeNonDefault()
Przestarzałe.
Przestarzałe.

Inicjuje ustawienia zaimportowanego składnika, który jest już inicjowany do ustawień innych niż domyślne.

(Odziedziczone po ComponentDesigner)
Invalidate()

Unieważnia cały obszar kontrolki wyświetlanej na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki.

(Odziedziczone po ControlDesigner)
Invalidate(Rectangle)

Unieważnia określony obszar kontrolki wyświetlanej na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki.

(Odziedziczone po ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

InheritanceAttribute Pobiera określony ComponentDesignerelement .

(Odziedziczone po ComponentDesigner)
IsPropertyBound(String)
Przestarzałe.

Pobiera wartość wskazującą, czy określona właściwość skojarzonej kontrolki jest powiązana z danymi.

(Odziedziczone po ControlDesigner)
Localize(IDesignTimeResourceWriter)

Używa dostarczonego składnika zapisywania zasobów do utrwalania zlokalizowanych właściwości skojarzonej kontrolki z zasobem na hoście projektu.

(Odziedziczone po ControlDesigner)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnAutoFormatApplied(DesignerAutoFormat)

Wywoływana, gdy wstępnie zdefiniowany schemat formatowania automatycznego został zastosowany do skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
OnBehaviorAttached()

Wywoływane, gdy projektant kontrolek jest dołączony do obiektu Zachowanie.

(Odziedziczone po ControlDesigner)
OnBehaviorDetaching()
Przestarzałe.

Wywoływane, gdy zachowanie nie jest skojarzone z elementem.

(Odziedziczone po HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Przestarzałe.

Wywoływane po zmianie kolekcji powiązania danych.

(Odziedziczone po ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Wywoływane przez hosta projektu, gdy użytkownik kliknie skojarzą kontrolkę w czasie projektowania.

(Odziedziczone po ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Wywoływana, gdy istnieje zmiana skojarzonej kontrolki.

OnComponentChanged(Object, ComponentChangedEventArgs)

Wywoływana, gdy skojarzona kontrolka ulegnie zmianie.

(Odziedziczone po ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Reprezentuje metodę, która będzie obsługiwać ComponentChanging zdarzenie dla skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
OnControlResize()
Przestarzałe.

Wywoływana po zmianie rozmiaru skojarzonej kontrolki serwera sieci Web na hoście projektu w czasie projektowania.

(Odziedziczone po ControlDesigner)
OnPaint(PaintEventArgs)

Wywoływana, gdy projektant kontrolek rysuje skojarzona kontrolkę na powierzchni projektowej, jeśli CustomPaint wartość to true.

(Odziedziczone po ControlDesigner)
OnSetComponentDefaults()
Przestarzałe.
Przestarzałe.

Ustawia domyślne właściwości składnika.

(Odziedziczone po ComponentDesigner)
OnSetParent()

Zapewnia sposób wykonywania dodatkowego przetwarzania, gdy skojarzona kontrolka jest dołączona do kontrolki nadrzędnej.

(Odziedziczone po HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu atrybutów, które uwidacznia za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PostFilterEvents(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu zdarzeń udostępnianych za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PostFilterProperties(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu właściwości uwidacznianych za pomocą elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PreFilterAttributes(IDictionary)

Umożliwia projektantowi dodanie do zestawu atrybutów uwidacznianych za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PreFilterEvents(IDictionary)

Ustawia listę zdarzeń, które są uwidocznione w czasie projektowania dla TypeDescriptor obiektu składnika.

(Odziedziczone po HtmlControlDesigner)
PreFilterProperties(IDictionary)

Dodaje właściwości do siatki Właściwości lub usuwa je w hoście projektu w czasie projektowania lub udostępnia nowe właściwości czasu projektowania, które mogą odpowiadać właściwościom skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

Powiadamia o IComponentChangeService zmianie tego składnika.

(Odziedziczone po ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Powiadamia o IComponentChangeService zmianie tego składnika.

(Odziedziczone po ComponentDesigner)
RaiseResizeEvent()
Przestarzałe.

OnControlResize() Zgłasza zdarzenie.

(Odziedziczone po ControlDesigner)
RegisterClone(Object, Object)

Rejestruje dane wewnętrzne w sklonowanej kontrolce.

(Odziedziczone po ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Określa zawartość edytowalnego regionu kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

Określa zawartość regionu edytowalnego w widoku czasu projektowania kontrolki.

(Odziedziczone po ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Przypisuje określoną wyliczenie bitowe ViewFlags do określonej wartości flagi.

(Odziedziczone po ControlDesigner)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
UpdateDesignTimeHtml()

Odświeża znacznik HTML czasu projektowania dla skojarzonej kontrolki serwera sieci Web, wywołując metodę GetDesignTimeHtml .

(Odziedziczone po ControlDesigner)

Jawne implementacje interfejsu

IDesignerFilter.PostFilterAttributes(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterAttributes(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterEvents(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterProperties(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterAttributes(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterEvents(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterProperties(IDictionary) .

(Odziedziczone po ComponentDesigner)
ITreeDesigner.Children

Aby uzyskać opis tego elementu członkowskiego, zobacz Children właściwość .

(Odziedziczone po ComponentDesigner)
ITreeDesigner.Parent

Aby uzyskać opis tego elementu członkowskiego, zobacz Parent właściwość .

(Odziedziczone po ComponentDesigner)

Dotyczy

Zobacz też