[収蔵]ASP.NET Starter Kit掘宝記コラム:Portal Starter Kit写しられる宝はどこですか?
ASP.NET Starter Kit掘宝記コラム:
Portal Starter Kitが写せる宝はどこですか?
作者:周世雄
2003年10月
Portal Starter Kit(ポータルサイト入門キット)写し可能な宝
プログラマーの「宝を掘る」時が来た.米マイクロソフトが開発し、無料で、オリジナルのプログラムコードを開放したPortal Starter Kit(ポータルサイト入門キット)で写せる場所はどこだろうか.写すことができる宝(場所)には、次のものが含まれています.
入口のウェブサイトのエンジンの動作の原理
ポータルサイトのエンジンの動作原理は以下の通りです.
ポータルサイト設定XMLファイル
ポータルサイト全体の設定はリポジトリに格納されず、XMLファイル(PortalCfg.xml)に格納される.
例えば「従業員メッセージ」ページにPortalCfgに署名する.xmlの部分:
<tab tabid="2" tabname=" " accessroles="All Users;" taborder="9" showmobile="true" mobiletabname="HR"><module moduleid="9" moduletitle=" " editroles="Admins;" moduledefid="2" panename="ContentPane" cachetimeout="0" moduleorder="1" showmobile="true"></module><module moduleid="10" moduletitle=" " editroles="Admins;" moduledefid="10" panename="ContentPane" cachetimeout="0" moduleorder="3" showmobile="false"></module><module moduleid="43" moduletitle=" " editroles="Admins;" moduledefid="6" panename="ContentPane" cachetimeout="0" moduleorder="5" showmobile="false"><settings><setting name="src">~/IMAGES/IMAGE19.JPG</setting><setting name="height">300</setting><setting name="width">400</setting></settings></module><module moduleid="44" moduletitle=" " editroles="Admins;" moduledefid="8" panename="ContentPane" cachetimeout="0" moduleorder="7" showmobile="false"></module></tab>
「従業員メッセージ」ページに次の図が表示されます.
例えば[管理者]ページにPortalCfgにサインする.xmlの部分:
<tab tabid="6" tabname=" " accessroles="Admins;" taborder="17" showmobile="false" mobiletabname="Admin"><module moduleid="28" moduletitle=" " editroles="Admins;" moduledefid="11" panename="RightPane" cachetimeout="0" moduleorder="1" showmobile="false"></module><module moduleid="29" moduletitle=" " editroles="Admins;" moduledefid="14" panename="ContentPane" cachetimeout="0" moduleorder="1" showmobile="false"></module><module moduleid="30" moduletitle=" (Tab)" editroles="Admins;" moduledefid="13" panename="ContentPane" cachetimeout="0" moduleorder="2" showmobile="false"></module><module moduleid="31" moduletitle=" " editroles="Admins;" moduledefid="12" panename="ContentPane" cachetimeout="0" moduleorder="3" showmobile="false"></module><module moduleid="32" moduletitle=" " editroles="Admins;" moduledefid="15" panename="ContentPane" cachetimeout="0" moduleorder="4" showmobile="false"></module></tab>
「管理者」タブには、次の各モジュールが表示されます.
例えば、モジュールはPortalCfgに定義.xmlの部分:
<moduledefinition friendlyname=" " mobilesourcefile="MobileModules/Announcements.ascx" desktopsourcefile="DesktopModules/Announcements.ascx" moduledefid="1"></moduledefinition><moduledefinition friendlyname=" " mobilesourcefile="MobileModules/Contacts.ascx" desktopsourcefile="DesktopModules/Contacts.ascx" moduledefid="2"></moduledefinition><moduledefinition friendlyname=" " mobilesourcefile="" desktopsourcefile="DesktopModules /Discussion.ascx" moduledefid="3"></moduledefinition>… <moduledefinition friendlyname=" (Admin)" mobilesourcefile="" desktopsourcefile="Admin /SiteSettings.ascx" moduledefid="14"></moduledefinition><moduledefinition friendlyname=" (Admin)" mobilesourcefile="" desktopsourcefile="Admin /Users.ascx" moduledefid="15"></moduledefinition><moduledefinition friendlyname=" " mobilesourcefile="DesktopModules/MyURL.ascx" desktopsourcefile="DesktopModules/MyURL.ascx" moduledefid="16"></moduledefinition>
[管理者]ページに次の図が表示されます.
Context物件一時預かり入口サイト設定
ポータルサイトエンジンの動作原理の最初のステップは、ポータルサイトXMLを読み込むためにContextオブジェクトにファイルを設定する.Portal Starter Kitは、Context物件をポータルサイトに一時保存する設定を使用して、ポータルサイトの設定をXMLファイル(PortalCfg.xml)に一時保存する特殊なテクニックを採用しています.方法はGlobal.asaのApplication_BeginRequest()サブルーチンでは,エントリサイトのXMLファイル設定をContext物件に格納した後,同じRequestからのすべてのサイトにおける任意のページ,素子および制御項目をContext物件のPortalSettingsカテゴリに呼び出すことでパラメータ設定値を読み取ることができる.
Application_BeginRequestサブルーチン:
Sub Application_BeginRequest(ByVal sender As Object, ByVal e As EventArgs) Dim tabIndex As Integer = 0 Dim tabId As Integer = 1 ' If Not (Request.Params("tabindex") Is Nothing) Then tabIndex = CInt(Request.Params("tabindex")) End If ' If Not (Request.Params("tabid") Is Nothing) Then tabId = CInt(Request.Params("tabid")) End If 'HttpContext.Current.Cache cache( ) XML , Request ' PortalSettings ( ) Context cache( ), HttpContext.Current.Items("PortalSettings") PortalSettings ( ) Context.Items.Add("PortalSettings", New PortalSettings(tabIndex, tabId)) ' SiteSettings ( ) Context cache( ), HttpContext.Current.Items("SiteSettings") SiteSettings ( ) Dim config As Configuration = New Configuration() Context.Items.Add("SiteSettings", config.GetSiteSettings()) Try If Not (Request.UserLanguages Is Nothing) Then 'Request.UserLanguages(0) = "zh-tw" Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(Request. UserLanguages(0)) Else ' Thread.CurrentThread.CurrentCulture = New CultureInfo("en-us") End If Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture Catch ex As Exception Thread.CurrentThread.CurrentCulture = New CultureInfo("en-us") End TryEnd Sub
ここで、「Dim config As Configuration=New Configuration()」は、ComponentsConfigurationと呼びます.vbのNew()サブルーチン:
Public Sub New(ByVal tabIndex As Integer, ByVal tabId As Integer) ' Dim config As Configuration = New Configuration() Dim siteSettings As SiteConfiguration = config.GetSiteSettings() ' TabOrder Dim tRow As SiteConfiguration.TabRow For Each tRow In siteSettings.Tab.Select("", "TabOrder") Dim tabDetails As New TabStripDetails() With tabDetails .TabId = tRow.TabId .TabName = tRow.TabName .TabOrder = tRow.TabOrder .AuthorizedRoles = tRow.AccessRoles End With Me.DesktopTabs.Add(tabDetails) Next ' (PortalSettings.ActiveTab) 0, TabID 'CType(Me.DesktopTabs(0), TabStripDetails).TabId = 1 If Me.ActiveTab.TabId = 0 Then Me.ActiveTab.TabId = CType(Me.DesktopTabs(0), TabStripDetails).TabId End If ' TabOrder (Mobile) Dim mRow As SiteConfiguration.TabRow For Each mRow In siteSettings.Tab.Select("ShowMobile='true'", "TabOrder") Dim tabDetails As New TabStripDetails() With tabdetails .TabId = mRow.TabId .TabName = mRow.MobileTabName .AuthorizedRoles = mRow.AccessRoles End With Me.MobileTabs.Add(tabDetails) Next ' (Active Tab) (Module Information) Dim activeTab As SiteConfiguration.TabRow = siteSettings.Tab.FindByTabId(tabId) Dim moduleRow As SiteConfiguration._ModuleRow ' Get Modules for this Tab based on the Data Relation For Each moduleRow In activeTab.GetModuleRows() Dim moduleSettings As New moduleSettings() With moduleSettings .ModuleTitle = moduleRow.ModuleTitle .ModuleId = moduleRow.ModuleId .ModuleDefId = moduleRow.ModuleDefId .ModuleOrder = moduleRow.ModuleOrder .TabId = tabId .PaneName = moduleRow.PaneName .AuthorizedEditRoles = moduleRow.EditRoles .CacheTime = moduleRow.CacheTimeout .ShowMobile = moduleRow.ShowMobile ' (ModuleDefinition data) Dim modDefRow As SiteConfiguration.ModuleDefinitionRow = siteSettings.ModuleDefinition.FindByModuleDefId(.ModuleDefId) 'URL .DesktopSrc = modDefRow.DesktopSourceFile .MobileSrc = modDefRow.MobileSourceFile End With Me.ActiveTab.Modules.Add(moduleSettings) Next ' ( ModuleOrder) Me.ActiveTab.Modules.Sort() ' Global <global portalid="0" portalname="Portal
Starter Kit " alwaysshoweditbutton="false"></global> Dim globalSettings As SiteConfiguration.GlobalRow = siteSettings.Global.Rows(0) ' Portal global settings Me.PortalId = globalSettings.PortalId Me.PortalName = globalSettings.PortalName Me.AlwaysShowEditButton = globalSettings.AlwaysShowEditButton Me.ActiveTab.TabIndex = tabIndex Me.ActiveTab.TabId = tabId Me.ActiveTab.TabOrder = activeTab.TabOrder Me.ActiveTab.MobileTabName = activeTab.MobileTabName Me.ActiveTab.AuthorizedRoles = activeTab.AccessRoles Me.ActiveTab.TabName = activeTab.TabName Me.ActiveTab.ShowMobile = activeTab.ShowMobileEnd Sub
ここで「config.GetSiteSettings()」は「Components」と呼びます.vbのGetSiteSettings()関数式は、入口サイトXMLファイル設定ファイルを速取メモリ(cache)HttpContextに格納する.Current.Cache:
' XML Public Function GetSiteSettings() As SiteConfiguration Dim siteSettings As SiteConfiguration = CType(HttpContext.Current.Cache("SiteSettings"), SiteConfiguration) ' SiteConfiguration cache( ), XML cache. If siteSettings Is Nothing Then ' dataset siteSettings = New SiteConfiguration() ' XML ' Web.Config configFile(<add key="configFile" value="/PortalVBVS3/PortalCfg.xml"></add>) 'ConfigurationSettings.AppSettings("configFile") = "/PortalVBVS3/PortalCfg.xml" 'configFile = "C:\Program Files\ASP.NET Starter Kits\ASP.NET Portal (VBVS)\PortalVBVS3\PortalCfg.xml" Dim configFile As String = HttpContext.Current.Server.MapPath(ConfigurationSettings.AppSettings("configFile")) With siteSettings ' AutoIncrement true .Tab.TabIdColumn.AutoIncrement = True ._Module.ModuleIdColumn.AutoIncrement = True .ModuleDefinition.ModuleDefIdColumn.AutoIncrement = True ' XML DataSet siteSettings.ReadXml(configFile) End With ' dataset cache HttpContext.Current.Cache.Insert("SiteSettings", siteSettings, New CacheDependency(configFile)) End If Return siteSettingsEnd Function
Contextアイテムのテクニックを覚えましたか?
各モジュールにチェックマークを表示
ポータルサイトのエンジンの動作原理の2番目のステップは、ページチェックと各モジュールを表示することです.DesktopDefault.aspxは、各モジュールにラベルを表示する責任を負います.動作原理は以下の通りである.
Globalを実行します.asaのApplication_BeginRequestサブプログラムの後、Defaultを実行します.aspx、非行動装置はDesktopDefaultに導く.aspx:
Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load ' Request.Browser("IsMobileDevice") , If Request.Browser("IsMobileDevice") = "true" Then ' MobileDefault.aspx Response.Redirect("MobileDefault.aspx") Else ' ( ) TimeEntry.aspx Response.Redirect("DesktopDefault.aspx") End IfEnd Sub
DesktopDefault.aspxはContext物件のエントリサイト設定を読み込み、ページチェックと各モジュールを表示します.
DesktopDefault.aspxに含まれるDesktopPortalBanner.ascxはラベルの表示を担当し、DesktopPortalBanner.ascxの関連プログラムは次のようになります.各ページタグを参照する権限があるかどうかを確認した後、資料系がページタグdatalistに結び付けられます.
Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load ' Context (HttpContext.Current.Items("PortalSettings")) PortalSettings ( ) Dim _portalSettings As PortalSettings = CType(HttpContext.Current.Items("PortalSettings"), PortalSettings) ' , XML <global portalid="0" portalname="Portal Starter Kit " sitename.text="_portalSettings.PortalName" if request.isauthenticated="True" then welcomemessage.text=" " context.user.identity.name class='Accent"'>| " ' If Context.User.Identity.AuthenticationType = "Forms" Then LogoffLink = "|" & ControlChars.Cr & " " & "" End If End If If ShowTabs = True Then tabIndex = _portalSettings.ActiveTab.TabIndex ' Dim authorizedTabs As New ArrayList() Dim addedTabs As Integer = 0 Dim i As Integer For i = 0 To _portalSettings.DesktopTabs.Count - 1 Dim tab As TabStripDetails = CType(_portalSettings.DesktopTabs(i), TabStripDetails) ' If PortalSecurity.IsInRoles(tab.AuthorizedRoles) Then authorizedTabs.Add(tab) End If If addedTabs = tabIndex Then tabs.SelectedIndex = addedTabs End If addedTabs += 1 Next i ' tabs.DataSource = authorizedTabs tabs.DataBind() End IfEnd Sub</global>
Security.vbのIsInRole()は、次のように、各ページのくじに関するプログラムを参照する権限があるかどうかを確認します.
Public Shared Function IsInRole(ByVal role As String) As Boolean Return HttpContext.Current.User.IsInRole(role)End Function
次はaspxは各モジュールを表示する、ポータルサイトXMLのファイル設定に従って、この選択ページに署名するページのモジュール(.ascx)を左、中間、右のレイアウト、DesktopDefaultに追加する.aspxの関連プログラムは以下の通りです.
Private Sub Page_Init(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Init ' Context (HttpContext.Current.Items("PortalSettings")) PortalSettings ( ) Dim _portalSettings As PortalSettings = CType(HttpContext.Current.Items("PortalSettings"), PortalSettings) ' , AccessDenied.aspx, _portalSettings.ActiveTab.AuthorizedRoles = "All Users;" If PortalSecurity.IsInRoles(_portalSettings.ActiveTab.AuthorizedRoles) = False Then Response.Redirect("~/Admin/AccessDenied.aspx") End If ' (SignIn.ascx) If Request.IsAuthenticated = False And _portalSettings.ActiveTab.TabIndex = 0 Then LeftPane.Controls.Add(Page.LoadControl("~/DesktopModules/SignIn.ascx")) LeftPane.Visible = True End If ' XML , , , If _portalSettings.ActiveTab.Modules.Count > 0 Then Dim _moduleSettings As ModuleSettings For Each _moduleSettings In _portalSettings.ActiveTab.Modules Dim parent As Control = Page.FindControl(_moduleSettings.PaneName) ' user control instance, If _moduleSettings.CacheTime = 0 Then Dim portalModule As PortalModuleControl = CType(Page.LoadControl (_moduleSettings.DesktopSrc), PortalModuleControl) portalModule.PortalId = _portalSettings.PortalId portalModule.ModuleConfiguration = _moduleSettings parent.Controls.Add(portalModule) Else Dim portalModule As New CachedPortalModuleControl() portalModule.PortalId = _portalSettings.PortalId portalModule.ModuleConfiguration = _moduleSettings parent.Controls.Add(portalModule) End If ' parent.Controls.Add(New LiteralControl("")) parent.Visible = True Next _moduleSettings End IfEnd Sub
面白いですか?
Portal Starter Kitダウンロード
Portal Starter Kit英文版ソフトは、オリジナルコードhttp://www.asp.net/Default.aspx?tabindex=9&tabid=47を含む以下のサイトで無料でダウンロードおよび使用できます.
ASP.NET Starter Kit中国語版
ASP.NET Starter Kit中文版软体可到"MSDN下载专区",分次免费下载与使用:http://www.microsoft.com/taiwan/msdn/downloads/default.htm
あるいはMSDN Subscriptionを介して付属する.NETエンタープライズWebサイト錦嚢は、すべての中国語版エントリースイートとアーキテクチャ白書を一度に取得します.関連項目:http://www.microsoft.com/taiwan/msdn/promo/