基于C#的FTP客户端设计与实现（含源文件）

《基于C#的FTP客户端实现》

目 录

摘要 ................................................................................................................ 错误！未定义书签。 引言 ................................................................................................................ 错误！未定义书签。 1. FTP协议分析 ............................................................................................ 错误！未定义书签。

1.1. FTP的工作原理 ............................................................................ 错误！未定义书签。 1.2. FTP工作模式 ................................................................................ 错误！未定义书签。 1.3. FTP传输模式 ................................................................................ 错误！未定义书签。 2. FTP客户端总体设计 .................................................................................................................. 1

2.1. 设计目的及开发环境 ..................................................................................................... 1

2.1.1. 设计目的与.NET环境简介 ................................................................................ 1 2.1.3. FtpWebRequest 类 ............................................................................................. 2 2.2. 系统UML分析 ................................................................................................................. 3

2.2.1. FTP客户端用例图 .............................................................................................. 3 2.2.2. FTP客户端主要序列图与活动图 ...................................................................... 4 2.2.4. FTP客户端类图 .................................................................................................. 8 2.3. 系统功能模块 ............................................................................................................... 12

2.3.1. 系统整体框架图 ............................................................................................... 12 2.3.2. 客户端功能模块 ............................................................................................... 12 2.3.3. 客户端界面设计 ............................................................................................... 13 2.4. 数据流程图 ................................................................................................................... 16

2.4.1. 客户端连接流程图 ........................................................................................... 16 2.4.2. 上传子模块流程图 ........................................................................................... 18 2.4.3. 下载子模块流程图 ........................................................................................... 19

3. FTP客户端程序实现 ................................................................................................................ 20

3.1. WPF界面设计 ................................................................................................................ 20

3.1.1. 首页界面详细设计 ........................................................................................... 20 3.1.2. 文件传输界面详细设计 ................................................................................... 21 3.1.3. 操作历史记录显示界面详细设计 ................................................................... 23 3.1.4. 常用地址查询模块设计 ................................................................................... 23 3.2. 功能模块实现 ............................................................................................................... 24

3.2.1. 连接服务器 ....................................................................................................... 24 3.2.2. 显示服务器端文件清单 ................................................................................... 25 3.2.3. 上传文件 ........................................................................................................... 25 3.2.4. 下载文件 ........................................................................................................... 26 3.2.5. 查询历史记录 ................................................................................................... 27 3.2.6. 常用地址管理 ................................................................................................... 28

4. 数据库建设 ............................................................................................................................... 28

4.1. 数据库表结构 ............................................................................................................... 28 4.2. 数据库关系模型 ........................................................................................................... 29 4.3. 数据库ER图 ................................................................................................................. 30 4.4. 数据库建表语句 ........................................................................................................... 30 5. 结语........................................................................................................................................... 31 参考文献......................................................................................................................................... 31

基于C#的FTP客户端设计与实现

服务器-FTPFTP请求Ftp响应用户-FTP用户接口服务器a用户用户a1文件传输系统数据连接服务器b用户b2文件传输系统 图 1-1 FTP

工作模式图

上图中用户PI开始控制连接，控制连接与Telnet协议很象。在开始阶段，标准FTP命令由用户PI产生并通图 1-2过控制连接传送到服务器进程。服务器PI向用户PI返回标准应答。FTP命令指定数据连接参数和文件系统操作。用户DTP在特定数据端口侦听，服务器开始数据连接并以指定的参数开始数据传输。数据端口不必在开始FTP命令的机器上，但用户或用户FTP进程必须确定它在指定的数据端口上侦听.这个数据连接是全双工的。

1. FTP客户端总体设计

1.1. 设计目的及开发环境 1.1.1. 设计目的

FTP早已应用在网络的各个方面，比如我们在访问网络上的资源时，经常会遇到需要连接FTP服务器来下载，或者你制作了一个网站，想要将其上传至服务器，让大家能够访问它，这个时候就会用到FTP客户端。虽然平时使用windows自带的IE浏览器即可实现对FTP服务器的访问，但是IE只是个很粗糙的FTP客户端。IE浏览器在6.0以下的版本不支持PASV方式访问服务器，而且IE浏览器在登录FTP服务器的时候，无法查看返回的信息，在出错的时候，无法找到

