DocumentClient.UpsertUserDefinedFunctionAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Documents.Client

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

Sobrecargas

UpsertUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)	Upserts una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.
UpsertUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)	Upserts una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.

UpsertUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)

Upserts una función definida por el usuario 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.UserDefinedFunction>> UpsertUserDefinedFunctionAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertUserDefinedFunctionAsync : Uri * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>
override this.UpsertUserDefinedFunctionAsync : Uri * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>

Public Function UpsertUserDefinedFunctionAsync (documentCollectionUri As Uri, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parámetros

documentCollectionUri

Uri

el URI de la colección de documentos en el que se va a actualizar la función definida por el usuario.

function

UserDefinedFunction

El objeto Microsoft.Azure.Documents.UserDefinedFunction.

options

RequestOptions

Opciones de solicitud para la solicitud.

Devoluciones

Task<ResourceResponse<UserDefinedFunction>>

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

Implementaciones

UpsertUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)

UpsertUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Upserts una función definida por el usuario 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.UserDefinedFunction>> UpsertUserDefinedFunctionAsync (string collectionLink, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertUserDefinedFunctionAsync : string * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>
override this.UpsertUserDefinedFunctionAsync : string * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>

Public Function UpsertUserDefinedFunctionAsync (collectionLink As String, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parámetros

collectionLink

String

Vínculo de para DocumentCollection upsert en la función definida por el usuario. Por ejemplo, dbs/db_rid/colls/col_rid/

function

UserDefinedFunction

Objeto UserDefinedFunction que se va a upsert.

options

RequestOptions

(Opcional) Cualquiera RequestOptionspara esta solicitud.

Devoluciones

Task<ResourceResponse<UserDefinedFunction>>

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

Implementaciones

UpsertUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Excepciones

ArgumentNullException

Si se establece o collectionLinkfunction no.

AggregateException

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

DocumentClientException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCode	Motivo de la excepción
400	BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para la nueva función definida por el usuario o que el cuerpo tenga un formato incorrecto.
403	Prohibido: ha alcanzado la cuota de funciones definidas por el usuario para la colección proporcionada. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409	Conflicto: significa que UserDefinedFunction un con un identificador que coincide con el identificador que proporcionó ya existía.
413	RequestEntityTooLarge: esto significa que el cuerpo del UserDefinedFunction objeto que intentó upsert era demasiado grande.

Ejemplos

//Upsert a user defined function that converts a string to upper case
UserDefinedFunction udf = client.UpsertUserDefinedFunctionAsync(collectionLink, new UserDefinedFunction
{
   Id = "ToUpper",
   Body = @"function toUpper(input) {
                       return input.toUpperCase();
                    }",
});

Consulte también

• ResourceResponse<TResource>
• Task
• UserDefinedFunction
• RequestOptions