IDocumentClient.UpsertAttachmentAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken) |
Upsert eine Anlage als asychroner Vorgang im Azure Cosmos DB-Dienst. |
UpsertAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken) |
Upsert eine Anlage als asynchronen Vorgang im Azure Cosmos DB-Dienst. |
UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken) |
Upsert eine Anlage als asychroner Vorgang im Azure Cosmos DB-Dienst. |
UpsertAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken) |
Upsert an Attachment mit dem Inhalt des als asynchronen Vorgang im Azure Cosmos DB-Dienst bereitgestellten |
UpsertAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)
Upsert eine Anlage als asychroner Vorgang im Azure Cosmos DB-Dienst.
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))
Parameter
- documentUri
- Uri
Der URI des Dokuments, für das eine Anlage hochsert werden soll.
- attachment
- Object
Das Attachment-Objekt.
- options
- RequestOptions
(Optional) Der RequestOptions für die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Eine CancellationToken , die von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
UpsertAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)
Upsert eine Anlage als asynchronen Vorgang im Azure Cosmos DB-Dienst.
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))
Parameter
- documentUri
- Uri
Der URI des Dokuments, für das eine Anlage hochsert werden soll.
- mediaStream
- Stream
Der Stream der Anlagemedien.
- options
- MediaOptions
Das MediaOptions-Objekt für die Anforderung.
- requestOptions
- RequestOptions
Das RequestOptions-Objekt für die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Eine CancellationToken , die von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
UpsertAttachmentAsync(String, Object, RequestOptions, CancellationToken)
Upsert eine Anlage als asychroner Vorgang im Azure Cosmos DB-Dienst.
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))
Parameter
- documentLink
- String
Der Link des übergeordneten Dokuments für diese neue Anlage. Beispiel: dbs/db_rid/colls/col_rid/docs/doc_rid/
- attachment
- Object
Das Anlageobjekt.
- options
- RequestOptions
(Optional) Die Anforderungsoptionen für die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Eine CancellationToken , die von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Task Objekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Beispiele
Im folgenden Beispiel wird ein neues Dokument erstellt und dann eine neue Anlage für dieses Dokument erstellt.
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" });
Weitere Informationen
Gilt für:
UpsertAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)
Upsert an Attachment mit dem Inhalt des als asynchronen Vorgang im Azure Cosmos DB-Dienst bereitgestellten mediaStream
.
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))
Parameter
- attachmentsLink
- String
Der Anhangslink für das Dokument. Beispiel: dbs/db_rid/colls/col_rid/docs/doc_rid/attachments/
- options
- MediaOptions
für MediaOptions die Anforderung.
- requestOptions
- RequestOptions
für RequestOptions die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Eine CancellationToken , die von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Ausnahmen
Wenn entweder attachmentsLink
oder mediaStream
nicht festgelegt ist.
Beispiele
//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"
});
}
Weitere Informationen
Gilt für:
Azure SDK for .NET