Class Attribute

מאפיין

ייצוג של מאפיין XML.

// Reads the first and last name of each person and adds a new attribute with the full name.
var xml = '<roster>'
    + '<person first="John" last="Doe"/>'
    + '<person first="Mary" last="Smith"/>'
    + '</roster>';
var document = XmlService.parse(xml);
var people = document.getRootElement().getChildren('person');
for (var i = 0; i < people.length; i++) {
  var person = people[i];
  var firstName = person.getAttribute('first').getValue();
  var lastName = person.getAttribute('last').getValue();
  person.setAttribute('full', firstName + ' ' + lastName);
}
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
getName()	String	הפונקציה מקבלת את השם המקומי של המאפיין.
getNamespace()	Namespace	הפונקציה מקבלת את מרחב השמות של המאפיין.
getValue()	String	הפונקציה מקבלת את ערך המאפיין.
setName(name)	Attribute	מגדיר את השם המקומי של המאפיין.
setNamespace(namespace)	Attribute	מגדיר את מרחב השמות של המאפיין.
setValue(value)	Attribute	מגדיר את ערך המאפיין.

תיעוד מפורט

getName()

הפונקציה מקבלת את השם המקומי של המאפיין. אם למאפיין יש קידומת של מרחב שמות, צריך להשתמש ב-getNamespace().getPrefix() כדי לקבל את הקידומת.

החזרות

String - השם המקומי של המאפיין

---

getNamespace()

הפונקציה מקבלת את מרחב השמות של המאפיין.

החזרות

Namespace - מרחב השמות של המאפיין

---

getValue()

הפונקציה מקבלת את ערך המאפיין.

החזרות

String - ערך המאפיין

---

setName(name)

מגדיר את השם המקומי של המאפיין. כדי להגדיר קידומת של מרחב שמות למאפיין, צריך להשתמש ב-setNamespace(namespace) בשילוב עם XmlService.getNamespace(prefix, uri).

פרמטרים

שם	תיאור	התיאור
name	String	השם המקומי להגדרה

החזרות

Attribute – המאפיין לשרשור

---

setNamespace(namespace)

מגדיר את מרחב השמות של המאפיין. מרחב השמות חייב לכלול תחילית.

פרמטרים

שם	תיאור	התיאור
namespace	Namespace	מרחב השמות שצריך להגדיר

החזרות

Attribute – המאפיין לשרשור

---

setValue(value)

מגדיר את ערך המאפיין.

פרמטרים

שם	תיאור	התיאור
value	String	הערך שצריך להגדיר

החזרות

Attribute – המאפיין לשרשור