增加listFiles支持，更新文档及示例代码

Author: fengyhack

Docs/imgs/BucketManager.png

@@ -111,7 +111,25 @@ C# SDK引用了第三方的开源项目[Json.NET](http://www.newtonsoft.com/json
 
 #####简单处理
 
-支持stat、copy、move、delete等，具体可参阅BucketManager模块说明。
+支持stat、copy、move、delete,listFiles等，具体可参阅BucketManager模块说明。
+
+######关于获取空间文件列表(listFiles)的说明：
+ 
+    METHOD:    listFiles(bucket, prefix, marker, limit, delimiter)
+	-----------------------------------------------------------------------
+    bucket:    目标空间名称
+    prefix:    返回指定文件名前缀的文件列表(prefix可设为null)
+    marker:    考虑到设置limit后返回的文件列表可能不全(需要重复执行listFiles操作)
+               执行listFiles操作时使用marker标记来追加新的结果
+               特别注意首次执行listFiles操作时marker为null               
+    limit:     每次返回结果所包含的文件总数限制(limit<=1000，建议值100)
+    delimiter: 分隔符，比如-或者/等等，可以模拟作为目录结构(参考下述示例)
+               假设指定空间中有2个文件 fakepath/1.txt fakepath/2.txt
+               现设置delimiter=/ 得到结果items =[]，commonPrefixes = [fakepath/]
+			   调整prefix=fakepath/ delimiter=null 得到所需结果items=[1.txt,2.txt]
+               于是可以在本地先创建一个目录fakepath,然后在该目录下写入items中的文件
+
+
 
 #####批量处理
 

README.md

@@ -24,34 +24,37 @@ static void Main(string[] args)
             //ResumableUpload.uploadBigFile();
 
             // 空间文件stat
-            //BucketFileManagemt.stat();
+            //BucketFileManagement.stat();
 
             // 删除空间文件
-            //BucketFileManagemt.delete();
+            //BucketFileManagement.delete();
 
             // 复制空间文件
-            //BucketFileManagemt.copy();
+            //BucketFileManagement.copy();
 
             // 移动空间文件
-            //BucketFileManagemt.move();
+            //BucketFileManagement.move();
 
             // 修改空间文件的mimeType
-            //BucketFileManagemt.chgm();
+            //BucketFileManagement.chgm();
 
             // 批量操作
-            //BucketFileManagemt.batch();
+            //BucketFileManagement.batch();
 
             // 取回文件并保存到空间
-            //BucketFileManagemt.fetch();
+            //BucketFileManagement.fetch();
 
             // 镜像资源更新
-            //BucketFileManagemt.prefetch();
+            //BucketFileManagement.prefetch();
 
             // 列举所有bucket
-            //BucketFileManagemt.buckets();
+            //BucketFileManagement.buckets();
 
             // 获取指定bucket的域名
-            //BucketFileManagemt.domains();
+            //BucketFileManagement.domains();
+
+            // 获取空间文件列表
+            // BucketFileManagement.listFiles();
 
             // 文件处理+保存处理结果
             //PfopWithPipeline.pfopAndSave();

examples/App.cs

@@ -2,13 +2,14 @@
 using Qiniu.Storage;
 using Qiniu.Storage.Model;
 using Qiniu.Http;
+using System.Collections.Generic;
 
 namespace QiniuDemo
 {
     /// <summary>
     /// 空间及空间文件管理
     /// </summary>
-    public class BucketFileManagemt
+    public class BucketFileManagement
     {
 
         /// <summary>
@@ -173,5 +174,70 @@ public static void domains()
                 System.Console.WriteLine(domain);
             }
         }
+
+        /// <summary>
+        /// 获取空间文件列表
+        /// 
+        /// BucketManager.listFiles(bucket, prefix, marker, limit, delimiter)
+        /// 
+        /// bucket:    目标空间名称
+        /// 
+        /// prefix:    返回指定文件名前缀的文件列表(prefix可设为null)
+        /// 
+        /// marker:    考虑到设置limit后返回的文件列表可能不全(需要重复执行listFiles操作)
+        ///            执行listFiles操作时使用marker标记来追加新的结果
+        ///            特别注意首次执行listFiles操作时marker为null   
+        ///            
+        /// limit:     每次返回结果所包含的文件总数限制(limit<=1000，建议值100) 
+        /// 
+        /// delimiter: 分隔符，比如-或者/等等，可以模拟作为目录结构(参考下述示例)
+        ///            假设指定空间中有2个文件 fakepath/1.txt fakepath/2.txt
+        ///            现设置分隔符delimiter = / 得到返回结果items =[]，commonPrefixes = [fakepath/]
+        ///            然后调整prefix = fakepath/ delimiter = null 得到所需结果items = [1.txt,2.txt]
+        ///            于是可以在本地先创建一个目录fakepath,然后在该目录下写入items中的文件  
+        ///            
+        /// </summary>
+        public static void listFiles()
+        {
+            Mac mac = new Mac(Settings.AccessKey, Settings.SecretKey);
+
+            string bucket = "BUCKET";
+            string marker = ""; // 首次请求时marker必须为空
+            string prefix = null; // 按文件名前缀保留搜索结果
+            string delimiter = null; // 目录分割字符(比如"/")
+            int limit = 100; // 最大值1000
+
+            BucketManager bm = new BucketManager(mac);
+            List<FileDesc> items = new List<FileDesc>();
+            List<string> commonPrefixes = new List<string>();
+
+            do
+            {
+                ListFilesResult result = bm.listFiles(bucket, prefix, marker, limit, delimiter);
+                
+                marker = result.Marker;
+                
+                if (result.Items != null)
+                {
+                    items.AddRange(result.Items);
+                }
+
+                if (result.CommonPrefixes != null)
+                {
+                    commonPrefixes.AddRange(result.CommonPrefixes);
+                }
+
+            } while (!string.IsNullOrEmpty(marker));
+
+            foreach (string cp in commonPrefixes)
+            {
+                System.Console.WriteLine(cp);
+            }
+
+            foreach(var item in items)
+            {
+                System.Console.WriteLine(item.Key);
+            }
+        }
     }
 }

examples/BucketFileManagemt.cs renamed to examples/BucketFileManagement.cs

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<packages>
+  <package id="Newtonsoft.Json" version="9.0.1" targetFramework="net40" />
+</packages>