IDocumentClient.CreateAttachmentAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Documents

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

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)	Crea datos adjuntos como una operación asincrónica en el servicio Azure Cosmos DB.
CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)	Crea datos adjuntos como una operación asincrónica en el servicio Azure Cosmos DB.
CreateAttachmentAsync(String, Stream, MediaOptions, RequestOptions, CancellationToken)	Crea un Attachment objeto con el contenido de proporcionado `mediaStream` como una operación asincrónica en el servicio Azure Cosmos DB.
CreateAttachmentAsync(Uri, Stream, MediaOptions, RequestOptions, CancellationToken)	Crea datos adjuntos como una operación asincrónica en el servicio Azure Cosmos DB.

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)

Crea datos adjuntos como una operación asincrónica en el servicio 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))

Parámetros

documentLink: String

Vínculo del documento primario para estos nuevos datos adjuntos. Por ejemplo, dbs/db_rid/colls/col_rid/docs/doc_rid/

attachment: Object

Objeto de datos adjuntos.

options: RequestOptions

(Opcional) Las opciones de solicitud de la solicitud.

cancellationToken: CancellationToken

(Opcional) que CancellationToken pueden ser utilizados por otros objetos o subprocesos para recibir aviso de cancelación.

Devoluciones

Task<ResourceResponse<Attachment>>

Objeto Task que representa la respuesta del servicio para la operación asincrónica.

Ejemplos

En el ejemplo siguiente se crea un nuevo documento y, a continuación, se crea un nuevo archivo adjunto para ese documento.

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.

Consulte también

Se aplica a

CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

Crea datos adjuntos como una operación asincrónica en el servicio 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))

Parámetros

documentUri: Uri

URI del documento para el que se va a crear un archivo adjunto.

attachment: Object

Objeto de datos adjuntos.

options: RequestOptions

(Opcional) para RequestOptions la solicitud.

cancellationToken: CancellationToken

(Opcional) que CancellationToken pueden ser utilizados por otros objetos o subprocesos para recibir aviso de cancelación.

Devoluciones

Task<ResourceResponse<Attachment>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Se aplica a

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

Crea un Attachment objeto con el contenido de proporcionado mediaStream como una operación asincrónica en el servicio Azure Cosmos DB.

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

Parámetros

attachmentsLink: String

Vínculo de datos adjuntos del documento. Por ejemplo, dbs/db_rid/colls/col_rid/docs/doc_rid/attachments/

mediaStream: Stream

del Stream medio de datos adjuntos.

options: MediaOptions

para MediaOptions la solicitud.

requestOptions: RequestOptions

Opciones de solicitud.

cancellationToken: CancellationToken

(Opcional) que CancellationToken pueden ser utilizados por otros objetos o subprocesos para recibir aviso de cancelación.

Devoluciones

Task<ResourceResponse<Attachment>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Excepciones

ArgumentNullException

Si se establece o attachmentsLinkmediaStream no.

Ejemplos

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

Consulte también

Se aplica a

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

Crea datos adjuntos como una operación asincrónica en el servicio 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))

Parámetros

documentUri: Uri

URI del documento para el que se va a crear un archivo adjunto.

mediaStream: Stream

Secuencia del medio de datos adjuntos.

options: MediaOptions

Las opciones multimedia de la solicitud.

requestOptions: RequestOptions

Las opciones de solicitud de la solicitud.

cancellationToken: CancellationToken

(Opcional) que CancellationToken pueden ser utilizados por otros objetos o subprocesos para recibir aviso de cancelación.

Devoluciones

Task<ResourceResponse<Attachment>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Se aplica a

IDocumentClient.CreateAttachmentAsync Método

Definición

Sobrecargas

CreateAttachmentAsync(String, Object, RequestOptions, CancellationToken)

Parámetros

Devoluciones

Ejemplos

Consulte también

Se aplica a

CreateAttachmentAsync(Uri, Object, RequestOptions, CancellationToken)

Parámetros

Devoluciones

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Ejemplos

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Se aplica a

Comentarios

Recursos adicionales