استخدام قيمة إرجاع Azure Function

توضح هذه المقالة كيفية عمل قيم الإرجاع داخل دالة. في اللغات التي تحتوي على قيمة إرجاع، يمكنك ربط ربط إخراج دالة بقيمة الإرجاع.

عينname الخاصية في function.json إلى$return. إذا كان هناك عدة روابط إخراج، فاستخدم قيمة الإرجاع لواحد منها فقط.

تعتمد كيفية استخدام القيم المرجعة على وضع C# الذي تستخدمه في تطبيق الوظائف:

نموذج عامل معزول

راجع روابط الإخراج في دليل عامل .NET للحصول على التفاصيل والأمثلة.

نموذج قيد المعالجة

هام

سينتهي الدعم للنموذج قيد التنفيذ في 10 نوفمبر 2026. نوصي بشدة بترحيل تطبيقاتك إلى نموذج العامل المعزول للحصول على الدعم الكامل.

في مكتبة فئة C#، قم بتطبيق سمة رابط الإخراج على قيمة إرجاع الأسلوب. في C# و برنامج C# النصي، تتمثل الطرق البديلة لإرسال البيانات إلى رابط إخراج في out المعلمات وكائنات المجمع.

إليك تعليمة C# البرمجية التي تستخدم قيمة الإرجاع لرابط الإخراج، متبوعة بمثال غير متزامن:

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

إليك رابط الإخراج في ملف function.json:

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

ها هي كود JavaScript:

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

إليك رابط الإخراج في ملف function.json:

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

إليك التعليمة البرمجية PowerShell التي تستخدم قيمة الإرجاع لرابط إخراج http:

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

إليك رابط الإخراج في ملف function.json:

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

إليك التعليمة البرمجية لـ Python:

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

تطبيق التعليق التوضيحي لربط الإخراج على أسلوب الدالة. إذا كان هناك عدة روابط إخراج، فاستخدم قيمة الإرجاع لواحد منها فقط.

إليك التعليمة البرمجية Java التي تستخدم قيمة الإرجاع لرابط الإخراج:

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

الخطوات التالية

معالجة أخطاء ربط دوال Azure