Verwenden des Rückgabewerts einer Azure-Funktion

In diesem Artikel wird erläutert, wie Rückgabewerte innerhalb einer Funktion funktionieren. In Sprachen mit einem Rückgabewert können Sie eine Ausgabebindung einer Funktion an den Rückgabewert binden.

Legen Sie die Eigenschaft name in function.json auf $return fest. Wenn mehrere Ausgabebindungen vorhanden sind, verwenden Sie den Rückgabewert für nur eine davon.

Wie Rückgabewerte verwendet werden, hängt vom C#-Modus ab, den Sie in Ihrer Funktions-App verwenden:

Isoliertes Workermodell

Ausführliche Informationen und Beispiele finden Sie unter Ausgabebindungen im .NET-Workerleitfaden.

In-Process-Modell

Wichtig

Die Unterstützung für das In-Process-Modell endet am 10. November 2026. Es wird dringend empfohlen, Ihre Apps zum isolierten Workermodell zu migrieren, um den vollständigen Support zu ermöglichen.

Wenden Sie in einer C#-Klassenbibliothek das Attribut der Ausgabebindung auf den Rückgabewert der Methode an. In C# und C#-Skripts können Daten alternativ mithilfe von out-Parametern und Collector-Objekten an eine Ausgabebindung gesendet werden.

Hier sehen Sie C#-Code, der den Rückgabewert für eine Ausgabebindung gefolgt von einem asynchronen Beispiel verwendet:

[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);
}

Hier sehen Sie die Bindungsdaten in der Datei function.json:

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

Der JavaScript-Code sieht wie folgt aus:

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

Hier sehen Sie die Bindungsdaten in der Datei function.json:

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

Hier sehen Sie den PowerShell-Code, der den Rückgabewert für eine HTTP-Ausgabebindung verwendet:

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

Hier sehen Sie die Bindungsdaten in der Datei function.json:

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

Dies ist der Python-Code:

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

Wenden Sie die Anmerkung der Ausgabebindung auf die Funktionsmethode an. Wenn mehrere Ausgabebindungen vorhanden sind, verwenden Sie den Rückgabewert für nur eine davon.

Hier sehen Sie Java-Code, der den Rückgabewert für eine Ausgabebindung verwendet:

@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;
}

Nächste Schritte

Fehlerbehandlung bei der Azure Functions-Bindung