وظيفة JSONVALUE ER

تُحلل وظيفة JSONVALUE البيانات في تنسيق JavaScript Object Notation (JSON) الذي يتم الوصول إليه في المسار المُحدد، ويستخرج قيمة عددية تعتمد على المعرف المحدد.‬ ثم يقوم بإرجاع القيمة العددية المستخرجة كقيمة سلسلة .

بناء الجملة

JSONVALUE (input, path)

الوسائط

input: سلسلة

المسار الصالح لمصدر البيانات من نوع السلسلة الذي يحتوي على بيانات JSON.

path: سلسلة

معرف نوع القيمة العددية لبيانات JSON. استخدم الشرطة المائلة للامام (/) لفصل أسماء عقد JSON المرتبطة. استخدم تعليق القوس ([]) لتحديد فهرس قيمه معينه في صفيف JSON. لاحظ انه يتم استخدام الترقيم المستند إلى الصفر لهذا الفهرس.

إرجاع القيم

سلسلة

القيمة النصية الناتجة.

مثال1

يحتوي مصدر البيانات JsonField على البيانات التالية بتنسيق: {"BuildNumber":"7.3.1234.1", "KeyThumbprint":"7366E"}. في هذه الحالة، يقوم التعبير JSONVALUE (JsonField, "BuildNumber") بإرجاع القيمة التالية من نوع البيانات سلسلة : "7.3.1234.1".

مثال2

يُمكنك إدخال مصدر بيانات JsonField من النوع الحقل المحسوب ، الذي يحتوي على التعبير "{""workers"": [ {""name"": ""Adam"", ""age"": 30, ""emails"": [""AdamS@Contoso.com"", ""AdamS@Hotmail.com"" ]}, { ""name"": ""John"", ""age"": 21, ""emails"": [""JohnS@Contoso.com"", ""JohnS@Aol.com""]}]}".

تم تكوين هذا التعبير لإرجاع قيمه سلسله تمثل البيانات التالية في تنسيق JSON.

{
    "workers": [
        {
            "name": "Adam",
            "age": 30,
            "emails": [ "AdamS@Contoso.com", "AdamS@Hotmail.com" ]
        },
        {
            "name": "John",
            "age": 21,
            "emails": [ "JohnS@Contoso.com", "JohnS@Aol.com" ]
        }
    ]
}

في هذه الحالة، يقوم التعبير JSONVALUE(json, "workers/[1]/emails/[0]") بإرجاع القيمة التالية من نوع البيانات سلسلة: JohnS@Contoso.com.

الموارد الإضافية

الدالات النصية