DotNetNuke模块制作Super-Simple(DAL+)教程-翻译

为入门者准备! (适用于 DotNetNuke Version 4.3.1 or higher) 使用 VB.NET 或 C#

这个教程向你演示如何创建一个使用DAL+“ExecuteSQL”方法的DotNetNuke模块，DAL+是DotNetNuke数据存取层(Data Access Layer, DAL)的一个扩展。

步骤

1. 安装Visual Studio Express (点击下载)

2. 安装SQL Server Express (点击下载)

3. 使用下面两种方法中的一种安装DotNetNuke并创建一个DotNetNuke网站

l Setting-up the Development Environment (using IIS)

l Setting-up the Development Environment (without IIS)

4. 在Visual Studio,选择“Build”下的“Build Solution”，如果顺利通过编译，我们就可以进入下一步。

 

 

 

是否已经具备开发的环境了?

你必须有一个已经架好并能运行的DotNetNuke 4 网站才可以进行下一步，如果你没做到这一点，可以使用这个链接 和 这个链接 寻求帮助。

DotNetNuke不断的在更新，所以DotNetNuke的论坛 是寻找最新的帮助和信息最好的地方。

非常抱歉我没法为网站架设提供单独的技术支持，不过我会对跟本篇教程有关的问题提供帮助。

 

 

创建模块

创建模块的分为两步：

1. 创建view控件
2. 在DotNetNuke中注册这个模块

 

 

创建模块目录

在Visual Studio中打开你的DotNetNuke网站

 

 

 

 

 

 

 

 

 

 

 

创建View控件

在"DesktopModules" 目录上右键，选择"New Folder"

 

 

 

 

新建的目录命名为"SuperSimple"

 

 

 

然后在"SuperSimple"目录上右键，选择 "Add New Item..."    

 

 

 

 

 

 

点击"Add New Item"后出现一个对话框：

点击"Visual Studio Installed Templates"下的"Web User Control"

• 在"Name"后面输入"SuperSimple.ascx"
• 确保"Place code in a separate file"已经选中
• 点击"Add"按键

 

 

 

 

 

 

 

一个"SuperSimple.ascx"文件会在"DesktopModules"目录下的"SuperSimple"目录内创建。

 

 

 

 

点击文件旁边的“加号”就会显示现关联的code behind文件"SuperSimple.ascx.vb" (或者 "SuperSimple.ascx.cs").

 

 

 

双击"SuperSimple.ascx"文件，主编辑窗口就会打开它，这个时候页面还只是一片空白。

点击页面左下角的"Source"按键，转换到源代码视图。

 

 

 

 

输入如下的代码：

VB:

<%@ Control Language="VB" AutoEventWireup="false" CodeFile="SuperSimple.ascx.vb" 



Inherits="DesktopModules_SuperSimple_SuperSimple" %> 



Search:&nbsp; 



<asp:TextBox ID="txtSearch" runat="server"></asp:TextBox>&nbsp; 



<asp:Button ID="btnSearch" runat="server" Text="Button" /><br /> 



<br /> 



<asp:GridView ID="GridView1" runat="server"> 



</asp:GridView> 

 

C#:

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="SuperSimple.ascx.cs" 



Inherits="DesktopModules_SuperSimple_SuperSimple" %> 



Search:&nbsp; 



<asp:TextBox ID="txtSearch" runat="server"></asp:TextBox>&nbsp; 



<asp:Button ID="btnSearch" runat="server" Text="Button" OnClick="btnSearch_Click" /><br /> 



<br /> 



<asp:GridView ID="GridView1" runat="server"> 



</asp:GridView> 

点击页面左下角的"Design"按键转换到设计视图

 

 

 

 

 

 

 

双击"SuperSimple.ascx.vb" (或 "SuperSimple.ascx.cs")

 

 

把里面的代码用下面的代码完全替换：

VB:

Imports DotNetNuke 



Imports System.Web.UI 



Imports System.Collections.Generic 



Imports System.Reflection 



Imports DotNetNuke.Security.PortalSecurity 



Partial Class DesktopModules_SuperSimple_SuperSimple 



Inherits Entities.Modules.PortalModuleBase 



Protected Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 



If Not Page.IsPostBack Then 



ShowData("") 



End If 



End Sub 



Protected Sub btnSearch_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnSearch.Click 



ShowData(txtSearch.Text) 



