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: نسخة من الخصائص التي تحتوي على أزواج المفاتيح والقيم

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

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