错误的原因，因此在使用上很不方便。现在大多数的FTP客户端软件都是收费版的，而且以英文版居多，使用上操作很复杂，目前流行的有CoreFtp、AceFtp、FtpVoyager等，但是大多数用户并不习惯使用这些软件。本文所设计的FTP客户端则适合大多数用户使用，界面设计的很简单，使用户可以一目了然，而且具备FTP客户端的基本功能，可以作为下载、上传文件的工具来使用。 1.1.2. NET环境简介

Visual Studio．NET是一个开发和运行软件的新环境，便于开发基于网络的服务，拥有丰富的运行库，支持多种编程语言编写的组件，具有跨语言平台的互操作能力。C#是．NET平台中最重要的语言，它本身没有类库，而是使用．NET框架所提供的统一类库，用户也可以定义特定域的属性，并将它们应用于任何语言元素如类、接口等，所以对网络应用程序提供完整的支援，这使得程序员能够在新的微软．NET平台上快速开发出种类丰富的应用程序。 1.1.3. FtpWebRequest 类

C#.NET类库的存在使它适合于一个不断发展的环境。在类库中我们可以自由地加入新的方法和实例变量而不会影响用户程序的执行。

．NET平台封装了实现FTP功能的一些基础类，位于命名空间为System．Net下的FtpWebRequest类用于实现文件传输协议(FTP)客户端的一些基本功能。二次封装了类FFP_Class,其成员包括string tipserveriP (服务器地址)、string ftpUseriD(登陆账号)、string ftpPassword (登录密码)和FtpWebRequest reqFTP。

本文所使用的FtpWebRequest类的构造方法和主要方法如下：

FtpWebRequest reqFtp = (FtpWebRequest)FtpWebRequest.Create(new Uri(Path));

此构造函数利用给出的主机名建立一条FTP连接，目的连接地址为Path所指定的地址，并建立URI对象。

reqFtp.UseBinary = true;

这条程序指定传输类型为Binary。

reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword); 此方法利用参数ftpUserId和

ftpPassword登录到

FTP服务器。使用过Internet的

用户应该知道，匿名FTP服务器的登录用户名为anonymous，密码一般用自己的电子邮件地址。

2

1.2. 系统UML分析 1.2.1. FTP客户端用例图

1) 0层用例图

图 1-1 0层用例图

用户通过Ftp客户端系统进行文件传输。

2) 1层用例图

图 1-2 1层用例图

在Ftp客户端系统中，主要包括六个用例，分别是列出服务器端文件列表（ListServerFile）、从服务器端下载文件（DownLoadFile）、向服务器端上传文件（UpLoadFile）、列出历史记录（ListHistory）、对常用地址的操作（OpeatUsefulAddress）和输入用户登录信息（EnterUserInfo）。其中，每一个用例都包含EnterUserInfo用例，列出服务器文件列表（ListServerFile）用例扩展了下载文件（DownLoadFile）用例。

3) 二层用例图

a.

ListServerFileList子用例图。

3

图 1-3 2层用例图

ListServerFileList用例包含了两个子用例，分别为列出服务器端文件列表（ShowServerFileList）、打开目录（ChangeDirectory）。打开目录用例指的是打开服务器端子目录，获取子目录。

b. OperatUsefulAddress子用例图。

图 1-4 OperatUsefulAddress子用例图

OperatUsefulAddress用例包含了两个子用例图，分别为显示常用的ftp服务器端地址（ShowUserfulAddress）、添加常用的服务器地址（AddUsefulAddress）。

1.2.2. FTP客户端主要序列图

1) ShowServerFileList序列图

4

图 1-5 ShowServerFileList序列图

2) ChangeDirectory序列图

图 1-6 ChangeDirectory序列图

3) DownLoadFile序列图

5

图 1-7 DownLoadFile序列图

4) UpLoadFile序列图

图 1-8 UpLoadFile序列图

5) ListHistory序列图

6

图 1-9 ListHistory序列图

6) AddUsefulAddress序列图

图 1-10 AddUsefulAddress序列图

1.2.3. FTP客户端主要活动图

1) DownLoadFile活动图

7

图 1-11 DownLoadFile活动图

2) UpLoadFile活动图

图 1-12 UpLoadFile活动图

1.2.4. FTP客户端类图

1) 类关系图

8

图 1-13 FTP客户端类图

