Class UserProperties

UserProperties

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

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

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

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

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

deleteAllProperties()

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

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

UserProperties.deleteAllProperties();

الإرجاع

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

انظر أيضًا

• deleteProperty(key)

---

deleteProperty(key)

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

تحذف هذه الطريقة السمة التي لها المفتاح المحدّد.

UserProperties.deleteProperty('special');

المَعلمات

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

الإرجاع

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

انظر أيضًا

• deleteAllProperties()

---

getKeys()

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

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

الإرجاع

String[]

---

getProperties()

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

الحصول على جميع السمات المتاحة في الوقت نفسه

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

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

---

getProperty(key)

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

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

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

المَعلمات

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

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

---

setProperties(properties)

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

تضبط هذه الطريقة بشكل مجمّع جميع السمات المستخلَصة من العنصر المحدّد.

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

المَعلمات

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

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

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

تضبط هذه الطريقة بشكل مجمّع جميع السمات المستخلَصة من العنصر المحدّد.

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

المَعلمات

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

الإرجاع

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

انظر أيضًا

• setProperty(key, value)

---

setProperty(key, value)

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

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

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

المَعلمات

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

الإرجاع

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

انظر أيضًا

• getProperty(key)