為 Microsoft Visual Studio .NET 設計工具建立可設計式元件(轉貼)下

來源:互聯網
上載者:User
visual 以相同方式出入:透過程式碼儲存元件
  不同於以往的設計工具,.Net Framework 元件的 Win Forms 與其它 VS .NET 設計工具,僅依賴表單狀態的程式碼儲存性。沒有神奇的格式,也沒有隱藏資料,只是運作平穩的普通程式碼。當然,像點陣圖和本土化字串等,可以視為二進元資料與程式碼一起封裝,但元件狀態和元件所含內容,則必須透過程式碼來儲存。在您設計工具的同時,也會產生程式碼。倘若您針對該程式碼進行處理,則會重新剖析,並且將變更內容反應在設計工具中。

.Net Framework 的設計工具可提供所有配備以利用此功能。所有設計工具對於任何類型最希望得知的內容包括:

有哪些關於物件狀態的資訊有助於儲存性?

如何將該類資訊以現行物件傳回?

在先前的章節中,已經簡單討論過這個問題。再次聲明,TypeConverter 是處理的核心。產生程式碼和剖析程式碼設計工具,皆與名為 CreationBundle 的 PersistInfo 特定類型有關。例如:

[TypeConverter(typeof(IntBoolString.IntBoolStringConverter))]
public class IntBoolString {
private int intVal;
private string stringVal;
private bool boolVal;

public IntBoolString(string s, int I, bool b) {
This.intVal = I;
This.stringVal =s ;
This.boolVal = b;
}
public bool Bool{
get {return boolVal;}
set {boolVal = value;}
}

public int Int {
get {return intVal;}
set {intVal = value;}
}

public string String {
get {return stringVal;}
set {stringVal = value;}
}

public override string ToString() {
return intVal + "," + boolVal + "," + stringVal;
}

public class IntBoolStringConverter : TypeConverter {

public override bool CanConvertFrom(
ITypeDescriptorContext context,
Type sourceType) {
return (sourcetType == typeof(string));
}

public virtual object ConvertFrom(
ITypeDescriptorContext context,
object value,
object[] arguments) {

if (value is string) {
string stringValue = (string)value;
int intValue;
bool boolValue;

int commaIndex =
stringValue.IndexOf(',');

if (commaIndex != -1) {
intValue = Int32.
Parse(stringValue.
Substring(0, commaIndex));
commaIndex = stringValue.
IndexOf(',',
commaIndex + 1);
if (commaIndex != -1) {
int nextComma = stringValue.IndexOf(',', commaIndex + 1);
if (nextComma != -1) {
boolValue = Boolean.Parse(stringValue.Substring(commaIndex+1,
nextComma - commaIndex));
stringValue = stringValue.Substring(nextComma+1);
return new IntBoolString(intVal, boolVal, stringValue);
}

}
}
throw new FormatException("Can't convert '" + stringValue + "' to IntBoolString Object");
}
}



public override PersistInfo GetPersistInfo(ITypeDescriptorContext context, object value) {
if (value is IntBoolString) {
IntBoolString ibs = (IntBoolString)value;

return new CreationBundle(typeof(IntBoolString), null,
new CreationArgument[] {
new CreationArgument(ibs.Int, typeof(Int32)),
new CreationArgument(ibs.Bool, typeof(bool)),
new CreationArgument(ibs.String, typeof(string))});
}

return base.GetPersistInfo(context, value);
}
}

public override object CreateInstance(ITypeDescriptorContext
context, IDictionary propertyValues) {
return new IntBoolString((int)propertyValues["Int"],
(bool)propertyValues["Bool"],
(string)propertyValue["String"]);
}

public override bool GetCreateInstanceSupported(ITypeDescriptorContext context) {
return true;
}

}


使用 CreationBundle 物件的好處,在於這些物件若擁有符合傳入 CreationArgument 中各種類型的建構函式,就能夠得知用來儲存資訊的物件建立方式。在呼叫 TypeConverter::CreateInstance,並以此方式嘗試建立和初始設定物件時,TypeConverter 的預設實作會呼叫 CreationBundle::Invoke。倘若無可用的建構函式,則 CreateInstance 呼叫會採用 IDictionary,以允許物件製作更多自訂項目。傳入的 IDictionary 包含每個屬性名稱中不儲存的值。

元件的屬性值通常由多個物件所組成,其它架構通常就是為此目的而使用屬性陣列。然而,陣列卻有些缺點,例如,陣列必須在傳出時先行複製,於傳回時再次複製,結果當然大幅影響效能;在新增、修改或刪除值的時候,陣列也無法提供智慧型通知。事實上,如果屬性傳回陣列,是否新增或刪除項目就相當耗費工夫。陣列也是快照值,若基本物件不變更,就無法進行更新。

