Class ScriptProperties

خصائص النص البرمجي

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الفئة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

سمات النصوص البرمجية هي أزواج مفتاح/قيمة يخزّنها نص برمجي في مساحة تخزين دائمة. يتم تحديد نطاق "خصائص النصوص البرمجية" لكل نص برمجي، بغض النظر عن المستخدم الذي يشغّل النص البرمجي.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
deleteAllProperties()	ScriptProperties	يؤدي هذا الإجراء إلى حذف جميع المواقع.
deleteProperty(key)	ScriptProperties	تؤدي هذه الدالة إلى حذف السمة باستخدام المفتاح المحدّد.
getKeys()	String[]	الحصول على جميع المفاتيح المتاحة
getProperties()	Object	الحصول على جميع المواقع المتاحة دفعةً واحدة
getProperty(key)	String	تعرِض هذه الدالة القيمة المرتبطة بالمفتاح المقدَّم، أو القيمة الخالية إذا لم تكن هناك قيمة.
setProperties(properties)	ScriptProperties	تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد
setProperties(properties, deleteAllOthers)	ScriptProperties	تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد
setProperty(key, value)	ScriptProperties	تحافظ على القيمة المحدّدة في باستخدام المفتاح المقدَّم.

الطرق المتوقّفة

deleteAllProperties()

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يؤدي هذا الإجراء إلى حذف جميع المواقع.

ScriptProperties.deleteAllProperties();

الإرجاع

ScriptProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

• deleteProperty(key)

---

deleteProperty(key)

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تؤدي هذه الدالة إلى حذف السمة باستخدام المفتاح المحدّد.

ScriptProperties.deleteProperty('special');

المعلمات

الاسم	النوع	الوصف
key	String	مفتاح الموقع المطلوب حذفه

الإرجاع

ScriptProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

• deleteAllProperties()

---

getKeys()

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

الحصول على جميع المفاتيح المتاحة

الإرجاع

String[]

---

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)

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

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

const specialValue = ScriptProperties.getProperty('special');

المعلمات

الاسم	النوع	الوصف
key	String	مفتاح القيمة المطلوب استرجاعها

الإرجاع

String: القيمة المرتبطة بالمفتاح

انظر أيضًا

• setProperty(key, value)

---

setProperties(properties)

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد

ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});

المعلمات

الاسم	النوع	الوصف
properties	Object	عنصر يحتوي على السمات المطلوب ضبطها

الإرجاع

ScriptProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد

// This deletes all other properties
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

المعلمات

الاسم	النوع	الوصف
properties	Object	عنصر يحتوي على السمات المطلوب ضبطها
deleteAllOthers	Boolean	ما إذا كنت تريد حذف جميع المواقع الحالية

الإرجاع

ScriptProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

• setProperty(key, value)

---

setProperty(key, value)

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تحافظ على القيمة المحدّدة في باستخدام المفتاح المقدَّم. سيتم استبدال أي قيمة حالية مرتبطة بهذه المفتاح.

ScriptProperties.setProperty('special', 'sauce');

المعلمات

الاسم	النوع	الوصف
key	String	مفتاح الموقع
value	String	القيمة المطلوب ربطها بالمفتاح

الإرجاع

ScriptProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

• getProperty(key)