Class EntityRef
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
EntityRef
تمثيل لعقدة EntityReference في XML
مستندات تفصيلية
detach()
تؤدي هذه العملية إلى فصل العقدة عن العقدة الرئيسية Element. إذا لم تكن للعقدة عنصر رئيسي، لن يكون لهذه الطريقة أي تأثير.
الإرجاع
Content - العقدة المنفصلة
getName()
تحصل على اسم عقدة EntityReference.
الإرجاع
String: اسم عقدة EntityReference
getParentElement()
تحصل على العقدة الرئيسية Element للعقدة. إذا لم تكن للعقدة عنصر رئيسي، تعرِض هذه الطريقةnull.
الإرجاع
Element: العقدة الرئيسية Element
getPublicId()
تحصل على المعرّف العلني لعقدة EntityReference. إذا لم تكن العقدة لها معرّف علني،
تعرض هذه الطريقة القيمة null.
الإرجاع
String: رقم التعريف العلني لعقدة EntityReference، أو null إذا لم يكن لديها أي رقم تعريف
getSystemId()
للحصول على معرّف النظام لعقدة EntityReference. إذا لم تكن العقدة تحتوي على معرّف نظام،
تعرض هذه الطريقة القيمة null.
الإرجاع
String: رقم تعريف النظام لعقدة EntityReference، أو null إذا لم يكن لديها أي رقم تعريف
getValue()
تحصل على القيمة النصية لجميع العقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، بالترتيب الذي
تظهر به في المستند.
الإرجاع
String: القيمة النصية لجميع العقد التي تكون عناصر ثانوية مباشرة أو غير مباشرة للعقدة
setName(name)
تُستخدَم لضبط اسم عقدة EntityReference.
المعلَمات
| الاسم | النوع | الوصف |
name | String | الاسم المطلوب ضبطه |
الإرجاع
EntityRef: عقدة EntityReference لإنشاء سلاسل
setPublicId(id)
لضبط المعرّف العلني لعقدة EntityReference.
المعلَمات
| الاسم | النوع | الوصف |
id | String | رقم التعريف العلني المطلوب ضبطه |
الإرجاع
EntityRef: عقدة EntityReference لإنشاء سلاسل
setSystemId(id)
لضبط معرّف النظام الخاص بعقدة EntityReference
المعلَمات
| الاسم | النوع | الوصف |
id | String | رقم تعريف النظام المطلوب ضبطه |
الإرجاع
EntityRef: عقدة EntityReference لإنشاء سلاسل
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eEntityRef\u003c/code\u003e represents an XML \u003ccode\u003eEntityReference\u003c/code\u003e node, providing methods to interact with and modify it within a document.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods to get and set the name, public ID, and system ID of the entity reference.\u003c/p\u003e\n"],["\u003cp\u003eYou can detach the node from its parent, retrieve its text value, and access its parent element using provided methods.\u003c/p\u003e\n"],["\u003cp\u003eThis class facilitates working with external entities referenced within an XML document using Apps Script's XML Service.\u003c/p\u003e\n"]]],["The `EntityRef` represents an XML entity reference node. Key actions include: getting the node's name, parent element, public ID, system ID, and the text value of its children. It also allows detaching from its parent. You can set the node's name, public ID, and system ID. If the node doesn't have a parent, public ID, or system ID, methods will return null or have no effect.\n"],null,["# Class EntityRef\n\nEntityRef\n\nA representation of an XML `Entity``Reference` node. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|-------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [detach()](#detach()) | [Content](/apps-script/reference/xml-service/content) | Detaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getName()](#getName()) | `String` | Gets the name of the `Entity``Reference` node. |\n| [getParentElement()](#getParentElement()) | [Element](/apps-script/reference/xml-service/element) | Gets the node's parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getPublicId()](#getPublicId()) | `String` | Gets the public ID of the `Entity``Reference` node. |\n| [getSystemId()](#getSystemId()) | `String` | Gets the system ID of the `Entity``Reference` node. |\n| [getValue()](#getValue()) | `String` | Gets the text value of all nodes that are direct or indirect children of the node, in the order they appear in the document. |\n| [setName(name)](#setName(String)) | [EntityRef](#) | Sets the name of the `Entity``Reference` node. |\n| [setPublicId(id)](#setPublicId(String)) | [EntityRef](#) | Sets the public ID of the `Entity``Reference` node. |\n| [setSystemId(id)](#setSystemId(String)) | [EntityRef](#) | Sets the system ID of the `Entity``Reference` node. |\n\nDetailed documentation\n----------------------\n\n### `detach()`\n\nDetaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent,\nthis method has no effect.\n\n#### Return\n\n\n[Content](/apps-script/reference/xml-service/content) --- the detached node\n\n*** ** * ** ***\n\n### `get``Name()`\n\nGets the name of the `Entity``Reference` node.\n\n#### Return\n\n\n`String` --- the name of the `Entity``Reference` node\n\n*** ** * ** ***\n\n### `get``Parent``Element()`\n\nGets the node's parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent, this method\nreturns `null`.\n\n#### Return\n\n\n[Element](/apps-script/reference/xml-service/element) --- the parent `Element` node\n\n*** ** * ** ***\n\n### `get``Public``Id()`\n\nGets the public ID of the `Entity``Reference` node. If the node does not have a public ID,\nthis method returns `null`.\n\n#### Return\n\n\n`String` --- the public ID of the `Entity``Reference` node, or `null` if it has none\n\n*** ** * ** ***\n\n### `get``System``Id()`\n\nGets the system ID of the `Entity``Reference` node. If the node does not have a system ID,\nthis method returns `null`.\n\n#### Return\n\n\n`String` --- the system ID of the `Entity``Reference` node, or `null` if it has none\n\n*** ** * ** ***\n\n### `get``Value()`\n\nGets the text value of all nodes that are direct or indirect children of the node, in the order\nthey appear in the document.\n\n#### Return\n\n\n`String` --- the text value of all nodes that are direct or indirect children of the node\n\n*** ** * ** ***\n\n### `set``Name(name)`\n\nSets the name of the `Entity``Reference` node.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|-----------------|\n| `name` | `String` | the name to set |\n\n#### Return\n\n\n[EntityRef](#) --- the `Entity``Reference` node, for chaining\n\n*** ** * ** ***\n\n### `set``Public``Id(id)`\n\nSets the public ID of the `Entity``Reference` node.\n\n#### Parameters\n\n| Name | Type | Description |\n|------|----------|----------------------|\n| `id` | `String` | the public ID to set |\n\n#### Return\n\n\n[EntityRef](#) --- the `Entity``Reference` node, for chaining\n\n*** ** * ** ***\n\n### `set``System``Id(id)`\n\nSets the system ID of the `Entity``Reference` node.\n\n#### Parameters\n\n| Name | Type | Description |\n|------|----------|----------------------|\n| `id` | `String` | the system ID to set |\n\n#### Return\n\n\n[EntityRef](#) --- the `Entity``Reference` node, for chaining"]]