End Sub 



Private Sub ShowData(ByVal SearchString As String) 



Dim mySqlString As New StringBuilder() 



mySqlString.Append("SELECT FriendlyName, Description ") 



mySqlString.Append("FROM {databaseOwner}{objectQualifier}DesktopModules ") 



mySqlString.Append("WHERE Description like '%' + @SearchString + '%' ") 



mySqlString.Append("ORDER BY FriendlyName") 



Dim myParam As SqlParameter = New SqlParameter("@SearchString", SqlDbType.VarChar, 150) 



myParam.Value = SearchString 



Me.GridView1.DataSource = CType(DataProvider.Instance().ExecuteSQL(mySqlString.ToString(), myParam), IDataReader) 



Me.GridView1.DataBind() 



End Sub 



End Class 

C#:

using DotNetNuke; 



using System.Web.UI; 



using System.Text; 



using System.Collections.Generic; 



using System.Reflection; 



using DotNetNuke.Security; 



using System.Data.SqlClient; 



using System.Data; 



using DotNetNuke.Data; 



partial class DesktopModules_SuperSimple_SuperSimple : DotNetNuke.Entities.Modules.PortalModuleBase 



{ 



protected void Page_Load(object sender, System.EventArgs e) { 



if (!Page.IsPostBack) 



{ 



ShowData(""); 



} 



} 



protected void btnSearch_Click(object sender, System.EventArgs e) { 



ShowData(txtSearch.Text); 



} 



private void ShowData(string SearchString) { 



StringBuilder mySqlString = new StringBuilder(); 



mySqlString.Append("SELECT FriendlyName, Description "); 



mySqlString.Append("FROM {databaseOwner}{objectQualifier}DesktopModules "); 



mySqlString.Append("WHERE Description like \'%\' + @SearchString + \'%\' "); 



mySqlString.Append("ORDER BY FriendlyName"); 



SqlParameter myParam = new SqlParameter("@SearchString", SqlDbType.VarChar, 150); 



myParam.Value = SearchString; 



this.GridView1.DataSource = ((IDataReader)(DataProvider.Instance().ExecuteSQL(mySqlString.ToString(), myParam))); 



this.GridView1.DataBind(); 



} 



} 

从BUILD 菜单下选择"Build Page".

 

 

 

 

页面应该能通过编译

 

 

 

在 DotNetNuke中注册模块

使用"host"登录到你的DotNetNuke站点，在菜单中选择"Host"然后选择 "Module Definitions"。

 

 

 

 

 

 

 

 

 

点击左上角向下的小黑箭头，在出现的菜单中选择"Create New Module"。

 

 

 

在 Edit Module Definitions菜单里：

• 在MODULE NAME处输入"SuperSimple"
• 在FOLDER TITLE处输入"SuperSimple"
• 在FRIENDLY TITLE处输入"SuperSimple"
• 在DESCRIPTION处输入"SuperSimple"
• 在VERSION处输入"1.0"

然后点击UPDATE

 

 

 

 

 

 

在 NEW DEFINITION 输入 "SuperSimple"

然后点击 "Add"

 

 

然后点击 "Add Control"

 

 

 

 

在 Edit Module Control 菜单里：

• 在TITLE处 输入 "SuperSimple"
• 在SOURCE处从下拉列表中选择 "DesktopModule/SuperSimple/SuperSimple.ascx"
• 在TYPE 处从下拉列表中选择"View"

然后点击 UPDATE

 

 

 

 

在网站的左上角的PAGE FUNCTIONS菜单里点击ADD。

 

 

 

 

 

 

 

 

在PAGE MANAGEMENT 菜单的 PAGE DETAILS里：

• 在PAGE NAME 处输入"SuperSimple"
• 在 PAGE TITLE处输入"SuperSimple"
• 在DESCRIPTION处输入"SuperSimple"
• 在 VIEW PAGE 下面选中 ALL USERS

点击“UPDATE”

 

 

 

 

 

在 MODULE 的下拉列表中选择 "SuperSimple".

 

 

 

 

 

 

 

 

 

 

然后点击 ADD.

 

 

模块将在页面上显示

 

 

 

 

 

 

 

 

原为地址：http://www.adefwebserver.com/DotNetNukeHELP/DNN_ShowMeThePages/

本文译者m2land，转载请注明出处，作者博客地址：http://m2land.cnblogs.com