IDocumentClient.CreateAttachmentAsync 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
| CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken) |
Erstellt eine Anlage als asychronen Vorgang im Azure Cosmos DB-Dienst. |
| CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken) |
Erstellt eine Anlage als asychronen Vorgang im Azure Cosmos DB-Dienst. |
| CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken) |
Erstellt eine Attachment mit dem Inhalt des als asynchronen Vorgang im Azure Cosmos DB-Dienst bereitgestellten |
| CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken) |
Erstellt eine Anlage als asynchronen Vorgang im Azure Cosmos DB-Dienst. |
CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)
Erstellt eine Anlage als asychronen Vorgang im Azure Cosmos DB-Dienst.
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))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) Ein CancellationToken , der von anderen Objekten oder Threads verwendet werden kann, um eine Benachrichtigung über den Abbruch 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 und dann eine neue Anlage für dieses Dokument erstellt.
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.
Weitere Informationen
Gilt für:
CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)
Erstellt eine Anlage als asychronen Vorgang im Azure Cosmos DB-Dienst.
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))Parameter
- documentUri
- Uri
Der URI des Dokuments, für das eine Anlage erstellt werden soll.
- attachment
- Object
Das Anlageobjekt.
- options
- RequestOptions
(Optional) Die RequestOptions für die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Ein CancellationToken , der von anderen Objekten oder Threads verwendet werden kann, um eine Benachrichtigung über den Abbruch zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)
Erstellt eine 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>> 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))Parameter
- attachmentsLink
- String
Der Anlagenlink für das Dokument. Beispiel: dbs/db_rid/colls/col_rid/docs/doc_rid/attachments/
- options
- MediaOptions
die MediaOptions für die Anforderung.
- requestOptions
- RequestOptions
Anforderungsoptionen.
- cancellationToken
- CancellationToken
(Optional) Ein CancellationToken , der von anderen Objekten oder Threads verwendet werden kann, um eine Benachrichtigung über den Abbruch zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Ausnahmen
Wenn oder attachmentsLinkmediaStream 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))
{
//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"
});
}
Weitere Informationen
Gilt für:
CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)
Erstellt eine Anlage als asynchronen Vorgang im Azure Cosmos DB-Dienst.
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))Parameter
- documentUri
- Uri
Der URI des Dokuments, für das eine Anlage erstellt werden soll.
- mediaStream
- Stream
Der Stream des Anlagemediums.
- options
- MediaOptions
Die Medienoptionen für die Anforderung.
- requestOptions
- RequestOptions
Die Anforderungsoptionen für die Anforderung.
- cancellationToken
- CancellationToken
(Optional) Ein CancellationToken , der von anderen Objekten oder Threads verwendet werden kann, um eine Benachrichtigung über den Abbruch zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
Azure SDK for .NET