[系列文章]上传文件管理控件之v1

上传文件管理控件v1：
总引言：
我是从asp转到asp.net上面来的。这次开发一个上传文件管理的控件，最开始的时候，我是想在asp.net里面把原来asp代码的功能重新实现一遍。结果中途出现了难题，我就打算往asp.net上逐渐迁移。所以这里面上传文件管理控件也就有了4个版本。
V1——类asp代码。
V2——asp.net 1.x　用的 DataGrid
V3——asp.net 2.0 用的GridView
V4——asp.net 2.0 ObjectDataSource + GridView
在我写这个文档的时候，这个4个版本的控件代码还混合在一起，功能上基本只有雏形。我准备四个版本的代码分离开来，重点把v1和v4的完整功能开发出来，v2和v3，暂时就不考虑了。
V1引言：
以前开发asp的时候，根据动网7.0里面模块，改出了一个后台上传文件管理的功能。现在刚刚开始用asp.net开发，不知道相同的功能，得怎么样才能实现。于是我决定先用asp时代的方法试一试吧。
大概的思路是，程序找到要管理的目录，然后获取目录里的所有文件，这时候得到一个文件数组，再将这个数组的所有成员全部罗列出来。删除的时候，向服务器提交要删除的文件名，服务器根据文件名删除文件。
开发的过程中遇到了一些情况，我把这些情况，和解决的过程记在下面。

一、用户控件
从asp+开始，我就接触asp.net了。但是一直以来由于懒惰和其它的原因，断断续续的一直在学，一直也在忘，所以这次，我要把上传文件管理做成一个控件，首先要做的就是翻书看看用户控件是怎么做的。很不幸的是，在asp.net 2.0里面，不怎么重视用户控件，手里的两部近千页的书中都说得不太细，只好结合着msdn来看了。
简而言之，就是在vs2005新建文件的时候，选择类型为“web用户控件"，然后生成一个“.ascx”文件，然后在这个文件里面做一些动作，这就是用户控件。需要的时候，再把这个文件从“解决方案资源管理器”中拖到某个webform里就行了。我这里说得很简单（其实也就是这么简单，其它的东西都是正常asp.net技术），更多的内容，请参考msdn。

二、没有使用代码分离

在使用控件之前，我已经制作一个简单的webform，在里面实现了列举一个文件夹所有文件的功能。一开始，我只不过想做简单的尝试，并且我用的是asp的思路来实现，所以没有采用代码分离（也是没办法采用代码分离）。因为我手里的asp.net 2.0教材全是代码分离的，所以不采用代码分离，反而遇到了一些额外的问题：
·引入命名空间
<%@ Import Namespace="System.IO" %>
这是很白痴的问题，找了好半天，后来把以前的关于1.x的书翻出来，才弄明白。
·类定义
在代码分离模式下，需要"public class XXX"，现在代码不分离，就不知道怎么用了。后来经过测试发现，在没有采用代码分离的情况下，不能在.aspx文件里使用class定义类,应该是省略类定义和相应的花括号，直接写上代码。

三、最初的版本
这里面的功能，主要就是模仿asp时代Fso的代码。

<table width="500" border="1" style="border-collapse:collapse;" bordercolor="#cccccc">
            <tr>
                <td style="width: 102px">文件名
                </td>
                <td style="width: 100px">文件大小(字节)
                </td>
                <td>上传时间
                </td>
            </tr>

<%
      string dirString = @"~/Upload/";
      string dirPath = Server.MapPath(@"~/Upload/");
      System.IO.DirectoryInfo Dir = new System.IO.DirectoryInfo(dirPath);//根据路径获取文件夹
      System.IO.FileInfo[] FileArr = Dir.GetFiles();//所有文件，数组


      //for (int i = 0; i < 5; i++)
      foreach (System.IO.FileInfo f in FileArr)
      {
       %>
            <tr>
                <td style="width: 102px; height: 19px;"><a href="<%= "upload/" + f.Name.ToString() %>" target="_blank"><%= f.Name.ToString() %></a>
                </td>
                <td style="width: 100px; height: 19px;"><%= f.Length %>
                </td>
                <td style="height: 19px"><%= f.LastWriteTime %>
                </td>
            </tr>
<%

}
%>
<tr><td colspan="3" rowspan="3"><%= "一共有文件：" + FileArr.Length %></td>