2) 边界类-IndexPage、DownLoadPage、HisetoryPage、UsefulAddressPage

图 1-14 边界类

客户端中的主要边界类是显示各功能模块的页面，包括显示主页的IndexPage，显示下载界面的DownLoadPage，显示历史记录的HistoryPage，显示常用地址的UsefulAddressPage。用于与用户的交互，获取用户输入的信息，显示信息。 3) 控制类-DataBaseHander

9

图 1-15 控制类-DataBaseHande

控制类-DataBaseHande，封装了对于数据库的操作，是数据库操作类，包括的方法有： 插入历史记录（InsertHistory） 查找历史记录（selectHistory） 插入常用地址（InsertUsefulAddr） 查找常用地址（selectUsefulAddr） 删除常用地址（DeleteUsefulAddr）

系统通过调用该类对象的该类方法实现对数据库的操作。 4) 控制类-FtpHander

图 1-16 控制类-FtpHander

控制类-FtpHander，封装了对于Ftp文件传输的操作，包括的方法有： 连接Ftp客户端（connect）

获取服务器端文件目录（getServerFileList） 上传文件（UpLoadFile） 下载文件(DownLoadFile)

通过该类实现对于文件的操作和服务器的连接和方法请求。 5) 控制类-LocalHander

10

图 1-17 控制类-LocalHander

控制类-LocalHander，封装了对于本地路径的操作，包括的方法有： 获取本地目录下的文件列表（GetLocalFileList） 客户端通过该类实现对本地文件的操作。 6) 角色类-FtpAddr

图 1-18 角色类-FtpAddr

角色类-FtpAddr，表示Ftp服务器端的抽象类。 属性：

Ftp服务器端名称（FtpName）string型 Ftp服务器端地址（FtpAddress）string型 方法：

获取服务器端名称（getFtpName） 设置服务器端名称（setFtpName） 获取服务器端IP地址（getFtpIPaddr） 设置服务器端IP地址（setFtpIPaddr） 7) 角色类-FileName

图 1-19 7)角色类-FileName

角色类-FileName，表示文件的抽象类。 属性：

文件名称（name）string型 文件大小（size）string型

11

方法：

获取文件名称（getName） 设置文件名称（setName） 获取文件大小（getSize） 设置文件大小（setSize）

1.3. 系统功能模块 1.3.1. 系统整体框架图

文件下载文件上传FTP客户端系统历史记录常用地址查询

图 1-20 系统整体框架图

1.3.2. 客户端功能模块

FTP客户端作为用户连接FTP服务器的工具，需要具备一些基本功能模块，如连接、上传、下载等，其中最主要的五大功能模块如下：

1. 下载功能模块：连接用户指定的FTP服务器，获取服务器目录下的文件列表，

当用户选择项目为文件时，点击下载可以下载用户所需要的文件。选定文件后提示用户将文件存储在何处，用户选择存储区后开始下载任务。依靠FTP协议的支持，用户下载的文件没有类型和大小限制，即用户可已选择任何自己想要下载的文件，通过FTP客户端进行下载。

2. 上传功能模块：用户可以自行选择本机上存储的文件，上传至FTP服务器。

12

在用户选择存储在服务器的位置后，点击上传，选择所需要上传的文件，即可将文件上传至服务器。

3. 连接功能模块：将用户本机与指定的IP地址连接，验证用户命和密码，在

FTP服务器上进行注册。

4. 显示服务器文件模块：显示ftp服务器端的文件列表，包括切换服务器目录

功能。

显示服务器列表显示文件打开目录

图 1-21 显示服务器文件模块

5. 显示历史记录模块：列出以往的操作记录，方便用户查询所下载的文件信息。 6. 常用地址操作模块：包括查询常用地址和增加常用地址两个功能。

常用地址操作添加常用地址查询常用地址

图 1-22 常用地址操作模块

有了这六个基本的功能模块，客户端的基本应用功能即可实现。 1.3.3. 客户端界面设计

为了使用户能够方便的使用FTP客户端，在设计中我将数据输入和信息显示

13

整合在一个页面中，全部客户端仅包含一个主要的窗口，窗口中有4个WPF页分别包括以下四个主要页界面：

1、首页：用户打开软件所见到的的界面。

图 1-23 首页

