Class ScriptProperties

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

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

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

الطُرق المتوقّفة نهائيًا

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
deleteAllProperties()	ScriptProperties	يحذف جميع المواقع.
deleteProperty(key)	ScriptProperties	تحذف هذه الطريقة السمة التي لها المفتاح المحدّد.
getKeys()	String[]	الحصول على جميع المفاتيح المتاحة
getProperties()	Object	الحصول على جميع السمات المتاحة في الوقت نفسه
getProperty(key)	String|null	تعرض هذه الدالة القيمة المرتبطة بالمفتاح المقدَّم، أو null إذا لم تكن هناك قيمة.
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)

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

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

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

المعلمات

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

الإرجاع

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

انظر أيضًا

• 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)