Uso del valore restituito della funzione di Azure

Questo articolo illustra come funzionano i valori restituiti all'interno di una funzione. Nei linguaggi con un valore restituito, è possibile associare un'associazione di output della funzione al valore restituito.

impostare la proprietà name in function.json su $return. Se sono presenti più associazioni di output, usare il valore restituito per una sola di tali associazioni.

La modalità di utilizzo dei valori restituiti dipende dalla modalità C# usata nell'app per le funzioni:

Modello di lavoro isolato

Per informazioni dettagliate ed esempi, vedere Binding di output nella guida del ruolo di lavoro .NET.

Modello in-process

Importante

Il supporto terminerà per il modello in-process il 10 novembre 2026. È consigliabile eseguire la migrazione delle app al modello di lavoro isolato per il supporto completo.

In una libreria di classi C# applicare l'attributo dell'associazione di output al valore restituito del metodo. Negli script C# e C# è in alternativa possibile inviare dati alle associazioni di output dati tramite i parametri out e gli oggetti dell'agente di raccolta.

Di seguito è riportato il codice C# che usa il valore restituito per un'associazione di output, seguito da un esempio asincrono:

[FunctionName("QueueTrigger")]
[return: Blob("output-container/{id}")]
public static string Run([QueueTrigger("inputqueue")]WorkItem input, ILogger log)
{
    string json = string.Format("{{ \"id\": \"{0}\" }}", input.Id);
    log.LogInformation($"C# script processed queue message. Item={json}");
    return json;
}

[FunctionName("QueueTrigger")]
[return: Blob("output-container/{id}")]
public static Task<string> Run([QueueTrigger("inputqueue")]WorkItem input, ILogger log)
{
    string json = string.Format("{{ \"id\": \"{0}\" }}", input.Id);
    log.LogInformation($"C# script processed queue message. Item={json}");
    return Task.FromResult(json);
}

Di seguito è riportata l'associazione di output nel file function.json:

{
    "name": "$return",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{id}"
}

Ecco il codice JavaScript:

module.exports = function (context, input) {
    var json = JSON.stringify(input);
    context.log('Node.js script processed queue message', json);
    return json;
}

Di seguito è riportata l'associazione di output nel file function.json:

{
    "name": "Response",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{blobname}"
}

Ecco il codice di PowerShell che usa il valore restituito per un'associazione di output HTTP:

Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $blobname
    })

Di seguito è riportata l'associazione di output nel file function.json:

{
    "name": "$return",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{id}"
}

Ecco il codice Python:

def main(input: azure.functions.InputStream) -> str:
    return json.dumps({
        'name': input.name,
        'length': input.length,
        'content': input.read().decode('utf-8')
    })

Applicare l'annotazione dell'associazione di output al metodo della funzione. Se sono presenti più associazioni di output, usare il valore restituito per una sola di tali associazioni.

Ecco il codice Java che usa il valore restituito per un'associazione di output:

@FunctionName("QueueTrigger")
@StorageAccount("AzureWebJobsStorage")
@BlobOutput(name = "output", path = "output-container/{id}")
public static String run(
  @QueueTrigger(name = "input", queueName = "inputqueue") WorkItem input,
  final ExecutionContext context
) {
  String json = String.format("{ \"id\": \"%s\" }", input.id);
  context.getLogger().info("Java processed queue message. Item=" + json);
  return json;
}

Passaggi successivi

Gestire gli errori di associazione Funzioni di Azure