</tr>
</table>

四、属性/传递参数
好像有句话说，需求推动事物的发展。是的，仅仅如此，似乎也是没有必要做成控件。
以后在实际开发过程中，上传的文件，其实可能会存在于多个目录，所以这个控件得有更好的封装性。其中一条就是，可以不能只限制为一个目录。
那么首先我想到的就是在调用控件的webform上传递参数。请看下面两段代码：
<uc2:ListUpload_v1 id="ListUpload_v1_1" runat="server"></uc2:ListUpload_v1>
<uc2:ListUpload_v1 id="ListUpload_v1_2" runat="server" strDir="section"></uc2:ListUpload_v1>
下面这行，比上面就多出来一个属性“strDir”。就是通过个属性把控件指向了另外一个目录："section"。这就是传递参数的解决办法。
实际上，在asp.net 2.0里，用户组件就是一个类，在调用的页面上，把这个类实例化了。上面的strDir，既然<uc1>这个标签的属性，也是用户组件类的属性。
所以经过修改，V1的代码现在是这样：

<%@ Control Language="C#" ClassName="ListUpload_v1" %>

    public string strDir
    {
        get
        {
            return _strDir;
        }
        set
        {
            _strDir = value;
        }

}

</script>

<table border="1" bordercolor="#cccccc" style="border-collapse: collapse" width="500">
    <tr>
        <td style="width: 20px">
            选</td>
        <td style="width: 102px">
            文件名
        </td>
        <td style="width: 100px">
            文件大小(字节)
        </td>
        <td>
            上传时间
        </td>
    </tr>
    <%
        string dirString = strDir;//我比较喜欢用public属性
        string dirPath = Server.MapPath(dirString);
        System.IO.DirectoryInfo Dir = new System.IO.DirectoryInfo(dirPath);
        System.IO.FileInfo[] FileArr = Dir.GetFiles();
      foreach (System.IO.FileInfo f in FileArr)
      {
    %>
    <tr>
        <td style="width: 20px; height: 49px">
            <asp:CheckBox ID="FileName" runat="server" /></td>
        <td style="width: 102px; height: 49px">
            <a href='<%= "upload/" + f.Name.ToString() %>' target="_blank">
                <%= f.Name.ToString() %>
            </a>
        </td>
        <td style="width: 100px; height: 49px">
            <%= f.Length %>
        </td>
        <td style="height: 49px">
            <%= f.LastWriteTime %>
            <asp:HiddenField ID="HiddenField1" runat="server" />
        </td>
    </tr>
    <%

      }
    %>
    <tr>
        <td colspan="4" rowspan="1" style="height: 19px">
            <asp:Button ID="DELFILE" runat="server" Text="删除" />
            <asp:Label ID="Msg" runat="server"></asp:Label></td>
    </tr>
    <tr>
        <td colspan="4" rowspan="1" style="height: 19px">
            <%= "一共有文件：" + FileArr.Length %>
        </td>
    </tr>
</table>

