为入门者准备! (适用于 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网站
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:
Inherits="DesktopModules_SuperSimple_SuperSimple" %>
Search:
C#:
Inherits="DesktopModules_SuperSimple_SuperSimple" %>
Search:
点击页面左下角的"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.
模块将在页面上显示
本文译者m2land,转载请注明出处,作者博客地址:http://m2land.cnblogs.com