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的论坛是寻找最新的帮助和信息最好的地方。

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

创建模块

创建模块的分为两步：

创建view控件
在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(); 



} 



}