این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Element

نمایشی از یک گره Element XML.

// Adds up the values listed in a sample XML document and adds a new element
// with the total.
let xml = '<things>' +
    '<plates>12</plates>' +
    '<bowls>18</bowls>' +
    '<cups>25</cups>' +
    '</things>';
const document = XmlService.parse(xml);
const root = document.getRootElement();
const items = root.getChildren();
let total = 0;
for (let i = 0; i < items.length; i++) {
  total += Number(items[i].getText());
}
const totalElement = XmlService.createElement('total').setText(total);
root.addContent(totalElement);
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

روش ها

روش	نوع برگشت	شرح مختصر
`add Content(content)`	`Element`	گره داده شده را به عنوان آخرین فرزند گره `Element` اضافه می کند.
`add Content(index, content)`	`Element`	گره داده شده را در شاخص داده شده در بین تمام گره هایی که فرزندان مستقیم گره `Element` هستند درج می کند.
`clone Content()`	`Content[]`	کپی‌های پیوست‌نشده از همه گره‌هایی که فرزندان مستقیم گره {@code Element} هستند ایجاد می‌کند.
`detach()`	`Content`	گره را از گره `Element` والد خود جدا می کند.
`get All Content()`	`Content[]`	همه گره هایی را که فرزندان مستقیم گره {@code Element} هستند را دریافت می کند.
`get Attribute(name)`	`Attribute`	ویژگی این گره `Element` را با نام داده شده و بدون فضای نام دریافت می کند.
`get Attribute(name, namespace)`	`Attribute`	ویژگی این گره `Element` با نام و فضای نام داده شده دریافت می کند.
`get Attributes()`	`Attribute[]`	تمام ویژگی‌های این گره `Element` را به ترتیبی که در سند ظاهر می‌شوند، دریافت می‌کند.
`get Child(name)`	`Element`	اولین گره `Element` را با نام داده شده و بدون فضای نام که فرزند مستقیم این گره `Element` است، دریافت می کند.
`get Child(name, namespace)`	`Element`	اولین گره `Element` را با نام و فضای نام داده شده دریافت می کند که فرزند مستقیم این گره `Element` است.
`get Child Text(name)`	`String`	اگر گره فرزند مستقیم گره `Element` باشد، مقدار متن گره را با نام داده شده و بدون فضای نام دریافت می کند.
`get Child Text(name, namespace)`	`String`	مقدار متن گره را با نام و فضای نام داده شده دریافت می کند، اگر گره فرزند مستقیم گره `Element` باشد.
`get Children()`	`Element[]`	تمام گره های `Element` را که فرزندان مستقیم این گره `Element` هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.
`get Children(name)`	`Element[]`	تمام گره های `Element` را با نام مشخص شده و بدون فضای نام که فرزندان مستقیم این گره `Element` هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.
`get Children(name, namespace)`	`Element[]`	همه گره های `Element` را با نام و فضای نام داده شده که فرزندان مستقیم این گره `Element` هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.
`get Content(index)`	`Content`	گره را در شاخص داده شده در بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند، دریافت می کند.
`get Content Size()`	`Integer`	تعداد گره‌هایی را می‌گیرد که فرزندان مستقیم گره {@code Element} هستند.
`get Descendants()`	`Content[]`	همه گره هایی را که فرزندان مستقیم یا غیرمستقیم گره {@code Element} هستند، به ترتیبی که در سند نشان داده می شوند، دریافت می کند.
`get Document()`	`Document`	سند XML را دریافت می کند که حاوی گره {@code Element} است.
`get Name()`	`String`	نام محلی گره `Element` را دریافت می کند.
`get Namespace()`	`Namespace`	فضای نام گره `Element` را دریافت می کند.
`get Namespace(prefix)`	`Namespace`	فضای نام را با پیشوند داده شده برای گره `Element` دریافت می کند.
`get Parent Element()`	`Element`	گره `Element` والد گره را دریافت می کند.
`get Qualified Name()`	`String`	نام محلی و پیشوند فضای نام گره `Element` را به شکل `[namespacePrefix]:[localName]` دریافت می‌کند.
`get Text()`	`String`	مقدار متن گره `Element` را دریافت می کند.
`get Value()`	`String`	مقدار متن تمام گره هایی را که فرزندان مستقیم یا غیرمستقیم گره هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.
`is Ancestor Of(other)`	`Boolean`	تعیین می کند که آیا این گره `Element` والد مستقیم یا غیرمستقیم یک گره `Element` معین است.
`is Root Element()`	`Boolean`	تعیین می کند که آیا گره `Element` ، گره اصلی سند است یا خیر.
`remove Attribute(attribute)`	`Boolean`	در صورت وجود چنین ویژگی، ویژگی داده شده را برای این گره `Element` حذف می کند.
`remove Attribute(attributeName)`	`Boolean`	در صورت وجود چنین ویژگی، ویژگی این گره `Element` را با نام داده شده و بدون فضای نام حذف می کند.
`remove Attribute(attributeName, namespace)`	`Boolean`	در صورت وجود چنین ویژگی، ویژگی این گره `Element` را با نام و فضای نام داده شده حذف می کند.
`remove Content()`	`Content[]`	همه گره هایی را که فرزندان مستقیم گره {@code Element} هستند حذف می کند.
`remove Content(content)`	`Boolean`	اگر گره فرزند مستقیم گره {@code Element} باشد، گره داده شده را حذف می کند.
`remove Content(index)`	`Content`	گره را در نمایه داده شده از بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند حذف می کند.
`set Attribute(attribute)`	`Element`	ویژگی داده شده را برای این گره `Element` تنظیم می کند.
`set Attribute(name, value)`	`Element`	ویژگی را برای این گره `Element` با نام، مقدار و بدون فضای نام مشخص می کند.
`set Attribute(name, value, namespace)`	`Element`	ویژگی این گره `Element` را با نام، مقدار و فضای نام داده شده تنظیم می کند.
`set Name(name)`	`Element`	نام محلی گره `Element` را تنظیم می کند.
`set Namespace(namespace)`	`Element`	فضای نام را برای گره `Element` تنظیم می کند.
`set Text(text)`	`Element`	مقدار متن گره `Element` را تنظیم می کند.

