翻阅DNN的代码,经常会碰到使用EditURL函数,比如,最常见的我们在可以编辑的Item前面有一支笔,点击后就跳到编辑的页面:
<asp:HyperLink NavigateUrl='<%# EditURL("ItemID",DataBinder.Eval(Container.DataItem,"ItemID")) %>' Visible="<%# IsEditable %>" runat="server" ID="Hyperlink1"><asp:Image ID=Hyperlink1Image Runat=server ImageUrl="~/images/edit.gif" AlternateText="Edit" Visible="<%#IsEditable%>" resourcekey="Edit"/></asp:hyperlink>
EditURL主要是为了跳转到Edit页面而定义的,当然它也可以跳转到其他Control页面。它在模块的基类PortalModuleBase中被定义。它被重载了5次,可以什么参数都不带,也可以Public Function EditUrl(ByVal KeyName As String, ByVal KeyValue As String, ByVal ControlKey As String, ByVal ParamArray AdditionalParameters As String()) As String
它处在模块的基类中,很方便使用,也是出镜率很高的函数之一。
它调用Global.vb中NavigateURL函数,这是一个Static函数。NavigateURL调用Global.vb中的FriendlyUrl函数,该函数按照Provider的机制加载相应的DNNFriendlyUrlProvider
DotNetNuke.Services.Url.FriendlyUrl.FriendlyUrlProvider.Instance().FriendlyUrl(tab, path, pageName, portalAlias)
在DNN 的开发过程中,经常需要跳转页面,下面就不同的场合下给出解决的对策(以下描述的主要是目标URL串如何生成):
(1) 在模块定义中定义了两个或多个Control,需要从一个Control页面跳到另一个页面。
同一个模块,不同Control之间的跳动,而且不涉及参数的传递,使用EditUrl(ControlKey)
(2) 上述的情况,在很多情况下我们需要传入一些参数,特别是ItemID,在接收的模块中会提取此参数进行判断。比如在Blog模块中:
定义了View_Entry Control,可能需要从View Blog中跳转,就可以用EditUrl(“ItemID”,”
同一个模块,不同Control之间的跳动,而且涉及某一个参数的传递,可以使用
EditUrl(KeyName, KeyValue, ControlKey),如果是Edit Control可以省略为
EditUrl(KeyName, KeyValue)
(3) 在有的时候我们可能需要传递更多的参数,我们使用EditUrl(KeyName, ByVal KeyValue, ControlKey, ByVal ParamArray AdditionalParameters As String())
最后的参数是可以被罗列的,比如
EditUrl(“CaterogyCode”,”
它的含义是,跳转到ViewDetail Control页面里,其中CaterogyCode=123,StoreID=431等等。
(4) 如果我们希望在不同的Tab中进行跳转,比如我跳转到首页,或者已知的某个TabID的页面可以NavigateURL(ByVal TabID As Integer)
以下代码帮助跳转到"产品"页:
(5)
Public Function NavigateURL(ByVal TabID As Integer, ByVal IsSuperTab As Boolean, ByVal settings As PortalSettings, ByVal ControlKey As String, ByVal ParamArray AdditionalParameters As String()) As String
函数,借助它能够带上ControlKey以及N多的额外参数。
总结上面两个函数:
在同一个模块不同Control之间跳转,可以使用EditUrl。
在不同Tab之间跳转使用NavigateUrl。
他们都可以传递若干参数。
这两个函数都是没有办法改变最终的aspx文件名的,但是Globals.vb中定义的FriendlyUrl可以实现Path的自定义,更换*.aspx等等。具有更大的灵活性,但是使用不多见。