Class UserProperties

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

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

UserProperties.deleteAllProperties();

الإرجاع

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

انظر أيضًا

• deleteProperty(key)

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

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

UserProperties.deleteProperty('special');

المعلمات

الإرجاع

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

انظر أيضًا

• deleteAllProperties()

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

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

الإرجاع

String[]

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

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

يقدّم هذا الإجراء نسخة، وليس عرضًا مباشرًا، لذا لن يؤدي تغيير السمات في الكائن الذي تم إرجاعه إلى تعديلها في مساحة التخزين والعكس صحيح.

UserProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", UserProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = UserProperties.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 - نسخة من الخصائص التي تحتوي على أزواج مفاتيح وقيم

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• getProperty(key)