IDocumentClient.UpsertAttachmentAsync メソッド

リファレンス

定義

名前空間:: 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 は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)	Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。
UpsertAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)	Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。
UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)	Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。
UpsertAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)	Azure Cosmos DB サービスで非同期操作として提供される `mediaStream` の内容を使用してをアップサートAttachmentします。

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。

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

abstract member UpsertAttachmentAsync : 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 UpsertAttachmentAsync (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

Attachment オブジェクト。

options: RequestOptions

(省略可能) RequestOptions 要求の。

cancellationToken: CancellationToken

(省略可能) CancellationToken 取り消しの通知を受け取るために他のオブジェクトまたはスレッドが使用できる。

戻り値

Task<ResourceResponse<Attachment>>

非同期操作のサービス応答を表すタスクオブジェクト。

適用対象

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

Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> UpsertAttachmentAsync (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 UpsertAttachmentAsync : 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 UpsertAttachmentAsync (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

要求の MediaOptions。

requestOptions: RequestOptions

要求の RequestOptions。

cancellationToken: CancellationToken

(省略可能) CancellationToken 取り消しの通知を受け取るために他のオブジェクトまたはスレッドが使用できる。

戻り値

Task<ResourceResponse<Attachment>>

非同期操作のサービス応答を表すタスクオブジェクト。

適用対象

UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)

Azure Cosmos DB サービスの非同期操作として添付ファイルをアップサートします。

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

abstract member UpsertAttachmentAsync : 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 UpsertAttachmentAsync (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

(省略可能) CancellationToken 取り消しの通知を受け取るために他のオブジェクトまたはスレッドが使用できる。

戻り値

Task<ResourceResponse<Attachment>>

Task非同期操作のサービス応答を表すオブジェクト。

例

次の例では、新しいドキュメントを作成し、そのドキュメントの新しい添付ファイルをアップサートします

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

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

//Upsert 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.UpsertAttachmentAsync(doc.SelfLink, new Attachment { Id = "foo", ContentType = "text/plain", MediaLink = "link to your media" });

こちらもご覧ください

適用対象

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

Azure Cosmos DB サービスで非同期操作として提供される mediaStream の内容を使用してをアップサートAttachmentします。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Attachment>> UpsertAttachmentAsync (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 UpsertAttachmentAsync : 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 UpsertAttachmentAsync (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

要求 RequestOptions の。

cancellationToken: CancellationToken

(省略可能) CancellationToken 取り消しの通知を受け取るために他のオブジェクトまたはスレッドが使用できる。

戻り値

Task<ResourceResponse<Attachment>>

非同期操作のサービス応答を表すタスクオブジェクト。

例外

ArgumentNullException

または mediaStream がattachmentsLink設定されていない場合。

例

//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))
{
    //Upsert the attachment
    Attachment attachment = await client.UpsertAttachmentAsync("dbs/db_rid/colls/coll_rid/docs/doc_rid/attachments/",
                                        fileStream,
                                        new MediaOptions
                                        {
                                            ContentType = "application/pdf",
                                            Slug = "something.pdf"
                                        });
}

こちらもご覧ください

適用対象

IDocumentClient.UpsertAttachmentAsync メソッド

定義

オーバーロード

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

パラメーター

戻り値

適用対象

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

パラメーター

戻り値

適用対象

UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)

パラメーター

戻り値

例

こちらもご覧ください

適用対象

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

パラメーター

戻り値

例外

例

こちらもご覧ください

適用対象

フィードバック

その他のリソース