C# FTP WebRequest对象介绍
微软的.NET framework 2.0相对于1.x来说增加了对FTP的支持。以前为了符合我的需求,我不等不使用第三方类库来实现FTP功能,但是为了可靠,还是使用.NET framework的类比较好。我的这段代码没有做成可重复使用的类库的形式,但它却是比较容易理解的并能满足你的需求。它可以实现上传,下载,删除等任意功能。在这篇文章的后面将给大家出示.NET 2.0下实现FTP的简单代码,使用的语言是c#。或许是因为这是.NET新增的类,又或许是第三方类库已经能很好的实现你的需求,.NET 2.0的这部分类库并没有得到足够的关注。
背景
作为我的工作的一部分,我已经使用了FTP模块,但是我只能在.NET 1.1中去使用它,所以我不能深入的研究.NET 2.0下FTP的实现。但是我相信,.NET 2.0下对FTP的支持是非常好的。
代码
不要忘记引入命名空间
using System.NET;
using System.IO;
下面的几个步骤包括了使用FTP WebRequest类实现FTP功能的一般过程
1、创建一个FTP WebRequest对象,指向FTP服务器的uri
2、设置FTP的执行方法(上传,下载等)
3、给FTP WebRequest对象设置属性(是否支持ssl,是否使用二进制传输等)
4、设置登录验证(用户名,密码)
5、执行请求
6、接收相应流(如果需要的话)
7、如果没有打开的流,则关闭FTP请求
开发任何FTP应用程序都需要一个相关的FTP服务器及它的配置信息。FTP WebRequest暴露了一些属性来设置这些信息。
接下来的代码示例了上传功能,首先设置一个uri地址,包括路径和文件名。这个uri被使用在FTP WebRequest实例中。
然后根据FTP请求设置C# FTP WebRequest对象的属性
其中一些重要的属性如下:
◆Credentials - 指定登录FTP服务器的用户名和密码。
◆KeepAlive - 指定连接是应该关闭还是在请求完成之后关闭,默认为true
◆UseBinary - 指定文件传输的类型。有两种文件传输模式,一种是Binary,另一种是ASCII。两种方法在传输时,字节的第8位是不同的。ASCII使用第8位作为错误控制,而Binary的8位都是有意义的。所以当你使用ASCII传输时要小心一些。简单的说,如果能用记事本读和写的文件用ASCII传输就是安全的,而其他的则必须使用Binary模式。当然使用Binary模式发送ASCII文件也是非常好的。
◆UsePassive - 指定使用主动模式还是被动模式。早先所有客户端都使用主动模式,而且工作的很好,而现在因为客户端防火墙的存在,将会关闭一些端口,这样主动模式将会失败。在这种情况下就要使用被动模式,但是一些端口也可能被服务器的防火墙封掉。不过因为FTP服务器需要它的FTP服务连接到一定数量的客户端,所以他们总是支持被动模式的。这就是我们为什么要使用被动模式的原意,为了确保数据可以正确的传输,使用被动模式要明显优于主动模式。(译者注:主动(PORT)模式建立数据传输通道是由服务器端发起的,服务器使用20端口连接客户端的某一个大于1024的端口;在被动(PASV)模式中,数据传输的通道的建立是由FTP客户端发起的,他使用一个大于1024的端口连接服务器的1024以上的某一个端口)
◆ContentLength - 设置这个属性对于FTP服务器是有用的,但是客户端不使用它,因为FTP WebRequest忽略这个属性,所以在这种情况下,该属性是无效的。但是如果我们设置了这个属性,FTP服务器将会提前预知文件的大小(在upload时会有这种情况)
◆Method - 指定当前请求是什么命令(upload,download,filelist等)。这个值定义在结构体WebRequestMethods.FTP中。以上介绍C# FTP WebRequest对象。
- private void Upload(string filename){
- FileInfo fileInf = new FileInfo(filename);
- string uri = "ftp://" + ftpServerIP + "/" + fileInf.Name;
- FtpWebRequest reqFTP;
- // 根据uri创建FtpWebRequest对象
- reqFTP = (FtpWebRequest)FtpWebRequest.Create(new Uri
("ftp://" + ftpServerIP + "/" + fileInf.Name));- // ftp用户名和密码
- reqFTP.Credentials = new NetworkCredential(ftpUserID, ftpPassword);
- // 默认为true,连接不会被关闭
- // 在一个命令之后被执行
- reqFTP.KeepAlive = false;
- // 指定执行什么命令
- reqFTP.Method = WebRequestMethods.Ftp.UploadFile;
- // 指定数据传输类型
- reqFTP.UseBinary = true;
- // 上传文件时通知服务器文件的大小
- reqFTP.ContentLength = fileInf.Length;
- // 缓冲大小设置为2kb
- int buffLength = 2048;
- byte[] buff = new byte[buffLength];
- int contentLen;
- // 打开一个文件流 (System.IO.FileStream) 去读上传的文件
- FileStream fs = fileInf.OpenRead();
- try
- {
- // 把上传的文件写入流
- Stream strm = reqFTP.GetRequestStream();
- // 每次读文件流的2kb
- contentLen = fs.Read(buff, 0, buffLength);
- // 流内容没有结束
- while (contentLen != 0)
- {
- // 把内容从file stream 写入 upload stream
- strm.Write(buff, 0, contentLen);
- contentLen = fs.Read(buff, 0, buffLength);
- }
- // 关闭两个流
- strm.Close();
- fs.Close();
- }
- catch (Exception ex)
- {
- MessageBox.Show(ex.Message, "Upload Error");
- }
- }
【编辑推荐】