LabelDesigner Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 |
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 |
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) |