Dotnetnuke:EditURL与NavigateURL

EditURL与NavigateURL

翻阅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”,” 123” , View_Entry)方法。

同一个模块，不同Control之间的跳动，而且涉及某一个参数的传递，可以使用

EditUrl(KeyName, KeyValue, ControlKey)，如果是Edit Control可以省略为

EditUrl(KeyName, KeyValue)

（3）       在有的时候我们可能需要传递更多的参数，我们使用EditUrl(KeyName, ByVal KeyValue, ControlKey, ByVal ParamArray AdditionalParameters As String())

最后的参数是可以被罗列的，比如

       EditUrl(“CaterogyCode”,” 123” ,”ViewDetail”,”StoreID”,” 431” )

它的含义是，跳转到ViewDetail Control页面里，其中CaterogyCode=123，StoreID=431等等。

（4）       如果我们希望在不同的Tab中进行跳转，比如我跳转到首页，或者已知的某个TabID的页面可以NavigateURL(ByVal TabID As Integer)

以下代码帮助跳转到"产品"页：

 

TabController ctlTab  =   new  TabController();

TabInfo objTab  =  ctlTab.GetTabByName( " 产品 " );

this .Response.Redirect(Globals.NavigateURL(objTab.TabID),  true );

（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等等。具有更大的灵活性，但是使用不多见。