2、文件传输界面：文件传输界面分为三层结构，第一层为用户下载地址输入层，第二层为目标FTP服务器端文件列表，第三层为本地下载路径中的文件列表。

14

图 1-24 文件传输界面

3、历史记录查询界面：从数据库中读取用户的操作历史记录，让用户查询曾经下载的文件信息。

15

图 1-25 历史记录查询界面

4、常用地址界面，列出常用的ftp服务器地址，方便用户使用，并提供自行添加地址的功能。

图 1-26 常用地址界面

1.4. 数据流程图

1.4.1. 客户端连接流程图

运行客户端后，首先是连接服务器，需要输入服务器IP地址点击连接按钮后开始连接服务器。

下图为客户端连接流程图。

16

开始用户输入用户名及密码发送用户名与密码至服务器连接服务器是是否连接成功否显示连接成功显示连接失败获取服务器文件列表刷新服务器文件显示文件列表开始图 1-27 客户端连接流程图

连接的结果有两种，即图中显示的连接失败和连接成功。

17

1.4.2. 上传子模块流程图

当用户点击上传按钮后，用户可以选择需要上传的文件，将本机上的文件上传至FTP服务器。下图为上传子模块流程图。

开始双击需上传文件获取上传的文件名连接服务器上传文件上传是否成功弹出对话框显示上传成功是否弹出对话框显示上传失败更新服务器文件列表结束图 1-28 上传模块流程图

18

上传的结果有两种，上传失败和成功，失败时会提示用户上传失败，原因可能是权限，如果成功上传，则提示上传成功。 1.4.3. 下载子模块流程图

当用户在服务器文件列表中选择想要下载的文件后，选择需要下载文件在本机上 的存储位置，将服务器上的文件下载至本机。 下图为上传子模块流程图。

开始获取文件列表双击需下载的文件连接服务器下载文件下载是否成功弹出对话框显示下载成功是否弹出对话框显示上传失败更新本地文件列表结束图 1-29 下载模块流程图

19

2. FTP客户端程序实现

2.1. WPF界面设计 2.1.1. 首页界面详细设计

首页左侧有四个按钮连接到不同功能的WPF页，主要界面为欢迎界面，用户可以通过点击按钮选择需要的功能。通过datagrid来布局整个页面。 主要Wpf设计代码：

MouseEnter=\ Click=\

MouseLeave=\ MouseDown=\ MouseUp=\

MouseEnter=\ Click=\

MouseLeave=\ MouseDown=\ MouseUp=\

MouseEnter=\ Click=\

MouseLeave=\ MouseDown=\ MouseUp=\

20

MouseEnter=\ Click=\

MouseLeave=\ MouseDown=\ MouseUp=\

2.1.2. 文件传输界面详细设计

文件传输界面分为三层结构，第一层为用户下载地址输入层，第二层为目标FTP服务器端文件列表，第三层为本地下载路径中的文件列表。通过Grid将整个页面分为三行，每一行嵌入一个stackpanel，并在第一行再次用Grid布局将第一行分为三列，第一列放提示信息用的label，第二列放输入用的inputtex，第三列放一个button控件。

页面结构wpf代码：

第一层用来记录用来输入服务器的站点，用户名和密码信息，然后将信息发送到服务器进行验证，利用inputBox控件来实现。在程序运行时，用户在输入

21

框url中输入的FTP服务器站点。利用点击按钮触发onClick事件获取输入框中的数据，将url中的数据存储至path变量 中，将username中的数据存储至username中; Wpf设计代码：

第二层的作用是是显示服务器文件列表，利用Datagrid控件来实现。在客户端主界面创建一个Datagrid，命名为gridServerFileList，并置于主界面中间，该表格包括三个数据项：文件名file，文件大小filesizes，修改日期filedates，使用一个ListserverFileList来存储这三个数据。当客户端连接上服务器时，表格数据自动更新，主要功能使用getServerfFileList()函数实现。当服务器连接切换到当前目录，通过对WebRequestMethods.Ftp的method赋值为ListDirectory并获取来自服务器端的应答流，读取应答流来实现。

Wpf设计代码：

Background=\ AutoGenerateColumns=\

HorizontalScrollBarVisibility=\ VerticalScrollBarVisibility=\ ouseEnter=\ S

electionChanged=\ MouseUp=\ MouseDoubleClick=\

GridLinesVisibility=\ IsReadOnly=\ M

