DocumentClient.CreateUserDefinedFunctionAsync Método

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

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

Pacotes:

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

Sobrecargas

CreateUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)	Cria uma função definida pelo usuário como uma operação assíncrona no serviço do Azure Cosmos DB.
CreateUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)	Cria uma função definida pelo usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

CreateUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Cria uma função definida pelo usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>> CreateUserDefinedFunctionAsync (string collectionLink, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateUserDefinedFunctionAsync : 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.CreateUserDefinedFunctionAsync : 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 CreateUserDefinedFunctionAsync (collectionLink As String, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parâmetros

collectionLink

String

O link do DocumentCollection no qual criar a função definida pelo usuário. Por exemplo, dbs/db_rid/colls/col_rid/

function

UserDefinedFunction

O UserDefinedFunction objeto a ser criado.

options

RequestOptions

(Opcional) Qualquer RequestOptionspara esta solicitação.

Retornos

Task<ResourceResponse<UserDefinedFunction>>

Um objeto de tarefa que representa a resposta do serviço para a operação assíncrona.

Implementações

CreateUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Exceções

ArgumentNullException

Se ou collectionLinkfunction não estiver definido.

AggregateException

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure dentro de InnerExceptions para encontrar as exceções reais

DocumentClientException

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode. Alguns códigos comuns que você pode obter ao criar um Documento são:

StatusCode	Motivo da exceção
400	BadRequest - Isso significa que algo estava errado com a solicitação fornecida. É provável que uma ID não tenha sido fornecida para a nova função definida pelo usuário ou que o Corpo tenha sido malformado.
403	Proibido – você atingiu sua cota de funções definidas pelo usuário para a coleção fornecida. Entre em contato com o suporte para aumentar essa cota.
409	Conflito – isso significa que um com uma UserDefinedFunction ID correspondente à ID que você forneceu já existia.
413	RequestEntityTooLarge - Isso significa que o corpo do UserDefinedFunction que você tentou criar era muito grande.

Exemplos

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

Confira também

• ResourceResponse<TResource>
• Task
• UserDefinedFunction
• RequestOptions

CreateUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)

Cria uma função definida pelo usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>> CreateUserDefinedFunctionAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateUserDefinedFunctionAsync : 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.CreateUserDefinedFunctionAsync : 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 CreateUserDefinedFunctionAsync (documentCollectionUri As Uri, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parâmetros

documentCollectionUri

Uri

o URI da coleção de documentos no qual criar a função definida pelo usuário.

function

UserDefinedFunction

o objeto Microsoft.Azure.Documents.UserDefinedFunction.

options

RequestOptions

As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<UserDefinedFunction>>

O objeto de tarefa que representa a resposta do serviço para a operação assíncrona.

Implementações

CreateUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)