ConnectionsZoneDesigner 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供 ConnectionsZone 控制項的設計階段支援。
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- 繼承
-
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 |
取得目前控制項的資料繫結 (Data Binding) 集合。 (繼承來源 HtmlControlDesigner) |
| DataBindingsEnabled |
取得值，指出關聯控制項的包含區域是否支援資料繫結。 (繼承來源 ControlDesigner) |
| DesignerState |
取得物件，用於在設計階段保存關聯控制項的資料。 (繼承來源 ControlDesigner) |
| DesignTimeElement |
已淘汰.
取得設計階段物件，表示與設計介面上 HtmlControlDesigner 物件相關聯的控制項。 (繼承來源 HtmlControlDesigner) |
| DesignTimeElementView |
已淘汰.
取得控制項設計工具的檢視控制項物件。 (繼承來源 ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
已淘汰.
取得值，指出設計主應用程式在呼叫 GetDesignTimeHtml 方法之前是否必須完成載入。 (繼承來源 ControlDesigner) |
| Expressions |
在設計階段取得目前控制項的運算式繫結。 (繼承來源 HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
取得值，指示當控制項處於樣板模式時，關聯控制項的屬性是否會隱藏。 (繼承來源 ControlDesigner) |
| ID |
取得或設定控制項的 ID 字串。 (繼承來源 ControlDesigner) |
| InheritanceAttribute |
取得屬性 (Attribute)，表示相關元件的繼承 (Inheritance) 型別。 (繼承來源 ComponentDesigner) |
| Inherited |
取得值，表示是否要繼承這個元件。 (繼承來源 ComponentDesigner) |
| InTemplateMode |
取得值，指出控制項在設計主應用程式中處於樣板檢視模式還是編輯模式。 InTemplateMode 屬性是唯讀的。 (繼承來源 ControlDesigner) |
| IsDirty |
已淘汰.
取得或設定值，指出 Web 伺服器控制項是否已標記為變更。 (繼承來源 ControlDesigner) |
| ParentComponent |
取得這個設計工具的父元件。 (繼承來源 ComponentDesigner) |
| ReadOnly |
已淘汰.
取得或設定值，指出控制項屬性於設計階段是否為唯讀。 (繼承來源 ControlDesigner) |
| RootDesigner |
為包含關聯控制項的 Web Form 網頁，取得控制項設計工具。 (繼承來源 ControlDesigner) |
| SetTextualDefaultProperty |
提供 ConnectionsZone 控制項的設計階段支援。 (繼承來源 ComponentDesigner) |
| ShadowProperties |
取得覆寫使用者設定的屬性值集合。 (繼承來源 ComponentDesigner) |
| ShouldCodeSerialize |
已淘汰.
取得或設定值，指出是否應該於序列化 (Serialization) 期間，在程式碼後置 (Code-Behind) 檔案中為目前設計文件建立控制項的欄位宣告。 (繼承來源 HtmlControlDesigner) |
| Tag |
取得物件，表示關聯控制項的 HTML 標記項目。 (繼承來源 ControlDesigner) |
| TemplateGroups |
取得範本群組集合，各範本群組包含一個或多個範本定義。 (繼承來源 ControlDesigner) |
| UsePreviewControl |
取得值，表示這個設計工具是否應該使用暫存複本來產生設計階段標記，而不是使用與設計工具關聯的實際控制項。 (繼承來源 WebZoneDesigner) |
| Verbs |
取得與設計工具相關元件所支援的設計階段動詞命令 (Verb)。 (繼承來源 ComponentDesigner) |
| ViewControl |
取得或設定 Web 伺服器控制項，可用於預覽設計階段的 HTML 標記。 (繼承來源 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) |
