管理文件元信息
文件元信息(Object Meta)包括HTTP header和自定义元信息,详情请参见开发指南中的文件元信息。
设置文件元信息的完整代码请参见GitHub。 修改文件元信息的完整代码请参见GitHub。
以下代码用于设置、修改和获取文件元信息:
using Aliyun.OSS;
using Aliyun.OSS.Common;
var endpoint = "<yourEndpoint>";
var accessKeyId = "<yourAccessKeyId>";
var accessKeySecret = "<yourAccessKeySecret>";
var bucketName = "<yourBucketName>";
var objectName = "<yourObjectName>";
var localFilename = "<yourLocalFilename>";
// 创建OssClient实例。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
try
{
using (var fs = File.Open(localFilename, FileMode.Open))
{
// 创建上传文件的元信息,可以通过文件元信息设置HTTP header。
var metadata = new ObjectMetadata()
{
// 指定文件类型。
ContentType = "text/html",
// 设置缓存过期时间,格式是格林威治时间(GMT)。
ExpirationTime = DateTime.Parse("2025-10-12T00:00:00.000Z"),
};
// 设置上传文件的长度。如超过此长度,则会被截断为设置的长度。如不足,则为上传文件的实际长度。
metadata.ContentLength = fs.Length;
// 设置文件被下载时网页的缓存行为。
metadata.CacheControl = "No-Cache";
// 设置元信息mykey1值为myval1。
metadata.UserMetadata.Add("mykey1", "myval1");
// 设置元信息mykey2值为myval2。
metadata.UserMetadata.Add("mykey2", "myval2");
var saveAsFilename = "文件名测试123.txt";
var contentDisposition = string.Format("attachment;filename*=utf-8''{0}", HttpUtils.EncodeUri(saveAsFilename, "utf-8"));
// 把请求所得的内容存为一个文件的时候提供一个默认的文件名。
metadata.ContentDisposition = contentDisposition;
// 上传文件并设置文件元信息。
client.PutObject(bucketName, objectName, fs, metadata);
Console.WriteLine("Put object succeeded");
// 获取文件元信息。
var oldMeta = client.GetObjectMetadata(bucketName, objectName);
// 设置新的文件元信息。
var newMeta = new ObjectMetadata()
{
ContentType = "application/octet-stream",
ExpirationTime = DateTime.Parse("2035-11-11T00:00:00.000Z"),
// 指定文件被下载时的内容编码格式。
ContentEncoding = null,
CacheControl = ""
};
// 增加自定义元信息。
newMeta.UserMetadata.Add("author", "oss");
newMeta.UserMetadata.Add("flag", "my-flag");
newMeta.UserMetadata.Add("mykey2", "myval2-modified-value");
// 通过ModifyObjectMeta方法修改文件元信息。
client.ModifyObjectMeta(bucketName, objectName, newMeta);
}
}
catch (Exception ex)
{
Console.WriteLine("Put object failed, {0}", ex.Message);
}
说明
- HTTP header详情请参见RFC2616。
- 带自定义Header文件元信息,总大小不超过8KB。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论