/Border>

第三层的作用是是显示本地文件列表，和第二层一样利用Datagrid控件来实现。在客户端主界面创建一个Datagrid，命名为localFileList，并置于主界面中间，该表格包括三个数据项：文件名file，文件大小filesizes，修改日期filedates，使用一个ListlocalFileList来存储这三个数据。当客户端连接上本地时，表格数据自动更新，主要功能使用getLocalFileList()函数实现。当服务器连接切换到当前目录，通过对调用GetLocalFileList（）函

22

数获取来自本地目录的应答流，读取应答流来实现。

Wpf设计代码：

AutoGenerateColumns=\ HorizontalScrollBarVisibility=\ VerticalScrollBarVisibility=\

GridLinesVisibility=\IsReadOnly=\ MouseEnter=\

SelectionChanged=\ MouseDoubleClick=\

2.1.3. 操作历史记录显示界面详细设计

这个模块是历史信息显示模块，使用datagrid控件实现。通过从数据库中读取数据，作为datagrid的数据源。 Wpf设计代码：

HorizontalScrollBarVisibility=\ Height=\ HorizontalAlignment=\ VerticalAlignment=\ Width=\

2.1.4. 常用地址查询模块设计

此模块主要存储常用的一些ftp服务器地址方便用户下载资源，用户也可以通过添加按钮添加地址。此模块主要分为两层，上层为信息输入模块，通过一个提示lable，两个输入框inputTex和一个button控件来获取用户输入的服务器端信息。

Wpf布局代码：

23

上层设计代码：

Margin=\ GotFocus=\ LostFocus=\ Margin=\ GotFocus=\ LostFocus=\ Click=\

下层设计代码：

HorizontalScrollBarVisibility=\ Height=\ Width=\ HorizontalAlignment=\ VerticalAlignment=\ MouseRightButtonUp=\

SelectionChanged=\

2.2. 功能模块实现 2.2.1. 连接服务器

客户端中FtpHander类中connect方法用来实现连接服务器功能，在C#.NET中实现这一功能是借助FtpWebRequest类完成的，首先是使用FtpWebRequest类的(FtpWebRequest)FtpWebRequest.Create(new Uri(Path));方法打开远程FTP服务器，然后使用FtpWebRequest类的NetworkCredential(ftpUserId, ftpPassword);方法登录服务器。登录远程FTP服务器有两种方式，一种是注册用户登录，另一种是以匿名方式登录。使用第一种方式登录需要拥有该服务器的注册用户名和密码，匿名方式则是以anonymous作为用户名来登录。类

FtpWebRequest提供了如下两个可用于打开与FTP服务器之间的连接的方法 1.FtpWebRequest.Create(new Uri(Path))用于创建与ftp服务器端连接的对象。 2.reqFtp.UseBinary = true;用于指定数据传输类型

3.reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword);用于建立一条与指定主机、指定端口上的FTP服务器的连接。本文所使用的是第一种方法进行连接，首先定义4个字符串，命名为username，password，分别用来接收来自数据输入界面的数据。然后将接收到的数据发送至服务器验证，验证成功则使用对话框函数在信息显示界面中提示连接成功，失败则显示连接失败。核心代码如下：

reqFtp = (FtpWebRequest)FtpWebRequest.Create(new Uri(Path));//创建对象 reqFtp.UseBinary = true;//指定传输类型

reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword);//登录

24

2.2.2. 显示服务器端文件清单

客户端中实现显示服务器端的文件为FtpHander类中的GetServerFileList(DataGrid gridServerFileList,string path)函数来实现。当用户选择文件下载时，客户端会创建一个到FTP服务器的连接，同样使用FtpWebRequest类的FtpWebRequest.Create(new Uri(Path))方法和reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword);操作登录到服务器，把传输格式设置为二 进 制 格 式 ， 向服务器发送 reqFtp.Method =

WebRequestMethods.Ftp.ListDirectory;操作获取文件列表，利用服务器

FtpWebRequest对象的GetRequestStream （）方法获取服务器端传输过来的数据流，将流中数据写入数组缓存中，并利用streamreader对象读出文件列表的内容放入serverFileList中作为datagrid的数据源显示在datagrid中。核心代码如下：

reqFtp.Method = WebRequestMethods.Ftp.ListDirectory; WebResponse response = reqFtp.GetResponse();