反之,.Net Framework 在這種情況下,則使用實行 ICollection 物件的集合。物件可建立出集合並傳送給其它物件,同時參照項目可視基本物件的變更而保持最新狀態。若另一物件也針對集合進行變更,則亦將同時通知該物件。對於使用集合的 .Net Framework 設計工具,還需要支援含有 Get 和 Set 的 All 屬性,且其類型必須為集合可保留的物件陣列。例如:

public class IntCollection : ICollection {
private int[] values;

public IntCollection(int[] intValues) {
this.values = (int[])intValues.Clone();
}

public int[] All {
get {
return (int[])values.Clone();
}
set {
values = (int[])value.Clone();
}
}

public int Count {
get {
if (values == null) {
return 0;
}
return values.Length;
}
}


[Browsable(false)]
public object SyncRoot {
get {
return this;
}
}

[Browsable(false)]
public bool IsReadOnly {
get {
return false;
}
}

[Browsable(false)]
public bool IsSynchronized {
get {
return true;
}
}
}


.Net Framework 的儲存性機制,可儲存或不儲存本集合。若該集合由較先進的類型組成,如上述之 BoolIntString 範例類型,則需要利用與類型相關聯的 TypeConverter,為集合中每個項目建立有效 PersistInfo (特別是 VS .NET 設計工具的 CreationBundle)。

元件設計工具
  如之前所述,.Net Framework 中的內建設計工具,足以滿足元件的多數要求。不過,.Net Framework 還包括元件設計工具的完整擴充性架構。所有設計工具皆以 System.ComponentModel.Design.IDesigner 介面為基礎,列示如下:

public interface IDesigner {

// 與本設計工具相關的元件
IComponent Component {get;}

// 與元件相關的設計階段動作,
// 如 TabControl 的「Add Tab」
DesignerVerb[] Verbs {get;}

// 處理設計工具所使用的任何資源。
// 設計工具在本次呼叫後即無法使用。
void Dispose();

// 呼叫以要求設計工具執行「預設動作」。
// 通常為了回應執行階段在元件上「連按兩下」
// 動作而呼叫。
void DoDefaultAction();

// 以既定元件來初始設定設計工具。
void Initialize(IComponent component);
}


不難看出,IDesigner 是相當直接的。設計工具透過 DesignerAttribute 與元件產生關聯:

[Designer("MyNameSpace.Design.MyComponentDesigner, MyNameSpace.DLL")]
Public class MyComponent : Component {
}


倘若 DesignerAttribute 未出現在類別中,則必須待找出設計工具位置後,才能夠跨越類別階層。在前述範例中,預設的 ComponentDesigner 可能位於元件基礎類別中,同時可供使用。有些設計工具會顯示出 UI,有些則不顯示。在 ComponentDesigner 中,由於元件通常沒有 UI,因此可以看到代表物件的圖示。另一方面,Win 表單控制項則有設計工具可於設計階段顯示出實際控制項。

圖 3:設計階段的 Win 表單控制項

請注意:位於設計工具下的圖示是未顯示 UI 的控制項;而顯示 UI 的 Win 表單控制項,則於執行階段顯示在表單設計工具中。然而不論顯示與否,這些控制項全數皆以 IDesigner 為基礎建立而成。控制項的設計工具通常會攔截設計中的控制項 WindowProc (來自System.WinForms.Design.ControlDesigner 的設計工具可以簡單地覆寫 WndProc 方法來完成),以執行諸如點擊測試等複雜的工作。然而,對於大部份元件而言,內建的預設設計工具應該已經足夠使用。

使用設計工具服務與基礎架構
  在 VS .NET 中的 .Net Framework 設計工具,顯露出多樣化服務和基礎架構元件,可簡化複雜的作業或允許設計工具瞭解有關其它部份的狀態。這些服務永遠使用 GetServiceObject 方法透過 IServiceObjectProvider 進行存取。以下是部分特殊設計工具服務的清單:

類型

 
描述

IDesignerHost
與任何最上層設計工具相關的主要類別。可提供方法以增加服務、建立與放置元件、移除元件並進行批次作業。

IComponentChangeService
新增、移除、重新命名或修改元件時提供通知。

ISelectionService
設定或取得目前設計工具中選取的項目。

IToolboxService
允許在工具箱內查驗和修改項目及選項狀態等等。

