webParts与Web部件
web部件是ASP.NET WebForm里面的服務器控件,它涵蓋的內容比較多,鑒于這種狀況的話鄙人不打算深究下去了,只是局限于了解web.config配置里面的配置內容則可。
那么也得稍微說說啥是Web部件。引用MSDN的話:ASP.NET Web 部件是一組集成控件,用于創建網站使最終用戶可以直接從瀏覽器修改網頁的內容、外觀和行為。這些修改可以應用于網站上的所有用戶或個別用戶。還有引用它上面的插圖
看了這個之后我就感覺就類似于QQ個人空間上的各個面板或者OA系統上的面板,可以按照每個用戶的個人喜好去更改顯示的內容,位置以及是否顯示
更多關于Web部件的內容可參考本篇后面的參考的MSDN文章。關于Web部件的的WebPartManager和webParetZone就不說了,接下來則看看webParts配置節的內容
配置分兩大塊,personalization的是關于個性化設置數據的提供以及用戶訪問權限的;另一個是關于web部件連接的時候數據結構不一致需要轉換的配置。
下面則先看看personalization的,這個例子是參考了MSDN。實現的效果大概是記錄用戶個性化數據,以及對數據的權限控制,本例子包含一個登錄頁面,一個示例頁面,兩個用戶控件。
首先示例頁面的內容如下
登錄頁面只是包含了一個登錄控件
用于展現用戶個性化設置的自定義控件 Color
?
<%@ Control Language="C#" %><script runat="server">// User a field to reference the current WebPartManager. private WebPartManager _manager;// Defines personalized property for User scope. In this case, the property is// the background color of the text box. [Personalizable(PersonalizationScope.User)]public System.Drawing.Color UserColorChoice{get{return _coloruserTextBox.BackColor;}set{_coloruserTextBox.BackColor = value;}}// Defines personalized property for Shared scope. In this case, the property is// the background color of the text box. [Personalizable(PersonalizationScope.Shared) ]public System.Drawing.Color SharedColorChoice{get{return _colorsharedTextBox.BackColor;}set{_colorsharedTextBox.BackColor = value;}}void Page_Init(object sender, EventArgs e){_manager = WebPartManager.GetCurrentWebPartManager(Page); }protected void Page_Load(object src, EventArgs e) {// If Web Parts manager scope is User, hide the button that changes shared control.if (_manager.Personalization.Scope == PersonalizationScope.User){_sharedchangeButton.Visible = false;if (!_manager.Personalization.IsModifiable)_userchangeButton.Enabled = false;}else{_sharedchangeButton.Visible = true; if (!_manager.Personalization.IsModifiable){_sharedchangeButton.Enabled = false;_userchangeButton.Enabled = false;}} }// Changes color of the User text box background when button clicked by authorized user. protected void _userButton_Click(object src, EventArgs e){switch(_coloruserTextBox.BackColor.Name){case "Red":_coloruserTextBox.BackColor = System.Drawing.Color.Yellow;break;case "Yellow":_coloruserTextBox.BackColor = System.Drawing.Color.Green;break;case "Green":_coloruserTextBox.BackColor = System.Drawing.Color.Red;break;}}// Changes color of the Shared text box background when button clicked by authorized user. protected void _sharedButton_Click(object src, EventArgs e){switch (_colorsharedTextBox.BackColor.Name){case "Red":_colorsharedTextBox.BackColor = System.Drawing.Color.Yellow;break;case "Yellow":_colorsharedTextBox.BackColor = System.Drawing.Color.Green;break;case "Green":_colorsharedTextBox.BackColor = System.Drawing.Color.Red;break;} } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head><title>WebParts Personalization Example</title> </head> <body> <p><asp:LoginName ID="LoginName1" runat="server" BorderWidth="500" BorderStyle="none" /><asp:LoginStatus ID="LoginStatus1" LogoutAction="RedirectToLoginPage" runat="server" /> </p><asp:Label ID="ScopeLabel" Text="Scoped Properties:" runat="server" Width="289px"></asp:Label><br /><table style="width: 226px"><tr><td><asp:TextBox ID="_coloruserTextBox" Font-Bold="True" Height="110px" runat="server" Text="User Property" BackColor="red" Width="110px" /> </td><td> <asp:TextBox ID="_colorsharedTextBox" runat="server" Height="110px" Width="110px" Text="Shared Property" BackColor="red" Font-Bold="true" /></td></tr><tr><td><asp:Button Text="Change User Color" ID="_userchangeButton" runat="server" OnClick="_userButton_Click" /></td><td ><asp:Button Text="Change Shared Color" ID="_sharedchangeButton" runat="server" OnClick="_sharedButton_Click" /></td></tr></table> </body> </html>?
?
? ?
用于顯示用戶個性化數據權限的自定義控件Persmode
?
1 <%@ control language="C#" %> 2 3 <script runat="server"> 4 5 // Use a field to reference the current WebPartManager. 6 private WebPartManager _manager; 7 8 protected void Page_Load(object src, EventArgs e) 9 { 10 // Get the current Web Parts manager. 11 _manager = WebPartManager.GetCurrentWebPartManager(Page); 12 13 // All radio buttons are disabled; the button settings show what the current state is. 14 EnterSharedRadioButton.Enabled = false; 15 ModifyStateRadioButton.Enabled = false; 16 17 // If Web Parts manager is in User scope, set scope button. 18 if (_manager.Personalization.Scope == PersonalizationScope.User) 19 UserScopeRadioButton.Checked = true; 20 else 21 SharedScopeRadioButton.Checked = true; 22 23 // Based on current user rights to enter Shared scope, set buttons. 24 if (_manager.Personalization.CanEnterSharedScope) 25 { 26 EnterSharedRadioButton.Checked = true; 27 No_Shared_Scope_Label.Visible = false; 28 Toggle_Scope_Button.Enabled = true; 29 } 30 else 31 { 32 EnterSharedRadioButton.Checked = false; 33 No_Shared_Scope_Label.Visible = true; 34 Toggle_Scope_Button.Enabled = false; 35 } 36 37 // Based on current user rights to modify personalization state, set buttons. 38 if (_manager.Personalization.IsModifiable) 39 { 40 ModifyStateRadioButton.Checked = true; 41 Reset_User_Button.Enabled = true; 42 } 43 else 44 { 45 ModifyStateRadioButton.Checked = false; 46 Reset_User_Button.Enabled = false; 47 } 48 } 49 // Resets all of a user and shared personalization data for the page. 50 protected void Reset_CurrentState_Button_Click(object src, EventArgs e) 51 { 52 // User must be authorized to modify state before a reset can occur. 53 //When in user scope, all users by default can change their own data. 54 if (_manager.Personalization.IsModifiable) 55 { 56 _manager.Personalization.ResetPersonalizationState(); 57 } 58 } 59 60 // Allows authorized user to change personalization scope. 61 protected void Toggle_Scope_Button_Click(object sender, EventArgs e) 62 { 63 if (_manager.Personalization.CanEnterSharedScope) 64 { 65 _manager.Personalization.ToggleScope(); 66 } 67 68 } 69 </script> 70 <div> 71 <asp:Panel ID="Panel1" runat="server" 72 Borderwidth="1" 73 Width="208px" 74 BackColor="lightgray" 75 Font-Names="Verdana, Arial, Sans Serif" Height="214px" > 76 <asp:Label ID="Label1" runat="server" 77 Text="Page Scope" 78 Font-Bold="True" 79 Font-Size="8pt" 80 Width="120px" /> <br /> 81 82 83 <asp:RadioButton ID="UserScopeRadioButton" runat="server" 84 Text="User" 85 AutoPostBack="true" 86 GroupName="Scope" 87 Enabled="false" /> 88 <asp:RadioButton ID="SharedScopeRadioButton" runat="server" 89 Text="Shared" 90 AutoPostBack="true" 91 GroupName="Scope" 92 Enabled="false" /> 93 <br /> 94 <asp:Label BorderStyle="None" Font-Bold="True" Font-Names="Courier New" ID="No_Shared_Scope_Label" Font-Size="Smaller" ForeColor="red" 95 runat="server" Visible="false" Width="179px">User cannot enter Shared scope</asp:Label> 96 <br /> 97 <asp:Label ID="Label2" runat="server" 98 Text="Current User Can:" 99 Font-Bold="True" 100 Font-Size="8pt" 101 Width="165px" /> 102 <br /> 103 <asp:RadioButton ID="ModifyStateRadioButton" runat="server" 104 Text="Modify State" Width="138px" /> 105 <br /> 106 <asp:RadioButton ID="EnterSharedRadioButton" runat="server" 107 Text="Enter Shared Scope" 108 AutoPostBack="true" /> <br /> 109 <br /> 110 <asp:Button ID="Toggle_Scope_Button" OnClick="Toggle_Scope_Button_Click" runat="server" 111 Text="Change Scope" Width="186px" /><br /> 112 <br /> 113 <asp:Button ID="Reset_User_Button" OnClick="Reset_CurrentState_Button_Click" runat="server" 114 Text="Reset Current Personalization" Width="185px" /></asp:Panel> 115 116 </div>?
?
?
最后少不了的就是在web.config中添加配置
在這里開始吹水了,首先MSDN上面例子沒提及到要添加認證的配置,使得我最開始的時候登錄了還沒看到效果。后來在懷疑是需要配置認證機制。接著這里使用了一個Provider,AspNetSqlPersonalizationProvider并非類名,只是SqlPersonalizationProvider配置的名稱而已。默認配置如下,
在ASP.NET中實現了這個個性化提供者的就只有這個SqlPersonalizationProvider,這個我是看源碼還有MSDN中類的繼承結構中看出來的。不知有無其他地方明確指出,如需要其他的提供機制,則需要自定義擴展了。
您可以從其中?PersonalizationProvider?,并提供僅在此類中定義的抽象方法的實現。?抽象方法處理專門與保存和加載數據寫入物理數據存儲,以及數據存儲區管理。?自定義提供程序必須能夠處理可區分的方式的個性化信息?Shared?中的數據?User?數據。?此外,提供程序必須段個性化數據頁以及按應用程序。
實現?PersonalizationProvider?緊密耦合的實現與?PersonalizationState?由于某些個性化設置提供程序方法返回的實例?PersonalizationState的派生類。?為了便于開發自定義提供程序,?PersonalizationProvider?基類包括個性化設置邏輯和序列化/反序列化邏輯,直接使用的默認實現WebPartPersonalization?類。?結果是,創作專門用于使用不同的數據存儲區的自定義提供只需要下列抽象方法的實現︰
- GetCountOfState?-此方法需要能夠在數據庫中為提供的查詢參數的個性化數據行的數目進行計數。
- LoadPersonalizationBlobs?-在給定路徑和用戶名的情況下,此方法從數據庫中加載兩個二進制大型對象 (Blob): 一個用于共享的數據,另一個用于用戶數據的 BLOB。?如果您提供的用戶名稱和路徑,則不需要?WebPartManager?控件,用于訪問可以提供的用戶文件名/路徑信息的頁信息。
- ResetPersonalizationBlob?-在給定路徑和用戶名的情況下,此方法中刪除數據庫中相應的行。?如果您提供的用戶名稱和路徑,則不需要WebPartManager?控件,用于訪問可以提供的用戶文件名/路徑信息的頁信息。
- SavePersonalizationBlob?--此方法在給定的路徑和用戶名稱,保存對數據庫所提供的 BLOB。?如果您提供的用戶名稱和路徑,則不需要?WebPartManager?控件,用于訪問可以提供的用戶文件名/路徑信息的頁信息。
在所有這些方法中,如果只提供一個路徑,則表示正在操作頁上的共享的個性化設置數據。?如果用戶名和路徑傳遞到方法中,頁上的用戶個性化設置數據應得到處理。?情況下?LoadPersonalizationBlobs, ,應始終加載指定的路徑的共享的數據,并 (可選) 的路徑的用戶個性化設置數據也如果應加載的用戶名不是?null。
所有抽象方法旨在僅用于管理應用程序,在運行時不使用由 Web 部件基礎結構。?個性化設置提供程序的實現的示例,請參閱SqlPersonalizationProvider?類。
說了這么多看看這個示例的運行效果
經過登錄之后就可以看到界面如上所示,點擊Change xxx Color就可以改變方塊的顏色,這些顏色設置是存儲到數據庫的,用戶可以在注銷下次登錄時扔看到這些設置,包括對面板的關閉和最小化操作。下面的面板是控制這些設置的作用域,一個是用戶個人的,一個是全局共享的??梢酝ㄟ^Change Scope去切換。這里涉及到兩個方面內容,首先是數據保存,數據存儲在Web程序默認建立的SqlServer數據庫中,與MemberShip的庫相同。個人數據的放在PersonalizationAllUsers里面,Share的則放在PersonalizationPerUser中。所有的數據都并非直接存放在表中,作為通用存儲的話這是不可能的。
另外關于權限控制的,在配置文件中的personalization/authorization配置節跟system.web/authorization的結構很相像,區別在于verbs,這里用的值僅以下兩種。
對于獲取設置信息是不阻攔的,但是需要更換作用域進入共享區時需要有enterSharedScope權限,當需要更改任何一個作用域的數據時需要modeifyState。如果兩個權限都被deny的話,用戶就只能傻傻地看了
personalization的結束到此完,接下來到transformers。這里涉及到一個web部件連接的概念。不知我自己有否理解錯,這個web部件連接的雙方中提供數據的一方個人感覺就是一個數據源。數據源提供的數據可以給頁面上其他多個控件使用,但是數據源提供的數據格式不一定符合其他所有控件,因此這里就需要一個轉換器來適配雙方的差異,這就是適配器模式嘛!嗎?但是要是說多弄一個數據源(或者叫Provider)的話,這樣的開銷比較大。那么ASP.NET提供的轉換器就只有兩個RowToFieldTransformer和RowToParametersTransformer,如果需要其他的轉換就需要自己定義,還需要到配置文件中聲明一下這個轉換器,下面也是借鑒了一個MSDN的例子來嘗試一下通過一個行轉換到字符串。
對于MSDN的例子我還是精簡了兩個控件,大概可以看以下這里建立了一個靜態的Web部件連接,通過一個rowtostringtransformer進行轉換。這個鏈接的提供者是rowproviderwebpart的自定義webPart,另一個stringconsumerwebpart的自定義webpart。這些類都定義在App_Code文件夾中,所以注冊命名空間的時候要注意一下
下面就是各個文件的代碼IString
RowToStringTransformer
? ?
下面這兩個類是參考了MSDN的代碼,自己根據當前的情況改過一下,不然運行不了,但不知道有否改錯,使之背離愿意
// This sample code creates a Web Parts control that acts as a provider // of row data. [AspNetHostingPermission(SecurityAction.Demand,Level = AspNetHostingPermissionLevel.Minimal)][AspNetHostingPermission(SecurityAction.InheritanceDemand,Level = AspNetHostingPermissionLevel.Minimal)]public sealed class RowProviderWebPart : WebPart, IWebPartRow{private DataTable _table;public RowProviderWebPart(){_table = new DataTable();DataColumn col = new DataColumn();col.DataType = typeof(string);col.ColumnName = "Name";_table.Columns.Add(col);col = new DataColumn();col.DataType = typeof(string);col.ColumnName = "Address";_table.Columns.Add(col);col = new DataColumn();col.DataType = typeof(int);col.ColumnName = "ZIP Code";_table.Columns.Add(col);DataRow row = _table.NewRow();row["Name"] = "John Q. Public";row["Address"] = "123 Main Street";row["ZIP Code"] = 98000;_table.Rows.Add(row);}[ConnectionProvider("String123")]public IWebPartRow GetConnection(){return new RowProviderWebPart();}public PropertyDescriptorCollection Schema{get{return TypeDescriptor.GetProperties(_table.DefaultView[0]);}}public void GetRowData(RowCallback callback){foreach (var item in _table.DefaultView){callback(item);}}} [AspNetHostingPermission(SecurityAction.Demand,Level = AspNetHostingPermissionLevel.Minimal)][AspNetHostingPermission(SecurityAction.InheritanceDemand,Level = AspNetHostingPermissionLevel.Minimal)]public sealed class StringConsumerWebpart : WebPart{private IString _provider;private string _stringData;private void GetRowData(object rowData){_stringData = rowData.ToString();}protected override void OnPreRender(EventArgs e){if (_provider != null){_provider.GetStringValue(new StringCallback(GetRowData));}}protected override void RenderContents(HtmlTextWriter writer){if (!string.IsNullOrEmpty(_stringData)){writer.Write(_stringData);writer.WriteBreak();writer.WriteLine();}else{writer.Write("No data");}}[ConnectionConsumer("String123")]public void SetConnection(IString provider){_provider = provider;}}?
在調試的時候發現_provider.GetStringValue(new StringCallback(GetRowData));這行代碼最繞,嵌了幾個委托;另外有個有意思的地方就是get/set連接的時候,它使用了一個類似依賴注入的東西,Attribute的Display參數把Connection的get/set兩個方法配對,完全忽略方法的命名,可惜這個ConnectionConsumer和ConnectionProvider只能描述方法,不然可以用到屬性去。
差點忘了把Web.config的配置添加進去
最終結果如下圖,就把Provider中的一個table的專成了一個字符串。
? ?
參考文章
? ?
Visual Studio 中的 ASP.NET Web 部件
來自 <https://msdn.microsoft.com/zh-cn/library/0ey99zzh(v=vs.80).aspx>
? ?
ASP.NET Web 部件概述
來自 <https://msdn.microsoft.com/zh-cn/library/hhy9ewf1(v=vs.100).aspx>
? ?
Web 部件控件集概述
來自 <https://msdn.microsoft.com/zh-cn/library/k3w2y2tf(v=vs.100).aspx>
? ?
Web 部件個性化設置概述
來自 <https://msdn.microsoft.com/zh-cn/library/z36h8be9(v=vs.100).aspx>
? ?
webParts 元素(ASP.NET 設置架構)
來自 <https://msdn.microsoft.com/zh-cn/library/ms164680(v=vs.110).aspx>
? ?
WebPartPersonalization 類(Personlization設置實現)
來自 <https://msdn.microsoft.com/zh-cn/library/system.web.ui.webcontrols.webparts.webpartpersonalization(v=vs.100).aspx?cs-save-lang=1&cs-lang=csharp#code-snippet-4>
? ?
WebPartTransformer 類(transformers設置實現)
來自 <https://msdn.microsoft.com/zh-cn/library/system.web.ui.webcontrols.webparts.webparttransformer(v=vs.110).aspx>
? ?
如何:聲明兩個 Web 部件控件之間的靜態連接
來自 <https://msdn.microsoft.com/zh-cn/library/ms178188(v=vs.100).aspx>
? ?
IWebPartRow 接口
來自 <https://msdn.microsoft.com/zh-cn/library/system.web.ui.webcontrols.webparts.iwebpartrow(v=vs.100).aspx>
? ?
? ?
總結
以上是生活随笔為你收集整理的webParts与Web部件的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: XMNetworking 网络库的设计与
- 下一篇: bash特性之四、五