ConnectionsZoneDesigner Klasse
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.
Bietet zur Entwurfszeit Unterstützung für ConnectionsZone-Steuerelemente.
public ref class ConnectionsZoneDesigner : System::Web::UI::Design::WebControls::WebParts::ToolZoneDesignerpublic class ConnectionsZoneDesigner : System.Web.UI.Design.WebControls.WebParts.ToolZoneDesignertype ConnectionsZoneDesigner = class
inherit ToolZoneDesignerPublic Class ConnectionsZoneDesigner
Inherits ToolZoneDesigner- Vererbung
-
ConnectionsZoneDesigner
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie zusätzliche Eigenschaften vor einem benutzerdefinierten ConnectionsZone Steuerelement ausgeblendet werden, indem die PreFilterProperties -Methode überschrieben wird.
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.Design.WebControls.WebParts;
using System.ComponentModel;
using System.Collections;
/// <summary>
/// ConnectionsZoneSample provides a blank inheritance of
/// the ConnectionsZone class for the purpose of attaching
/// a custom designer.
/// ConnectionsZoneSampleDesigner shows how to edit the
/// PreFilterProperties() method to hide a specific property
/// at design time.
/// </summary>
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(ConnectionsZoneSampleDesigner))]
public class ConnectionsZoneSample : ConnectionsZone {}
public class ConnectionsZoneSampleDesigner : ConnectionsZoneDesigner
{
// Here is the property we will hide.
string propertyToHide = "BackColor";
protected override void PreFilterProperties(IDictionary properties)
{
// Invoke the base method. This will hide those properties
// specified in ConnectionsZoneDesigner.
base.PreFilterProperties(properties);
// Set attributes to remove it from the property grid and any editors.
Attribute[] newAttributes = new Attribute[]
{ new BrowsableAttribute(false),
new EditorBrowsableAttribute(EditorBrowsableState.Never)};
PropertyDescriptor property = (PropertyDescriptor)properties[propertyToHide];
if (property != null)
{
// Re-create the property with the attributes specified above.
properties[propertyToHide] = TypeDescriptor.CreateProperty(property.ComponentType, property, newAttributes);
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.Design.WebControls.WebParts
Imports System.ComponentModel
Imports System.Collections
' ConnectionsZoneSample provides a blank inheritance of
' the ConnectionsZone class for the purpose of attaching
' a custom designer.
' ConnectionsZoneSampleDesigner shows how to edit the
' PreFilterProperties() method to hide a specific property
' at design time.
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(ConnectionsZoneSampleDesigner))> _
Public Class ConnectionsZoneSample
Inherits ConnectionsZone
End Class
Public Class ConnectionsZoneSampleDesigner
Inherits ConnectionsZoneDesigner
' Here is the property we will hide.
Private propertyToHide As String = "BackColor"
Protected Overrides Sub PreFilterProperties(properties As IDictionary)
' Invoke the base method. This will hide those properties
' specified in ConnectionsZoneDesigner.
MyBase.PreFilterProperties(properties)
' Set attributes to remove it from the property grid and any editors.
Dim newAttributes As Attribute() = New Attribute() {New BrowsableAttribute(False), New EditorBrowsableAttribute(EditorBrowsableState.Never)}
Dim [property] As PropertyDescriptor = DirectCast(properties(propertyToHide), PropertyDescriptor)
If [property] IsNot Nothing Then
' Re-create the property with the attributes specified above.
properties(propertyToHide) = TypeDescriptor.CreateProperty([property].ComponentType, [property], newAttributes)
End If
End Sub
End Class
End Namespace
Hinweise
ConnectionsZoneDesigner stellt eine Entwurfszeitdarstellung eines ConnectionsZone Steuerelements mit einem Menü für den Zugriff auf die AutoFormats Auflistung und die ViewInBrowseMode Eigenschaft bereit, um den Seitenentwicklern zu vereinfachen. Es ist der einzige Zonen-Designer, der keine Designerregionen unterstützt. Dies liegt daran, dass ConnectionsZone Steuerelemente Links verwenden, um Verbindungen anstelle einer Drag-and-Drop-Benutzeroberfläche (UI) zu erstellen.
Die AutoFormats Auflistung und die ViewInBrowseMode Eigenschaft werden beide im Verbenmenü des ConnectionsZone Steuerelements angezeigt. AutoFormats, wenn ausgewählt, stellt eine Auswahl von Farbschemas bereit. Wenn ViewInBrowseMode das Kontrollkästchen aktiviert ist, wird der Inhalt des Steuerelements so angezeigt, wie er im Browser angezeigt wird. Das Steuerelement ist leer, bis eine Verbindung hergestellt wird.
Sie können von ConnectionsZoneDesigner erben, um ein benutzerdefiniertes ConnectionsZone Steuerelement wie bei jedem anderen Steuerelement-Designer zu unterstützen. Sie können die GetDesignTimeHtml -Methode überschreiben, um das Markup zu ändern, das das Steuerelement rendert. Sie können die AutoFormats Auflistung auch überschreiben, um ein DesignerAutoFormatCollection mit einem benutzerdefinierten Schema hinzuzufügen.
Konstruktoren
| ConnectionsZoneDesigner() |
Initialisiert eine neue Instanz der ConnectionsZoneDesigner-Klasse. |
Eigenschaften
| ActionLists |
Ruft die Aktionslistenauflistung für den Zonen-Designer ab. (Geerbt von ToolZoneDesigner) |
| AllowResize |
Ruft einen Wert ab, der angibt, ob die Größe des Steuerelements in der Entwurfszeitumgebung geändert werden kann. (Geerbt von ControlDesigner) |
| AssociatedComponents |
Ruft die Auflistung der Komponenten ab, die der durch den Designer verwalteten Komponente zugeordnet ist. (Geerbt von ComponentDesigner) |
| AutoFormats |
Ruft die Auflistung der vordefinierten automatischen Formatierungsschemas ab, die zur Entwurfszeit für das zugeordnete Steuerelement im Dialogfeld Automat. Formatierung angezeigt werden sollen. |
| Behavior |
Veraltet.
Ruft das DHTML-Verhalten ab, das dem Designer zugeordnet, oder legt dieses fest. (Geerbt von HtmlControlDesigner) |
| Component |
Ruft die Komponente ab, die von diesem Designer entworfen wird. (Geerbt von ComponentDesigner) |
| DataBindings |
Ruft die Datenbindungsauflistung für das aktuelle Steuerelement ab. (Geerbt von HtmlControlDesigner) |
| DataBindingsEnabled |
Ruft einen Wert ab, der angibt, ob Datenbindung vom enthaltenden Bereich für das zugeordnete Steuerelement unterstützt wird. (Geerbt von ControlDesigner) |
| DesignerState |
Ruft ein Objekt ab, mit dem Daten für das zugeordnete Steuerelement zur Entwurfszeit beibehalten werden. (Geerbt von ControlDesigner) |
| DesignTimeElement |
Veraltet.
Ruft das Entwurfszeitobjekt ab, das auf der Entwurfsoberfläche das dem HtmlControlDesigner-Objekt zugeordnete Steuerelement darstellt. (Geerbt von HtmlControlDesigner) |
| DesignTimeElementView |
Veraltet.
Ruft das Ansichtssteuerelement-Objekt für den Steuerelementdesigner ab. (Geerbt von ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Veraltet.
Ruft einen Wert ab, der angibt, ob der Entwurfshost vor dem Aufruf der GetDesignTimeHtml-Methode vollständig geladen sein muss. (Geerbt von ControlDesigner) |
| Expressions |
Ruft die Ausdrucksbindungen für das aktuelle Steuerelement zur Entwurfszeit ab. (Geerbt von HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Ruft einen Wert ab, der angibt, ob die Eigenschaften des zugeordneten Steuerelements ausgeblendet werden, wenn sich das Steuerelement im Vorlagenmodus befindet. (Geerbt von ControlDesigner) |
| ID |
Ruft die ID-Zeichenfolge des Steuerelements ab oder legt diese fest. (Geerbt von ControlDesigner) |
| InheritanceAttribute |
Ruft ein Attribut ab, das den Vererbungstyp der zugeordneten Komponente angibt. (Geerbt von ComponentDesigner) |
| Inherited |
Ruft einen Wert ab, der angibt, ob diese Komponente geerbt wurde. (Geerbt von ComponentDesigner) |
| InTemplateMode |
Ruft einen Wert ab, der angibt, ob sich das Steuerelement im Entwurfshost im Anzeigemodus bzw. im Vorlagenbearbeitungsmodus befindet. Die InTemplateMode-Eigenschaft ist schreibgeschützt. (Geerbt von ControlDesigner) |
| IsDirty |
Veraltet.
Ruft einen Wert ab, der angibt, ob das Webserversteuerelement als geändert markiert ist, oder legt diesen fest. (Geerbt von ControlDesigner) |
| ParentComponent |
Ruft die übergeordnete Komponente für diesen Designer ab. (Geerbt von ComponentDesigner) |
| ReadOnly |
Veraltet.
Ruft einen Wert ab, der angibt, ob die Eigenschaften des Steuerelements zur Entwurfszeit schreibgeschützt sind, oder legt diesen fest. (Geerbt von ControlDesigner) |
| RootDesigner |
Ruft den Steuerelement-Designer für die Web Forms-Seite ab, die das zugeordnete Steuerelement enthält. (Geerbt von ControlDesigner) |
| SetTextualDefaultProperty |
Bietet zur Entwurfszeit Unterstützung für ConnectionsZone-Steuerelemente. (Geerbt von ComponentDesigner) |
| ShadowProperties |
Ruft eine Auflistung von Eigenschaftswerten ab, die Benutzereinstellungen überschreiben. (Geerbt von ComponentDesigner) |
| ShouldCodeSerialize |
Veraltet.
Ruft einen Wert ab, der angibt, ob für das Steuerelement in der CodeBehind-Datei für das aktuelle Entwurfsdokument während der Serialisierung eine Felddeklaration erstellt werden soll. (Geerbt von HtmlControlDesigner) |
| Tag |
Ruft ein Objekt ab, das das HTML-Markupelement für das zugeordnete Steuerelement darstellt. (Geerbt von ControlDesigner) |
| TemplateGroups |
Ruft eine Auflistung vom Vorlagengruppen ab, die jeweils eine oder mehrere Definitionen enthalten. (Geerbt von ControlDesigner) |
| UsePreviewControl |
Ruft einen Wert ab, der angibt, ob der Designer zum Generieren des Entwurfszeitmarkups anstelle des dem Designer tatsächlich zugeordneten Steuerelements eine temporäre Kopie verwenden soll. (Geerbt von WebZoneDesigner) |
| Verbs |
Ruft die Entwurfszeitverben ab, die von der dem Designer zugeordneten Komponente unterstützt werden. (Geerbt von ComponentDesigner) |
| ViewControl |
Ruft ein Webserversteuerelement ab, das für eine Vorschau des Entwurfszeit-HTML-Markups verwendet werden kann, oder legt dieses fest. (Geerbt von ControlDesigner) |
| ViewControlCreated |
Ruft einen Wert ab, der angibt, ob ein |
| ViewInBrowseMode |
Ruft einen Wert ab, der angibt, ob die Webparts-Zone angezeigt wird, wenn sich der Benutzer im Durchsuchen-Anzeigemodus befindet, oder legt diesen Wert fest. (Geerbt von ToolZoneDesigner) |
| Visible |
Ruft einen Wert ab, der angibt, ob das Steuerelement zur Entwurfszeit sichtbar ist. (Geerbt von ControlDesigner) |
Methoden
| CreateErrorDesignTimeHtml(String) |
Erstellt HTML-Markup, um zur Entwurfszeit eine angegebene Fehlermeldung anzuzeigen. (Geerbt von ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Erstellt HTML-Markup, um zur Entwurfszeit eine angegebene Fehlermeldung für eine Ausnahme anzuzeigen. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements anzeigt. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements sowie zusätzliche Anweisungen oder Informationen anzeigt. (Geerbt von ControlDesigner) |
| CreateViewControl() |
Gibt eine Kopie des zugeordneten Steuerelements für die Anzeige oder das Rendern auf der Entwurfsoberfläche zurück. (Geerbt von ControlDesigner) |
| Dispose() |
Gibt alle vom ComponentDesigner verwendeten Ressourcen frei. (Geerbt von ComponentDesigner) |
| Dispose(Boolean) |
Gibt die vom HtmlControlDesigner-Objekt verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Geerbt von HtmlControlDesigner) |
| DoDefaultAction() |
Erstellt eine Methodensignatur in der Quellcodedatei für das Standardereignis der Komponente und verschiebt den Cursor des Benutzers an diese Position. (Geerbt von ComponentDesigner) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBounds() |
Ruft die Koordinaten des Rechtecks ab, das die Begrenzungen des auf der Entwurfsoberfläche angezeigten Steuerelements darstellt. (Geerbt von ControlDesigner) |
| GetDesignTimeHtml() |
Ruft das Markup ab, das für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Ruft das HTML-Markup zum Anzeigen des Steuerelements ab und füllt die Auflistung mit den aktuellen Steuerelement-Designer-Bereichen auf. (Geerbt von ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Gibt den Inhalt für einen bearbeitbaren Bereich der Entwurfszeitansicht des zugeordneten Steuerelements zurück. (Geerbt von ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Ruft das HTML-Markup zum Darstellen eines Webserver-Steuerelements zur Entwurfszeit ab, das zur Laufzeit keine visuelle Darstellung hat. (Geerbt von ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Ruft das HTML-Markup ab, das Informationen über die angegebene Ausnahme bereitstellt. (Geerbt von ControlDesigner) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetPersistenceContent() |
Ruft das dauerhafte innere HTML-Markup des Steuerelements zur Entwurfszeit ab. (Geerbt von ControlDesigner) |
| GetPersistInnerHtml() |
Veraltet.
Ruft das dauerhafte innere HTML-Markup des Steuerelements ab. (Geerbt von ControlDesigner) |
| GetService(Type) |
Versucht, den angegebenen Diensttyp von der Entwurfsmodussite der Komponente des Designers abzurufen. (Geerbt von ComponentDesigner) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetViewRendering() |
Ruft ein Objekt ab, das das Entwurfszeitmarkup für den Inhalt und die Bereiche des zugeordneten Steuerelements enthält. (Geerbt von ControlDesigner) |
| Initialize(IComponent) |
Bindet den Designer an das angegebene ConnectionsZone-Steuerelement. |
| InitializeExistingComponent(IDictionary) |
Initialisiert eine vorhandene Komponente erneut. (Geerbt von ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initialisiert eine neu erstellte Komponente. (Geerbt von ComponentDesigner) |
| InitializeNonDefault() |
Veraltet.
Veraltet.
Initialisiert die Einstellungen für eine importierte Komponente, die bereits mit Einstellungen initialisiert wurde, die nicht der Standardeinstellung entsprechen. (Geerbt von ComponentDesigner) |
| Invalidate() |
Macht den gesamten Bereich des auf der Entwurfsoberfläche angezeigten Steuerelements ungültig und weist den visuellen Designer an, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| Invalidate(Rectangle) |
Macht den angegebenen Bereich des auf der Entwurfsoberfläche angezeigten Steuerelements ungültig und weist den visuellen Designer an, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Ruft das InheritanceAttribute des angegebenen ComponentDesigner ab. (Geerbt von ComponentDesigner) |
| IsPropertyBound(String) |
Veraltet.
Ruft einen Wert ab, der angibt, ob die angegebene Eigenschaft des zugeordneten Steuerelements datengebunden ist. (Geerbt von ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Verwendet den bereitgestellten Ressourcenwriter, um die lokalisierbaren Eigenschaften des zugehörigen Steuerelements in einer Ressource im Entwurfshost beizubehalten. (Geerbt von ControlDesigner) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Wird aufgerufen, wenn ein vordefiniertes Schema für die automatische Formatierung auf das zugeordnete Steuerelement angewendet wurde. (Geerbt von ControlDesigner) |
| OnBehaviorAttached() |
Wird aufgerufen, wenn der Steuerelement-Designer an ein Behavior-Objekt angefügt wird. (Geerbt von ControlDesigner) |
| OnBehaviorDetaching() |
Veraltet.
Wird aufgerufen, wenn die Zuordnung eines Verhaltens zum Element aufgehoben wird. (Geerbt von HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Veraltet.
Wird aufgerufen, wenn die Datenbindungsauflistung geändert wird. (Geerbt von ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Wird vom Entwurfshost aufgerufen, wenn der Benutzer zur Entwurfszeit auf das zugeordnete Steuerelement klickt. (Geerbt von ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Wird aufgerufen, wenn das zugehörige Steuerelement geändert wird. (Geerbt von ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Stellt die Methode dar, die das ComponentChanging-Ereignis des zugeordneten Steuerelements behandelt. (Geerbt von ControlDesigner) |
| OnControlResize() |
Veraltet.
Wird aufgerufen, wenn die Größe des zugeordneten Webserversteuerelements zur Entwurfszeit im Entwurfshost geändert worden ist. (Geerbt von ControlDesigner) |
| OnPaint(PaintEventArgs) |
Wird aufgerufen, wenn der Steuerelement-Designer das zugeordnete Steuerelement auf der Entwurfsoberfläche zeichnet, wenn der CustomPaint-Wert |
| OnSetComponentDefaults() |
Veraltet.
Veraltet.
Legt die Standardeigenschaften für die Komponente fest. (Geerbt von ComponentDesigner) |
| OnSetParent() |
Ermöglicht die Ausführung zusätzlicher Verarbeitungsschritte, wenn das zugeordnete Steuerelement an ein übergeordnetes Steuerelement angefügt wird. (Geerbt von HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Attributen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Ereignissen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Eigenschaften, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Ermöglicht einem Designer das Hinzufügen zu dem Satz von Attributen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Legt die Liste von Ereignissen fest, die zur Entwurfszeit für das TypeDescriptor-Objekt der Komponente verfügbar gemacht werden. (Geerbt von HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Blendet eine voreingestellte Gruppe von Eigenschaften zur Entwurfszeit aus. |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Benachrichtigt IComponentChangeService darüber, dass diese Komponente geändert wurde. (Geerbt von ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Benachrichtigt IComponentChangeService darüber, dass diese Komponente gerade geändert wird. (Geerbt von ComponentDesigner) |
| RaiseResizeEvent() |
Veraltet.
Löst das OnControlResize()-Ereignis aus. (Geerbt von ControlDesigner) |
| RegisterClone(Object, Object) |
Registriert interne Daten in einem geklonten Steuerelement. (Geerbt von ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt eines editierbaren Bereichs des Steuerelements zur Entwurfszeit an. (Geerbt von ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt für einen editierbaren Bereich der Entwurfszeitansicht des Steuerelements an. (Geerbt von ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Weist dem angegebenen Flagwert die angegebene bitweise ViewFlags-Enumeration zu. (Geerbt von ControlDesigner) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| UpdateDesignTimeHtml() |
Aktualisiert das Entwurfszeit-HTML-Markup für das zugeordnete Webserversteuerelement durch Aufruf der GetDesignTimeHtml-Methode. (Geerbt von ControlDesigner) |