مستندات دقیق

`add Content(content)`

گره داده شده را به عنوان آخرین فرزند گره Element اضافه می کند. آرگومان content می تواند یک شی Element یا هر شی گره ای باشد که با نوع فهرست شده در Content Type مطابقت دارد.

پارامترها

نام	تایپ کنید	توضیحات
`content`	`Content`	گره ای که باید اضافه شود

بازگشت

Element - گره Element ، برای زنجیر

`add Content(index, content)`

گره داده شده را در شاخص داده شده در بین تمام گره هایی که فرزندان مستقیم گره Element هستند درج می کند. آرگومان content می تواند یک شی Element یا هر شی گره ای باشد که با نوع فهرست شده در Content Type مطابقت دارد.

پارامترها

نام	تایپ کنید	توضیحات
`index`	`Integer`	شاخصی که در آن گره در میان تمام گره هایی که فرزندان مستقیم گره `Element` هستند درج شود
`content`	`Content`	گره برای درج

بازگشت

Element - گره Element ، برای زنجیر

`clone Content()`

کپی‌های پیوست‌نشده از همه گره‌هایی که فرزندان مستقیم گره {@code Element} هستند ایجاد می‌کند.

بازگشت

Content[] - آرایه‌ای از کپی‌های پیوست نشده از همه گره‌هایی که فرزندان مستقیم گره {@code Element} هستند

`detach()`

گره را از گره Element والد خود جدا می کند. اگر گره والد نداشته باشد، این روش تاثیری ندارد.

بازگشت

Content - گره جدا شده

`get All Content()`

همه گره هایی را که فرزندان مستقیم گره {@code Element} هستند را دریافت می کند.

بازگشت

Content[] - آرایه‌ای از همه گره‌هایی که فرزندان مستقیم گره {@code Element} هستند

`get Attribute(name)`

ویژگی این گره Element را با نام داده شده و بدون فضای نام دریافت می کند. اگر چنین ویژگی وجود نداشته باشد، این متد null را برمی‌گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام صفت

بازگشت

Attribute - مشخصه، یا اگر هیچ ویژگی با نام داده شده و فضای نام وجود نداشته باشد، null

`get Attribute(name, namespace)`

ویژگی این گره Element با نام و فضای نام داده شده دریافت می کند. اگر چنین گره ای وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام صفت
`namespace`	`Namespace`	فضای نام صفت

بازگشت

Attribute - مشخصه، یا اگر ویژگی با نام و فضای نام داده شده وجود نداشته باشد null

`get Attributes()`

تمام ویژگی‌های این گره Element را به ترتیبی که در سند ظاهر می‌شوند، دریافت می‌کند.

بازگشت

Attribute[] - آرایه ای از تمام ویژگی ها برای این گره Element

`get Child(name)`

اولین گره Element را با نام داده شده و بدون فضای نام که فرزند مستقیم این گره Element است، دریافت می کند. اگر چنین گره ای وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره `Element` فرزند

بازگشت

Element - گره Element ، یا اگر هیچ گره Element فرزند فوری با نام داده شده و بدون فضای نام وجود نداشته باشد، null .

`get Child(name, namespace)`

