ConnectionsZoneDesigner 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对 ConnectionsZone 控件的设计时支持。
public ref class ConnectionsZoneDesigner : System::Web::UI::Design::WebControls::WebParts::ToolZoneDesigner
public class ConnectionsZoneDesigner : System.Web.UI.Design.WebControls.WebParts.ToolZoneDesigner
type ConnectionsZoneDesigner = class
inherit ToolZoneDesigner
Public Class ConnectionsZoneDesigner
Inherits ToolZoneDesigner
- 继承
-
ConnectionsZoneDesigner
示例
下面的代码示例演示如何通过重写 PreFilterProperties 方法在自定义ConnectionsZone控件中隐藏其他属性。
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
注解
ConnectionsZoneDesigner 为方便页面开发人员使用菜单提供控件的设计时表示形式 ConnectionsZone ,用于访问 AutoFormats 集合和 ViewInBrowseMode 属性。 它是唯一不支持设计器区域的区域设计器。 这是因为 ConnectionsZone 控件使用链接来创建连接,而不是使用拖放用户界面 (UI) 。
集合 AutoFormats 和 ViewInBrowseMode 属性都显示在 控件的 ConnectionsZone 谓词菜单上。 AutoFormats选中后,提供一系列配色方案。 ViewInBrowseMode选中该复选框后,将显示控件在浏览器中显示的内容;在建立连接之前,该控件将为空。
可以继承自 ConnectionsZoneDesigner 以支持自定义 ConnectionsZone 控件,就像任何其他控件设计器一样。 可以重写 方法以 GetDesignTimeHtml 更改呈现控件的标记。 还可以重写 集合以 AutoFormats 使用自定义方案添加 DesignerAutoFormatCollection 。
构造函数
ConnectionsZoneDesigner() |
初始化 ConnectionsZoneDesigner 类的新实例。 |
属性
ActionLists |
获取区域设计器的操作列表集合。 (继承自 ToolZoneDesigner) |
AllowResize |
获取一个值,该值指示是否可以在设计时环境中调整控件的大小。 (继承自 ControlDesigner) |
AssociatedComponents |
获取与设计器所管理的组件关联的组件集合。 (继承自 ComponentDesigner) |
AutoFormats |
获取预定义自动格式设置方案的集合,这些方案将在设计时显示于关联控件的“自动套用格式”对话框中。 |
Behavior |
已过时.
获取或设置与设计器关联的 DHTML 行为。 (继承自 HtmlControlDesigner) |
Component |
获取此设计器正在设计的组件。 (继承自 ComponentDesigner) |
DataBindings |
获取当前控件的数据绑定集合。 (继承自 HtmlControlDesigner) |
DataBindingsEnabled |
获取一个值,该值指示包含关联控件的区域是否支持数据绑定。 (继承自 ControlDesigner) |
DesignerState |
获取用于在设计时保持关联控件数据的对象。 (继承自 ControlDesigner) |
DesignTimeElement |
已过时.
获取一个设计时对象,该对象表示与设计图面上的 HtmlControlDesigner 对象关联的控件。 (继承自 HtmlControlDesigner) |
DesignTimeElementView |
已过时.
获取控件设计器的视图控件对象。 (继承自 ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
已过时.
获取一个值,该值指示是否必须在设计宿主完成加载之后才能调用 GetDesignTimeHtml 方法。 (继承自 ControlDesigner) |
Expressions |
获取当前控件在设计时的表达式绑定。 (继承自 HtmlControlDesigner) |
HidePropertiesInTemplateMode |
获取一个值,该值指示当控件处于模板模式时,关联控件的属性是否被隐藏。 (继承自 ControlDesigner) |
ID |
获取或设置控件的 ID 字符串。 (继承自 ControlDesigner) |
InheritanceAttribute |
获取一个特性,该特性指示关联组件的继承类型。 (继承自 ComponentDesigner) |
Inherited |
获取一个值,该值指示是否继承此组件。 (继承自 ComponentDesigner) |
InTemplateMode |
获取一个值,该值指示控件在设计宿主中是否处于模板查看模式或模板编辑模式之一。 InTemplateMode 属性为只读。 (继承自 ControlDesigner) |
IsDirty |
已过时.
获取或设置一个值,该值指示 Web 服务器控件是否已被标记为已更改。 (继承自 ControlDesigner) |
ParentComponent |
获取此设计器的父组件。 (继承自 ComponentDesigner) |
ReadOnly |
已过时.
获取或设置一个值,该值指示控件的属性在设计时是否为只读。 (继承自 ControlDesigner) |
RootDesigner |
获取包含关联控件的 Web 窗体页的控件设计器。 (继承自 ControlDesigner) |
SetTextualDefaultProperty |
提供对 ConnectionsZone 控件的设计时支持。 (继承自 ComponentDesigner) |
ShadowProperties |
获取重写用户设置的属性值的集合。 (继承自 ComponentDesigner) |
ShouldCodeSerialize |
已过时.
获取或设置一个值,该值指示在序列化期间是否应为当前设计文档在代码隐藏文件中创建控件的字段声明。 (继承自 HtmlControlDesigner) |
Tag |
获取表示关联控件的 HTML 标记元素的对象。 (继承自 ControlDesigner) |
TemplateGroups |
获取一个模板组集合,其中每个模板组包含一个或多个模板定义。 (继承自 ControlDesigner) |
UsePreviewControl |
获取一个值,该值指示设计器是否应使用临时副本取代与设计器关联的实际控件来生成设计时标记。 (继承自 WebZoneDesigner) |
Verbs |
获取与设计器相关联的组件所支持的设计时谓词。 (继承自 ComponentDesigner) |
ViewControl |
获取或设置可用于预览设计时 HTML 标记的 Web 服务器控件。 (继承自 ControlDesigner) |
ViewControlCreated |
获取或设置一个值,该值指示是否已创建 |
ViewInBrowseMode |
获取或设置一个值,该值指示当用户处于浏览显示模式时是否显示 Web 部件区域。 (继承自 ToolZoneDesigner) |
Visible |
获取指示该控件在设计时是否可见的值。 (继承自 ControlDesigner) |
方法
显式接口实现
IDesignerFilter.PostFilterAttributes(IDictionary) |
有关此成员的说明,请参见 PostFilterAttributes(IDictionary) 方法。 (继承自 ComponentDesigner) |
IDesignerFilter.PostFilterEvents(IDictionary) |
有关此成员的说明,请参见 PostFilterEvents(IDictionary) 方法。 (继承自 ComponentDesigner) |
IDesignerFilter.PostFilterProperties(IDictionary) |
有关此成员的说明,请参见 PostFilterProperties(IDictionary) 方法。 (继承自 ComponentDesigner) |
IDesignerFilter.PreFilterAttributes(IDictionary) |
有关此成员的说明,请参见 PreFilterAttributes(IDictionary) 方法。 (继承自 ComponentDesigner) |
IDesignerFilter.PreFilterEvents(IDictionary) |
有关此成员的说明,请参见 PreFilterEvents(IDictionary) 方法。 (继承自 ComponentDesigner) |
IDesignerFilter.PreFilterProperties(IDictionary) |
有关此成员的说明,请参见 PreFilterProperties(IDictionary) 方法。 (继承自 ComponentDesigner) |
ITreeDesigner.Children |
有关此成员的说明,请参见 Children 属性。 (继承自 ComponentDesigner) |
ITreeDesigner.Parent |
有关此成员的说明,请参见 Parent 属性。 (继承自 ComponentDesigner) |