تمت إزالة هذا العمود. تم إيقاف هذا الفئة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
خصائص النص البرمجي هي أزواج المفتاح/القيمة مخزنة بواسطة نص برمجي في مخزن دائم. يتم تحديد خصائص النص البرمجي لكل نص برمجي، بغض النظر عن المستخدم الذي يشغّل النص البرمجي.
الطرق المتوقّفة نهائيًا
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
|
| يؤدي إلى حذف جميع المواقع. |
|
| يؤدي هذا الإجراء إلى حذف الخاصية التي تحتوي على المفتاح المحدّد. |
| String[] | احصل على جميع المفاتيح المتاحة. |
| Object | يمكنك الحصول على جميع المواقع المتاحة دفعة واحدة. |
| String | لعرض القيمة المرتبطة بالمفتاح المتوفر، أو يتم عرض قيمة فارغة إذا لم تكن هناك قيمة من هذا القبيل. |
|
| يضبط بشكل مجمّع جميع الخصائص المأخوذة من العنصر المحدد. |
|
| يضبط بشكل مجمّع جميع الخصائص المأخوذة من العنصر المحدد. |
|
| الاحتفاظ بالقيمة المحددة في القيمة مع المفتاح المتوفر. |
الطرق المتوقّفة نهائيًا
deleteAllProperties()
deleteAllProperties()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يؤدي إلى حذف جميع المواقع.
ScriptProperties.deleteAllProperties();
استرجاع الكرة
: هذا الكائن للسلاسلScriptProperties
يمكن أيضًا مراجعة
deleteProperty(key)
deleteProperty(key)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يؤدي هذا الإجراء إلى حذف الخاصية التي تحتوي على المفتاح المحدّد.
ScriptProperties.deleteProperty('special');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
key | String | مفتاح للخاصية لحذفها |
استرجاع الكرة
: هذا الكائن للسلاسلScriptProperties
يمكن أيضًا مراجعة
getKeys()
getKeys()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
احصل على جميع المفاتيح المتاحة.
استرجاع الكرة
String[]
getProperties()
getProperties()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يمكنك الحصول على جميع المواقع المتاحة دفعة واحدة.
يقدم هذا نسخة، وليس عرضًا مباشرًا، لذا فإن تغيير الخصائص في الكائن المعروض لن يؤدي إلى تحديثها في مساحة التخزين والعكس صحيح.
ScriptProperties.setProperties({ "cow" : "moo", "sheep" : "baa", "chicken" : "cluck" }); // Logs "A cow goes: moo" Logger.log("A cow goes: %s", ScriptProperties.getProperty("cow")); // This makes a copy. Any changes that happen here will not // be written back to properties. var animalSounds = ScriptProperties.getProperties(); // Logs: // A chicken goes cluck! // A cow goes moo! // A sheep goes baa! for(var kind in animalSounds) { Logger.log("A %s goes %s!", kind, animalSounds[kind]); }
استرجاع الكرة
Object
: نسخة من الخصائص التي تحتوي على أزواج المفتاح/القيمة
getProperty(key)
getProperty(key)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
لعرض القيمة المرتبطة بالمفتاح المتوفر، أو يتم عرض قيمة فارغة إذا لم تكن هناك قيمة من هذا القبيل.
var specialValue = ScriptProperties.getProperty('special');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
key | String | مفتاح للقيمة لاستردادها |
استرجاع الكرة
String
- القيمة المرتبطة بالمفتاح
يمكن أيضًا مراجعة
setProperties(properties)
setProperties(properties)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يضبط بشكل مجمّع جميع الخصائص المأخوذة من العنصر المحدد.
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});
المَعلمات
الاسم | Type | الوصف |
---|---|---|
properties | Object | كائن يحتوي على الخصائص المراد تعيينها. |
استرجاع الكرة
: هذا الكائن للسلاسلScriptProperties
يمكن أيضًا مراجعة
setProperties(properties, deleteAllOthers)
setProperties(properties, deleteAllOthers)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يضبط بشكل مجمّع جميع الخصائص المأخوذة من العنصر المحدد.
// This deletes all other properties ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
properties | Object | كائن يحتوي على الخصائص المراد تعيينها. |
deleteAllOthers | Boolean | ما إذا كان سيتم حذف جميع المواقع الحالية أم لا. |
استرجاع الكرة
: هذا الكائن للسلاسلScriptProperties
يمكن أيضًا مراجعة
setProperty(key, value)
setProperty(key, value)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
الاحتفاظ بالقيمة المحددة في القيمة مع المفتاح المتوفر. سيتم استبدال أي قيمة حالية مرتبطة بهذا المفتاح.
ScriptProperties.setProperty('special', 'sauce');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
key | String | مفتاح خاصية |
value | String | قيمة لربطها بالمفتاح |
استرجاع الكرة
: هذا الكائن للسلاسلScriptProperties