اولین گره Element را با نام و فضای نام داده شده دریافت می کند که فرزند مستقیم این گره Element است. اگر چنین گره ای وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره `Element` فرزند
`namespace`	`Namespace`	فضای نام گره `Element` فرزند

بازگشت

Element - گره Element ، یا اگر هیچ گره Element فرزند فوری با نام و فضای نام داده شده وجود نداشته باشد، null

`get Child Text(name)`

اگر گره فرزند مستقیم گره Element باشد، مقدار متن گره را با نام داده شده و بدون فضای نام دریافت می کند. اگر چنین گره ای وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره فرزند

بازگشت

String - مقدار متن گره فرزند، یا اگر هیچ گره فرزند فوری با نام داده شده و فضای نام وجود نداشته باشد، null .

`get Child Text(name, namespace)`

مقدار متن گره را با نام و فضای نام داده شده دریافت می کند، اگر گره فرزند مستقیم گره Element باشد. اگر چنین گره ای وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره فرزند
`namespace`	`Namespace`	فضای نام گره فرزند

بازگشت

String - مقدار متنی گره فرزند، یا اگر هیچ گره فرزند فوری با نام و فضای نام داده شده وجود نداشته باشد، null

`get Children()`

تمام گره های Element را که فرزندان مستقیم این گره Element هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.

بازگشت

Element[] - آرایه‌ای از تمام گره‌های Element که فرزندان مستقیم این گره Element هستند

`get Children(name)`

تمام گره های Element را با نام مشخص شده و بدون فضای نام که فرزندان مستقیم این گره Element هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره های `Element` فرزند

بازگشت

Element[] - آرایه ای از تمام گره های Element با نام داده شده و بدون فضای نامی که فرزندان مستقیم این گره Element هستند.

`get Children(name, namespace)`

همه گره های Element را با نام و فضای نام داده شده که فرزندان مستقیم این گره Element هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام گره های `Element` فرزند
`namespace`	`Namespace`	فضای نام گره های `Element` فرزند

بازگشت

Element[] - آرایه ای از تمام گره های Element با نام و فضای نام داده شده که فرزندان مستقیم این گره Element هستند.

`get Content(index)`

گره را در شاخص داده شده در بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند، دریافت می کند. اگر هیچ گره ای در ایندکس داده شده وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`index`	`Integer`	نمایه گره در بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند

بازگشت

Content - گره، یا اگر هیچ گره ای در شاخص داده شده وجود نداشته باشد null

`get Content Size()`

تعداد گره‌هایی را می‌گیرد که فرزندان مستقیم گره {@code Element} هستند.

بازگشت

Integer — تعداد گره هایی که فرزندان مستقیم گره {@code Element} هستند

`get Descendants()`

همه گره هایی را که فرزندان مستقیم یا غیرمستقیم گره {@code Element} هستند، به ترتیبی که در سند نشان داده می شوند، دریافت می کند.

بازگشت

Content[] - آرایه‌ای از تمام گره‌ها که فرزندان مستقیم یا غیرمستقیم گره {@code Element} هستند

`get Document()`

سند XML را دریافت می کند که حاوی گره {@code Element} است.

بازگشت

Document - سندی که حاوی گره {@code Element} است

`get Name()`

نام محلی گره Element را دریافت می کند. اگر گره دارای پیشوند فضای نام است، get Qualified Name() یا get Namespace() استفاده کنید. برای دریافت پیشوند، get Prefix() .

بازگشت

String - نام محلی گره Element

`get Namespace()`

فضای نام گره Element را دریافت می کند.

بازگشت

Namespace - فضای نام برای گره Element

`get Namespace(prefix)`

فضای نام را با پیشوند داده شده برای گره Element دریافت می کند.

پارامترها

نام	تایپ کنید	توضیحات
`prefix`	`String`	پیشوند فضای نام

بازگشت

Namespace - فضای نام با پیشوند داده شده برای گره Element

`get Parent Element()`

گره Element والد گره را دریافت می کند. اگر گره دارای والد نباشد، این متد null را برمی‌گرداند.

بازگشت

Element - گره Element والد

`get Qualified Name()`

نام محلی و پیشوند فضای نام گره Element را به شکل [namespacePrefix]:[localName] دریافت می‌کند. اگر گره پیشوند فضای نام ندارد، از get Name() استفاده کنید.

بازگشت

String - نام محلی و پیشوند فضای نام گره Element ، به شکل [namespacePrefix]:[localName]

`get Text()`

مقدار متن گره Element را دریافت می کند.

بازگشت

String - مقدار متن گره Element

`get Value()`

مقدار متن تمام گره هایی را که فرزندان مستقیم یا غیرمستقیم گره هستند، به ترتیبی که در سند ظاهر می شوند، دریافت می کند.