StreamReader reader = new StreamReader(response.GetResponseStream()); string line = reader.ReadLine(); while (line != null) {

FileName fn = new FileName(line); serverFileList.Add(fn); line = reader.ReadLine(); }

//获取文件大小

for (int i = 0; i < serverFileList.Count; i++) { try {

Connect(path + \ + serverFileList[i].name); reqFtp.Method = WebRequestMethods.Ftp.GetFileSize; response = reqFtp.GetResponse(); long fileSize = response.ContentLength; serverFileList[i].size = fileSize.ToString(); }catch(Exception){

serverFileList[i].size = \文件夹\; continue; } }

gridServerFileList.ItemsSource = serverFileList;

2.2.3. 上传文件

客户端中实现上传功能的文件为FtpHander类中的uploadFile函数来实现。当用户选择文件上传时，客户端会创建一个到FTP服务器的连接，同样使用FtpWebRequest类的FtpWebRequest.Create(new Uri(Path))方法和

25

reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword);操作登录到服务器，把传输格式设置为二 进 制 格 式 ， 利用要上传的本地文件构造Filelnfo对象，连接服务器，设置Method属性，通知服务器FtpWebRequest对象的GetRequestStream （）方法创建文件写入流，将缓冲中的内容写入流中，并上传到服务器。文件大小，然后利用缓冲和文件流读取文件内容，通过

FtpWebRequest将 本 地 文 件 上 传 至FTP 服 务 器 。上 传 结 束 后 关闭数据流，一般情况下FTP服务器为了保证其安全性，权限中会设置是否允许用户上传文件。上传失败时，出错处理会在对话框面板中显示出文件上传失败。上传的具体代码见附录。核心代码如下：

Connect(url);

reqFtp.KeepAlive = false;

reqFtp.Method = WebRequestMethods.Ftp.UploadFile;//文件上传请求 reqFtp.ContentLength = fileinfo.Length; int buffLength = 2048;

byte[] buff = new byte[buffLength]; int contentLen;

FileStream fs = fileinfo.OpenRead();//打开文件流读上传的文件 Stream stream = reqFtp.GetRequestStream(); //把上传的文件写入流 contentLen = fs.Read(buff, 0, buffLength); while( contentLen != 0 ){

stream.Write( buff,0,buffLength );

contentLen = fs.Read(buff, 0, buffLength); }

stream.Close(); fs.Close();

2.2.4. 下载文件

客户端下载文件由为FtpHander类中的downloadFile函数来实现。如果用户想要下载列表中的某一个文件，首先判断项目的类型是否是文件，如果是文件，则得到下载的文件名并下载文件，如果选中的是目录，则不能下载。用户选择好要下载的文件后，客户端打开服务器连接端口，使用FtpWebRequest类的FtpWebRequest.Create(new Uri(Path))方法和reqFtp.Credentials = new NetworkCredential(ftpUserId, ftpPassword);操作登录到服务器，把传输格式设置为二进制格式，使用ftpClient.get()函数获得文件名，下载并保存至用户指定的路径。下载完成后ftpClient.closeServer()关闭与服务器的连接并清除线程。当用户下载失败时，出错处理会在信息显示面板中显示下载出错。下载的具体代码见附录。

Connect(path + serverDirectory + \ + serverfileName);

reqFtp.Method = WebRequestMethods.Ftp.DownloadFile;//文件下载请求

26

