你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

IDocumentClient.CreateAttachmentAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Documents

程序集:: Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

包:: Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)	在 Azure Cosmos DB 服务中将附件创建为异步操作。
CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)	在 Azure Cosmos DB 服务中将附件创建为异步操作。
CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)	Attachment使用 Azure Cosmos DB 服务中作为异步操作提供`mediaStream`的内容创建。
CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)	在 Azure Cosmos DB 服务中将附件创建为异步操作。

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)

在 Azure Cosmos DB 服务中将附件创建为异步操作。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> CreateAttachmentAsync (string documentLink, object attachment, Microsoft.Azure.Documents.Client.RequestOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAttachmentAsync : string * obj * Microsoft.Azure.Documents.Client.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>>

Public Function CreateAttachmentAsync (documentLink As String, attachment As Object, Optional options As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse(Of Attachment))

参数

documentLink: String

此新附件的父文档的链接。例如 dbs/db_rid/colls/col_rid/docs/doc_rid/

attachment: Object

附件对象。

options: RequestOptions

(可选) 请求的请求选项。

cancellationToken: CancellationToken

(可选) A CancellationToken ，可供其他对象或线程用来接收取消通知。

Task<ResourceResponse<Attachment>>

表示 Task 异步操作的服务响应的对象。

示例

以下示例创建一个新文档，然后为该文档创建新的附件

dynamic d = new
{
    id = "DOC1800243243470"
};

Document doc = await client.CreateDocumentAsync(collectionSelfLink, d);

//Create an Attachment which links to binary content stored somewhere else
//Use the MediaLink property of Attachment to set where the binary resides
//MediaLink can also point at another Attachment within Azure Cosmos DB.
Attachment a = await client.CreateAttachmentAsync(doc.SelfLink, new Attachment { Id = "foo", ContentType = "text/plain", MediaLink = "link to your media" });

//Because Attachment is a Dynamic object you can use SetPropertyValue method to any property you like
//Even if that property doesn't exist. Here we are creating two new properties on the Attachment we created above.
a.SetPropertyValue("Foo", "some value");
a.SetPropertyValue("Bar", "some value");

//Now update the Attachment object in the database to persist the new properties on the object
client.ReplaceAttachmentAsync(a);

//Let's now create another Attachment except this time we're going to use a Dynamic object instead
//of a <see cref="Microsoft.Azure.Documents.Attachment"/> as we did above.
var b = await client.CreateAttachmentAsync(doc.SelfLink, new { id = "foo", contentType = "text/plain", media="link to your media", a = 5, b = 6 });

//Now you will have a Document in your database with two attachments.

另请参阅

适用于

CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

在 Azure Cosmos DB 服务中将附件创建为异步操作。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> CreateAttachmentAsync (Uri documentUri, object attachment, Microsoft.Azure.Documents.Client.RequestOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAttachmentAsync : Uri * obj * Microsoft.Azure.Documents.Client.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>>

Public Function CreateAttachmentAsync (documentUri As Uri, attachment As Object, Optional options As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse(Of Attachment))

参数

documentUri: Uri

要为其创建附件的文档的 URI。

attachment: Object

附件对象。

options: RequestOptions

(可选的) RequestOptions 请求的。

cancellationToken: CancellationToken

(可选) A CancellationToken ，可供其他对象或线程用来接收取消通知。

Task<ResourceResponse<Attachment>>

表示异步操作的服务响应的任务对象。

适用于

CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)

Attachment使用 Azure Cosmos DB 服务中作为异步操作提供mediaStream的内容创建。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> CreateAttachmentAsync (string attachmentsLink, System.IO.Stream mediaStream, Microsoft.Azure.Documents.Client.MediaOptions options = default, Microsoft.Azure.Documents.Client.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAttachmentAsync : string * System.IO.Stream * Microsoft.Azure.Documents.Client.MediaOptions * Microsoft.Azure.Documents.Client.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>>

Public Function CreateAttachmentAsync (attachmentsLink As String, mediaStream As Stream, Optional options As MediaOptions = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse(Of Attachment))

参数

attachmentsLink: String

文档的附件链接。例如 dbs/db_rid/colls/col_rid/docs/doc_rid/attachments/

mediaStream: Stream

Stream附件媒体的。

options: MediaOptions

MediaOptions请求的。

requestOptions: RequestOptions

请求选项。

cancellationToken: CancellationToken

(可选) A CancellationToken ，可供其他对象或线程用来接收取消通知。

Task<ResourceResponse<Attachment>>

表示异步操作的服务响应的任务对象。

例外

ArgumentNullException

attachmentsLink如果未设置或 mediaStream 。

示例

//This attachment could be any binary you want to attach. Like images, videos, word documents, pdfs etc. it doesn't matter
using (FileStream fileStream = new FileStream(@".\something.pdf", FileMode.Open))
{
    //Create the attachment
    Attachment attachment = await client.CreateAttachmentAsync("dbs/db_rid/colls/coll_rid/docs/doc_rid/attachments/",
                                        fileStream,
                                        new MediaOptions
                                        {
                                            ContentType = "application/pdf",
                                            Slug = "something.pdf"
                                        });
}

另请参阅

适用于

CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)

在 Azure Cosmos DB 服务中将附件创建为异步操作。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> CreateAttachmentAsync (Uri documentUri, System.IO.Stream mediaStream, Microsoft.Azure.Documents.Client.MediaOptions options = default, Microsoft.Azure.Documents.Client.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAttachmentAsync : Uri * System.IO.Stream * Microsoft.Azure.Documents.Client.MediaOptions * Microsoft.Azure.Documents.Client.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>>

Public Function CreateAttachmentAsync (documentUri As Uri, mediaStream As Stream, Optional options As MediaOptions = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse(Of Attachment))

参数

documentUri: Uri

要为其创建附件的文档的 URI。

mediaStream: Stream

附件媒体的流。

options: MediaOptions

请求的媒体选项。

requestOptions: RequestOptions

请求的请求选项。

cancellationToken: CancellationToken

(可选) A CancellationToken ，可供其他对象或线程用来接收取消通知。

Task<ResourceResponse<Attachment>>

表示异步操作的服务响应的任务对象。

适用于

Share via

IDocumentClient.CreateAttachmentAsync 方法

定义

重载

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)

参数

返回

示例

另请参阅

适用于

CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

参数

返回

适用于

CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)

参数

返回

例外

示例

另请参阅

适用于

CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)

参数

返回

适用于

反馈

其他资源