بازگشت

String - مقدار متن تمام گره هایی که فرزندان مستقیم یا غیرمستقیم گره هستند

`is Ancestor Of(other)`

تعیین می کند که آیا این گره Element والد مستقیم یا غیرمستقیم یک گره Element معین است.

پارامترها

نام	تایپ کنید	توضیحات
`other`	`Element`	گره `Element` دیگر

بازگشت

Boolean - true اگر این گره Element والد مستقیم یا غیرمستقیم گره Element داده شده باشد. false اگر نه

`is Root Element()`

تعیین می کند که آیا گره Element ، گره اصلی سند است یا خیر.

بازگشت

Boolean - true اگر گره Element گره ریشه سند باشد. false اگر نه

`remove Attribute(attribute)`

در صورت وجود چنین ویژگی، ویژگی داده شده را برای این گره Element حذف می کند.

پارامترها

نام	تایپ کنید	توضیحات
`attribute`	`Attribute`	ویژگی

بازگشت

Boolean - true اگر مشخصه وجود داشته باشد و حذف شود. false اگر نه

`remove Attribute(attributeName)`

در صورت وجود چنین ویژگی، ویژگی این گره Element را با نام داده شده و بدون فضای نام حذف می کند.

پارامترها

نام	تایپ کنید	توضیحات
`attribute Name`	`String`	نام صفت

بازگشت

Boolean - true اگر مشخصه وجود داشته باشد و حذف شود. false اگر نه

`remove Attribute(attributeName, namespace)`

در صورت وجود چنین ویژگی، ویژگی این گره Element را با نام و فضای نام داده شده حذف می کند.

پارامترها

نام	تایپ کنید	توضیحات
`attribute Name`	`String`	نام صفت
`namespace`	`Namespace`	فضای نام صفت

بازگشت

Boolean - true اگر مشخصه وجود داشته باشد و حذف شود. false اگر نه

`remove Content()`

همه گره هایی را که فرزندان مستقیم گره {@code Element} هستند حذف می کند.

بازگشت

Content[] - آرایه‌ای از تمام گره‌هایی که قبل از حذف شدن، فرزندان مستقیم گره {@code Element} بودند.

`remove Content(content)`

اگر گره فرزند مستقیم گره {@code Element} باشد، گره داده شده را حذف می کند. آرگومان content می تواند یک شی Element یا هر شی گره ای باشد که با نوع فهرست شده در Content Type مطابقت دارد.

پارامترها

نام	تایپ کنید	توضیحات
`content`	`Content`	گره برای حذف

بازگشت

Boolean - اگر گره یک فرزند فوری باشد و حذف شده باشد true . false اگر نه

`remove Content(index)`

گره را در نمایه داده شده از بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند حذف می کند. اگر هیچ گره ای در ایندکس داده شده وجود نداشته باشد، این متد null را برمی گرداند.

پارامترها

نام	تایپ کنید	توضیحات
`index`	`Integer`	نمایه گره در بین همه گره هایی که فرزندان مستقیم گره {@code Element} هستند

بازگشت

Content - گره‌ای که حذف شده است، یا اگر گره‌ای در شاخص داده‌شده وجود نداشته باشد، null

`set Attribute(attribute)`

ویژگی داده شده را برای این گره Element تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
`attribute`	`Attribute`	ویژگی برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر

`set Attribute(name, value)`

ویژگی را برای این گره Element با نام، مقدار و بدون فضای نام مشخص می کند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام ویژگی برای تنظیم
`value`	`String`	مقدار صفت برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر

`set Attribute(name, value, namespace)`

ویژگی این گره Element را با نام، مقدار و فضای نام داده شده تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام ویژگی برای تنظیم
`value`	`String`	مقدار صفت برای تنظیم
`namespace`	`Namespace`	فضای نام ویژگی برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر

`set Name(name)`

نام محلی گره Element را تنظیم می کند. برای تنظیم پیشوند فضای نام برای گره، set Namespace(namespace) در ارتباط با Xml Service.getNamespace(prefix, uri) استفاده کنید.

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام محلی برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر

`set Namespace(namespace)`

فضای نام را برای گره Element تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
`namespace`	`Namespace`	فضای نام برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر

`set Text(text)`

مقدار متن گره Element را تنظیم می کند. اگر گره قبلاً حاوی یک مقدار متن یا هر گره فرزند باشد، این روش محتوای قدیمی را بازنویسی می کند. برای افزودن یا درج محتوا به جای آن، add Content(content) یا add Content(index, content) استفاده کنید.

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	متن برای تنظیم

بازگشت

Element - گره Element ، برای زنجیر