FtpWebResponse response; Try {

response = (FtpWebResponse)reqFtp.GetResponse();//获得服务器端响应 }

catch (Exception) {

MessageBox.Show(serverfileName + \是目录！不可以下载！\return; }

Stream ftpStream =response.GetResponseStream (); cl =response.ContentLength; ///获取文件大小 int bufferSize=2048;// 设置缓冲 byte[] buffer=new byte[bufferSize];

readcount=ftpStream.Read(buffer,0,bufferSize);

FileStream fs = new FileStream(downLoadFile, FileMode.OpenOrCreate, FileAccess.Write); BinaryWriter rw = new BinaryWriter(fs, Encoding.Default); //将文件通过二进制流下载 while (readcount>0) {

rw.Write(buffer);

readcount=ftpStream.Read (buffer,0,bufferSize); }

rw.Close(); fs.Close();

2.2.5. 查询历史记录

查询历史记录功能主要是通过数据库操作来实现的，我在程序中为数据库操作封装了一个DataBaseHander类，包括查询插入删除方法，每次用户在上传或下载一次文件时，就调用DataBaseHander类的InsertHistory(string filename, string localDirectory, string addr)方法，将此次操作的文件名，存储地址和服务器地址存储进数据库中。每插入成功后就调用SelectHistory( DataGrid gridHistory)函数刷新当前页面重新显示记录内容。核心代码如下：

using (var context = new FtpdbEntities()) {

history h = new history() {

opType = \下载\, tfilename = filename,

localDirectory = localDirectory, addr = addr }; try {

context.history.AddObject(h); context.SaveChanges(); }

27

catch (Exception ex) {

MessageBox.Show(\添加失败\); } }

2.2.6. 常用地址管理

常用地址管理与历史记录查询功能一样主要是通过数据库操作来实现的，我在程序中为数据库操作DataBaseHander类添加了一个

SelectUsefulAddr(DataGrid gridAddr)方法，当打开此页时，就从数据库中读取数据，将常用的地址信息显示在datagrid中，此外，用户还可以自己插入常用的地址。每插入成功后就刷新当前页面重新显示记录内容。核心代码如下：

public void InsertUsefulAddr(string ftpName, string ftpAddr) {

using (var context = new FtpdbEntities()) {

usefulAddr ad = new usefulAddr() {

name = ftpName, addr = ftpAddr, }; try {

context.usefulAddr.AddObject(ad); context.SaveChanges(); }

catch (Exception ex) {

MessageBox.Show(\添加失败\); } } }

3. 数据库建设

3.1. 数据库表结构

因为FTP服务器的主要功能为文件的上传和下载，所以数据库表并不多，主要用于存储下载上传记录和常用的IP地址数据表。

表结构如下图所示： 历史记录表：

28

ID：自增性数据，唯一表示每条记录，主键

Type：int型，标识此次操作为上传还是下载，上传为1，下载为0 Filename：varchar（32），文件名字段，用于存储文件名

Time：smalldatatime类型，默认值为数据插入时间，记录操作的操作时间 Path：varchar（64）型，用以记录文件的下载存放位置

Addr：varchar（16）型，用以记录文件的下载ftp服务端IP地址

常用IP地址数据表：

ID：自增性数据，唯一表示每条记录，主键 Name：varchar（32），服务端名字段，用以记录服务端的名字 Addr：varchar（16），记录服务端的IP地址。

3.2. 数据库关系模型

History（ Id, type, filename, time, path, addr ）； UsefulRecords( Id, name, addr);

29

3.3. 数据库ER图

filenametypetime pathIdHistory操作历史记录ER模型addressnameIdaddrUsefulRecords常用地址表ER模型图 3-1 数据库ER图

3.4. 数据库建表语句

CREATE TABLE history ( Id int identity(1,1) primary key, type int, filename varchar(32), time smalldatetime default getdate(), localDirectory varchar(64), addr varchar(32) ); GO

CREATE TABLE usefulrecords ( Id int identity(1,1) primary key, name varchar(32), addr varchar(16) ); GO

30

4. 结语

FTP的目标是提高文件的共享性和可靠高效地传送数据，而FTP客户端的作用是使用户方便的连接和访问FTP服务器。本次试验实现了一个简单易用的FTP客户端，在分析FTP协议的基本工作原理和FTP的数据传输原理的基础上，详细介绍了如何使用C#.NET工具对FTP客户端进行设计，选择C#.NET类库来实现FTP客户端程序的上传下载等主要功能，并用Microsoft VisioStdio2008软件提供的一个支持可视化编程的开发环境，从而实现了对FTP客户端的开发。虽然现在有很多实现FTP客户端程序的技术和方法，诸如Winsock控件和Delphi的Indy组件等，但是使用C#.NET在程序实现上显得更加简捷灵活，在本次试验中使用的方法也是比较便捷和高效的。

参考文献

31

[1]马俊.C#程序设计及应用教程.人民邮电出版社，2014年1月第3版 [2]谢希仁.计算机网络（第五版）.电子工业出版社,2013年6月第1版

[3]龚俐，毛晓蛟.基于C#的FTP客户端实现.南京师范大学强化培养学院,2010年10月

32

本文来源：https://www.bwwdw.com/article/enio.html