IUndoService
提供配備以建立動作的復原/重做單位,並管理復原/重做堆疊。

IHelpService
允許設定說明主題或者叫用說明項目。

IMenuCommandService
允許處理設計工具功能表指令和動作。

IReferenceService
在設計工具中將參照內容對應到物件。例如,名稱 button1 對應到元件 button1 。



IDesignerHost 是 VS .NET 中所有設計工具的基礎。IDesignerHost 亦為 IServiceObjectProvider,可利用動態方式新增和移除服務。它同時也提供建立元件的方法,以確保是否置於適當的位置。以下是使用 IDesignerHost 建立元件的範例:

Public class MyDesigner : IDesigner {

// ?.

Private void OnSurfaceDoubleClick(object s, EventArgs e) {
IDesignerHost host =
(IDesignerHost)this.Component.Site.GetServiceObject(typeof(IDesignerHost));
If (host != null) {
Object newComponent = host.CreateComponent(typeof(MyComponent));
DoSomethingInterestingWithComponent(newComponent);
}
}

// ?}


元件授權
  在擴充性的 .Net Framework 模型中,授權架構亦可同時擴充。為了方便使用,架構定義了一項內建的標準授權方法,以控制元件是否於設計使用階段獲得授權,不過研發人員可自由替換本機制。

// 新增 LicenseProviderAttribute 到控制項。
[LicenseProvider(typeof(LicFileLicenseProvider))]
public class MyControl : RichControl {
// 建立新的「空」授權。
private License license = null;
public MyControl () {
// 使控制項的建構函式生效。
license = LicenseManager.Validate(typeof(MyControl), this);
// 是否執行其他範例工作? }
public override void Dispose() {
if (license != null) {
license.Dispose();
license = null;
}
}
protected override void Finalize() {
Dispose();
base.Finalize();
}
}


此範例可以使用內建授權支援來啟動授權工作。LicFileLicenseProvider 只要在類別的 Assembly 目錄中,尋找名為 <classname>.lic 的檔案,其中 classname 必須是完整的類型名稱。例如,對於 String 類型而言,名稱則為 System.String.lic。本檔案可包含字串「System.String 是已授權的元件」。若發現本檔案,LicenseManager.Validate 會傳回授權物件,並隨著類別實例來進行處置。

實行您個人的授權機制也一樣輕鬆簡單。只要建立取自 LicenseProvider 的個人類別,並實行個人的 GetLicense 方法即可。您可以登錄為基礎實行授權機制,其中已授權的設計階段元件在登錄檔中有一個項目:

public class RegistryLicenseProvider: LicenseProvider {
public override License GetLicense(
LicenseContext context,
Type type,
object instance,
bool allowExceptions) {

RegistryKey licenseKey = Registry.LocalMachine.
OpenSubKey("Software\\MyCompany\\ComponentLicenses");

if (context.UsageMode == LicenseUsageMode.Designtime) {
if (licenseKey != null && licenseKey.GetValue(type.FullName) != null) {
return new RegLicense(this, type);
}
if (allowExceptions) {
throw new LicenseException(type, instance,
"Couldn''t get design-time license for ''"" +
type.FullName + "''");
}
return null;
}
else {
return new RuntimeRegLicense(this, type);
}
}

private class RuntimeRegLicense : License {
public string LicenseKey {
get {
return type.FullName;
}
}
public override void Dispose() {
}


}

private class RegLicense : License {
private RegistryLicenseProvider owner;
private Type type;

public RegLicense(RegistryLicenseProvider owner, Type type) {
this.owner = owner;
this.type = type;
}

public string LicenseKey {
get {
return type.FullName;
}
}
public override void Dispose() {
}
}

[LicenseProvider(typeof(RegistryLicenseProvider))]
public class MyControl : Control {
}


使用本授權的元件在下列登錄檔中會有一個登錄項目:

HKEY_LOCAL_MACHINE\Software\MyCompany\ComponentLicenses
<Type full name>="true"


結論
  在管理程式碼中撰寫控制項,可為傳統的 C++/COM 方法帶來更多的優勢。Microsoft 從最基本的通用語言執行階段開始策劃,遍及至 C# 甚至重組的 Visual Basic 語言,以提供研發人員效率最高的通用方法,將建構軟體時的阻礙降到最低。Microsoft .Net Framework 是第一個以這些技術和原理為基礎,所研發成功的大型程式碼庫範例,而支援的整合式設計工具,則是本方法成功的關鍵。

相關文章

E-Commerce Solutions

Leverage the same tools powering the Alibaba Ecosystem

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。