IDocumentClient.UpsertAttachmentAsync Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Documents

Assemblys:: Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)	Upserts une pièce jointe en tant qu’opération asychrone dans le service Azure Cosmos DB.
UpsertAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)	Upserts d’une pièce jointe en tant qu’opération asynchrone dans le service Azure Cosmos DB.
UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)	Upserts une pièce jointe en tant qu’opération asychrone dans le service Azure Cosmos DB.
UpsertAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)	Upserts un Attachment avec le contenu du fourni `mediaStream` en tant qu’opération asynchrone dans le service Azure Cosmos DB.

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

Upserts une pièce jointe en tant qu’opération asychrone dans le service 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))

Paramètres

documentUri: Uri

URI du document pour lequel effectuer l’upsert d’une pièce jointe.

attachment: Object

Objet Attachment.

options: RequestOptions

(Facultatif) RequestOptions pour la demande.

cancellationToken: CancellationToken

(Facultatif) CancellationToken qui peut être utilisé par d’autres objets ou threads pour recevoir un avis d’annulation.

Retours

Task<ResourceResponse<Attachment>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.

S’applique à

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

Upserts d’une pièce jointe en tant qu’opération asynchrone dans le service 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))

Paramètres

documentUri: Uri

URI du document pour lequel effectuer l’upsert d’une pièce jointe.

mediaStream: Stream

Flux du média de pièce jointe.

options: MediaOptions

MediaOptions de la requête.

requestOptions: RequestOptions

RequestOptions de la requête.

cancellationToken: CancellationToken

(Facultatif) CancellationToken qui peut être utilisé par d’autres objets ou threads pour recevoir un avis d’annulation.

Retours

Task<ResourceResponse<Attachment>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.

S’applique à

UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)

Upserts une pièce jointe en tant qu’opération asychrone dans le service 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))

Paramètres

documentLink: String

Lien du document parent pour cette nouvelle pièce jointe. Par exemple, dbs/db_rid/colls/col_rid/docs/doc_rid/

attachment: Object

Objet attachment.

options: RequestOptions

(Facultatif) Options de demande pour la demande.

cancellationToken: CancellationToken

(Facultatif) CancellationToken qui peut être utilisé par d’autres objets ou threads pour recevoir un avis d’annulation.

Retours

Task<ResourceResponse<Attachment>>

Objet Task représentant la réponse du service pour l’opération asynchrone.

Exemples

L’exemple ci-dessous crée un document, puis effectue l’upsert d’une nouvelle pièce jointe pour ce document

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" });

Voir aussi

S’applique à

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

Upserts un Attachment avec le contenu du fourni mediaStream en tant qu’opération asynchrone dans le service Azure Cosmos DB.

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))

Paramètres

attachmentsLink: String

Lien pièces jointes pour le document. Par exemple, dbs/db_rid/colls/col_rid/docs/doc_rid/attachments/

mediaStream: Stream

du Stream média de pièce jointe.

options: MediaOptions

pour MediaOptions la demande.

requestOptions: RequestOptions

pour RequestOptions la demande.

cancellationToken: CancellationToken

(Facultatif) CancellationToken qui peut être utilisé par d’autres objets ou threads pour recevoir un avis d’annulation.

Retours

Task<ResourceResponse<Attachment>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.

Exceptions

ArgumentNullException

Si ou attachmentsLinkmediaStream n’est pas défini.

Exemples

//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"
                                        });
}

Voir aussi

S’applique à

Partager via

IDocumentClient.UpsertAttachmentAsync Méthode

Définition

Surcharges

UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

Paramètres

Retours

S’applique à

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

Paramètres

Retours

S’applique à

UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)

Paramètres

Retours

Exemples

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Exemples

Voir aussi

S’applique à

Ressources supplémentaires