五、困惑
到这里，控件的一部分功能，已经完成了。但是接下来的情况就让我困惑了：我得怎么删除文件呢？
翻书、上网搜索，一直没有头绪，Button控件的onClick事件，我不知道怎么才能取得checkbox的值！
最开始的时候，曾经尝试“checkbox.Value”，这样的东西，编译的时候，vs提示错误：“System.Web.UI.WebControls.CheckBox”并不包含“Value”的定义”。
确实，checkbox没有这个属性，网上也有人建议用checkbox.Text（这个办法在这里不可行，最终在浏览器显示的不好看。）
在万般无奈、胡思乱想当中，想到了把数据绑定到checkbox上，于是在网上找到了把数组绑定到DataGrid的资料，研究下去，渐渐地就跑题了。而结果这个控件出了四个版本！（当然收获还是蛮巨大的）
再后来，又想要开发自定义组件，组件开发出来了，可是组件开发出来之后却发现，不能动态为组件设置属性。绕了好长一大圈之后，又回到了原点。
六、再次回归asp
接下来，我只好尝试回归到asp的办法，使用html控件，提交表单了。研究发现，在用户控件里面，不能包含<form>标签。好像在asp.net里面一个webform实际上就是一个form，至少在我看到的所有的代码里面就是这样。而在webform里面，同一个用户控件就有可能出现多个实例，那么在用户控件里使用的html控件，就会出现一种特殊的重复。在用户控件内部，html控件很可能是重复的，在用户控件外部，也有可能会和另外一个控件中的html控件重复，还有可能会在同一控件的不同实例之间重复。就拿后一种情况来说，测试的时候，我在测试用的webform里放置了两个上传文件管理控件，一个是针对upload目录，另一个是针对section目录。如果我在用户控件里面放置的Input(checkbox)控件name属性如果设置为"Filename"，那么提交表单的时候，引用的Request.Form["Filename"]，就有可能同时包含了upload目录和section目录的文件。在有些场合下，这么做可能会很有用，但是我担心会出现一些不可预料的问题，所以我决定，还是得要避免“html控件在用户控件外部出现重复”这种情况。
在我之前的研究中发现，用户控件在webform显示给客户端浏览器的时候，都会加上用户控件实例的名称。比如说，我前没尝试使用checkbox控件的时候，在.ascx文件里指定ID为"file_name"，那么在浏览器里就可能有变成id="ListUpload_v1_1$file_name"。为了避免前述的控件外部重复，我就打起了实列名称的主意。
面向对象太深的原理，我不懂，但是我相信一个类、一个控件在实例化之后都有一个名称、编号（会不会有指针？）。那么在编程的时候怎么样才能获得这个类被实例化以后，它的名称和编号？这个问题，在我半年前开发OO的JavaScript时，困扰了很久却仍未有结果，不过今天不一样了，今天用的是C#，万岁C#！没怎么费力，我试着输入this.i之后，vs2005打开了代码提示，并替我指向其中的ID，万岁vs2005！
于是这个html控件就做好了：
<input type="checkbox" name="<%= ID %>_Filname" value="<%=f.Name %>"/>
然后是获取表单：
String fullCheckBoxName = ID + "_Filname";
string[] form = Context.Request.Form[fullCheckBoxName].Split(',');//将string拆分成数组
获取表单的时候，和开发asp是不一样的，详细情况我在代码里面有说明。
再之后，就是删除文件了。

六、后记：
到此为止，我这个“上传文件管理控件v1版”，基本功能就开发完毕了。实际项目中，这种asp模式基本上是没有什么用的，但是通过这个东西却让我学习了不少知识，开辟了通向v2 v3 v4的道路。
另外注意，这里也并不是最完整的功能，离实际应用还差一些。从方便性来讲，还应该加上“全选”这样的功能。从安全性来讲，这个控件可以删除服务器上任何目录里的文件（只要asp.net进程和IIS有权限）,它也是一个安全隐患。所以最终的版本里，我会限制一下，strDir属性只能指向有限的几个目录。
附：源代码下载https://files.cnblogs.com/xpnew/ListUpload_v1.rar
我的博客：柳城别日http://xpnew.cnblogs.com 我的邮箱：xpnew@126.com
[注：2008年5月28日修改几个错别字，有一些新的情况出现，但是我得把一系列文章都写完再修改内容方面的问题。]

posted @ 2008-05-24 05:38 柳城之城阅读(1920) 评论(2) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

柳城别日

[系列文章]上传文件管理控件之v1

公告