腾讯云对象存储C# SDK

注意您目前查阅的是历史版本 SDK 文档，已不再更新和维护，我们建议您查阅新版 SDK 文档。

开发准备

相关资源

C# SDK github项目下载地址

开发准备

1. SDK 依赖 C# 4.0版本及以上， 推荐使用相同的版本。2. 从控制台获取 APP ID、SecretID、SecretKey。3. 修改园区，CosCloud.cs文件内的URL定义，例如华东：http://sh.file.myqcloud.com/files/v2/ 华北：http://tj.file.myqcloud.com/files/v2/ 华南：http://gz.file.myqcloud.com/files/v2/
（本版本SDK基于JSON API封装组成）

SDK 配置

直接下载 github 上提供的源代码，集成到开发环境。 若需 HTTPS 支持，则将 cos_dotnet_sdk/Api/CosCloud.cs 文件中变量 COSAPI_CGI_URL 中的 HTTP 修改为 HTTPS 即可。

生成签名

多次有效签名

方法原型

public static string Signature(int appId, string secretId, string secretKey, long expired, string bucketName)

参数说明

示例

var sign = Sign.Signature(appId, secretId, secretKey, expired, bucketName); 

单次有效签名

方法原型

public static string SignatureOnce(int appId, string secretId, string secretKey, string remotePath, string bucketName)

参数说明

示例

var sign = Sign.SignatureOnce(appId, secretId, secretKey,remotePath, bucketName); 

更多签名详细说明，请参考 权限控制 。

目录操作

创建目录

接口说明：用于目录的创建，可以通过此接口在指定 bucket 下创建目录。

方法原型

public string CreateFolder(string bucketName, string remotePath, Dictionary parameterDic = null)

参数说明

属性字典说明

返回结果说明

示例

var createFolderParasDic = new Dictionary();                    createFolderParasDic.Add(CosParameters.PARA_BIZ_ATTR,"new attribute");var result = cos.CreateFolder(bucketName, folder, createFolderParasDic);

目录更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

public string UpdateFolder(string bucketName, string remotePath, Dictionary  parameterDic = null) 

参数说明

目录更新参数字典

返回结果说明

示例

var updateParasDic = new Dictionary();                    updateParasDic.Add(CosParameters.PARA_BIZ_ATTR,"new attribute");var result = cos.UpdateFolder(bucketName, folder, updateParasDic);

目录查询

接口说明：用于目录属性的查询，可以通过此接口查询目录的属性。

方法原型

public string GetFolderStat(string bucketName, string remotePath)  

参数说明

返回结果说明

示例

var result = cos.GetFolderStat(bucketName, folder);

目录删除

接口说明：用于目录的删除，可以通过此接口删除空目录，如果目录中存在有效文件或目录，将不能删除。

方法原型

public string DeleteFolder(string bucketName, string remotePath)

参数说明

返回结果说明

示例

var result = cos.DeleteFolder(bucketName, folder);

列举目录下文件&目录

接口说明：用于列举目录下文件和目录，可以通过此接口查询目录下的文件和目录属性。

方法原型

public string GetFolderList(string bucketName, string remotePath, Dictionary  parameterDic = null)

参数说明

目录列表参数字典

返回结果说明

示例

var folderlistParasDic = new Dictionary();                    folderlistParasDic.Add(CosParameters.PARA_NUM,"100");var result = cos.GetFolderList(bucketName, folder, folderlistParasDic);

文件操作

文件上传

接口说明：文件上传的统一接口，对于大于8m的文件，内部会通过多次分片的方式进行文件上传。没有断点续传功能，需要自己用分片上传接口实现。

方法原型

public string UploadFile(string bucketName, string remotePath, string localPath, 	Dictionary  parameterDic = null)

参数说明

文件上传参数字典

返回结果说明

示例

var uploadParasDic = new Dictionary();                uploadParasDic.Add(CosParameters.PARA_BIZ_ATTR,"file attribute");uploadParasDic.Add(CosParameters.PARA_INSERT_ONLY,"0");uploadParasDic.Add(CosParameters.PARA_SLICE_SIZE,SLICE_SIZE.SLIZE_SIZE_3M.ToString());result = cos.UploadFile(bucketName, remotePath, localPath, uploadParasDic);

文件属性更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

public string UpdateFile(string bucketName, string remotePath, Dictionary parameterDic = null)

参数说明

文件更新参数字典

返回结果说明

示例

var optionParasDic = new Dictionary();    optionParasDic.Add(CosParameters.PARA_BIZ_ATTR,"new attribute");    optionParasDic.Add(CosParameters.PARA_AUTHORITY,AUTHORITY.AUTHORITY_PRIVATEPUBLIC);    optionParasDic.Add(CosParameters.PARA_CACHE_CONTROL,"no");    optionParasDic.Add(CosParameters.PARA_CONTENT_TYPE,"application/text");    optionParasDic.Add(CosParameters.PARA_CONTENT_DISPOSITION,"filename=\"test.pdf\"");    optionParasDic.Add(CosParameters.PARA_CONTENT_LANGUAGE,"en");    optionParasDic.Add("x-cos-meta-test","test");result = cos.UpdateFile(bucketName, remotePath, optionParasDic);

文件查询

接口说明：用于文件的查询，可以通过此接口查询文件的各项属性信息。

方法原型

public string GetFileStat(string bucketName, string remotePath)

参数说明

返回结果说明

示例

var result = cos.GetFileStat(bucketName, remotePath);

文件删除

接口说明：用于文件的删除，可以通过此接口删除已经上传的文件。

方法原型

public string DeleteFile(string bucketName, string remotePath) 

参数说明

返回结果说明

示例

var result = cos.DeleteFile(bucketName, remotePath);

分片上传list

接口说明：查询分片上传的情况

方法原型

public string UploadSliceList(string bucketName, string remotePath)

参数说明

返回结果说明

上传完成data的数据说明

上传未完成data的数据说明

示例

var fileSha = SHA1.GetFileSHA1(localPath);var result = SliceUploadInit(bucketName, remotePath, localPath, fileSha, bizAttribute, sliceSize, insertOnly);

分片上传init

接口说明：分片上传的第一次握手,如果上一次分片上传未完成，会返回{“code”:-4019,”message”:”_ERROR_FILE_NOT_FINISH_UPLOAD”}init接口说明：分片上传的第一次握手

方法原型

public string SliceUploadInit(string bucketName, string remotePath, string localPath, string fileSha,string bizAttribute = "", int sliceSize = SLICE_SIZE.SLIZE_SIZE_1M, int insertOnly = 1)

参数说明

返回结果说明

data的数据说明

示例

var fileSha = SHA1.GetFileSHA1(localPath);var result = SliceUploadInit(bucketName, remotePath, localPath, fileSha, bizAttribute, sliceSize, insertOnly);

分片上传

接口说明：分片上传数据

方法原型

public string SliceUploadData(string bucketName, string remotePath, string localPath, string fileSha, string session, long offset,int sliceSise,string sign)

参数说明

返回结果说明

data的数据说明

示例

var fileSha = SHA1.GetFileSHA1(localPath);var result = SliceUploadDataInit(bucketName, remotePath, localPath, fileSha, session, offset, sliceSize,sign);

分片上传 finish

接口说明：告诉COS所有分片上传成功。

方法原型

public string SliceUploadFinish(string bucketName, string remotePath, string localPath, string fileSha, string session)

参数说明

返回结果说明

data的数据说明

示例

result = SliceUploadFinish(bucketName,remotePath,localPath,fileSha, sessionbizAttribute, sliceSize, insertOnly);



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