Class CharacterData

CharacterData class

تقوم CharacterData بتوسيع العقدة بمجموعة من السمات والأساليب للوصول إلى بيانات الأحرف في DOM.

public abstract class CharacterData : Node

الخصائص

اسموصف
virtual Attributes { get; }خريطة NamedNodeMap تحتوي على سمات هذه العقدة (إذا كانت عنصرًا) أو خالية بخلاف ذلك.
virtual BaseURI { get; }URI الأساسي المطلق لهذه العقدة أو فارغ إذا لم يتمكن التطبيق من الحصول على URI مطلق.
ChildNodes { get; }قائمة NodeList التي تحتوي على كافة توابع هذه العقدة. إذا لم يكن هناك أطفال ، فهذه قائمة NodeList لا تحتوي على عقد ..
virtual Data { get; set; }بيانات الأحرف الخاصة بالعقدة التي تنفذ هذه الواجهة.
FirstChild { get; }الطفل الأول لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
LastChild { get; }آخر تابع لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
Length { get; }عدد وحدات 16 بت المتوفرة من خلال البيانات وطريقة substringData أدناه. قد يكون لهذا القيمة صفر ، أي أن عُقد CharacterData قد تكون فارغة.
virtual LocalName { get; }إرجاع الجزء المحلي من الاسم المؤهل لهذه العقدة . بالنسبة للعقد من أي نوع بخلاف ELEMENT_NODE و ATTRIBUTE_NODE والعقد التي تم إنشاؤها باستخدام طريقة DOM من المستوى 1 ، مثل Document.createElement () ، يكون هذا دائمًا فارغًا.
virtual NamespaceURI { get; }معرف مساحة الاسم لهذه العقدة ، أو فارغ إذا كانت غير محددة.
NextSibling { get; }العقدة التي تلي هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
abstract NodeName { get; }اسم هذه العقدة حسب نوعها.
abstract NodeType { get; }رمز يمثل نوع الكائن الأساسي.
virtual NodeValue { get; set; }قيمة هذه العقدة حسب نوعها.
virtual OwnerDocument { get; }كائن المستند المرتبط بهذه العقدة. هذا هو أيضًا كائن المستند المستخدم لإنشاء عقد جديدة. عندما تكون هذه العقدة عبارة عن مستند أو نوع مستند لم يتم استخدامه مع أي مستند حتى الآن ، يكون هذا فارغًا.
ParentElement { get; }يحصل على الوالدElement من هذه العقدة.
ParentNode { get; }أصل هذه العقدة. قد يكون لجميع العقد ، باستثناء Attr و Document و DocumentFragment و Entity و Notation ، أصل. ومع ذلك ، إذا تم إنشاء عقدة للتو ولم تتم إضافتها بعد إلى الشجرة ، أو إذا تمت إزالتها من الشجرة ، فسيكون ذلك فارغًا.
virtual Prefix { get; set; }بادئة مساحة الاسم لهذه العقدة ، أو فارغة إذا كانت غير محددة. عندما يتم تعريفه على أنه فارغ ، فإن الإعداد ليس له تأثير
PreviousSibling { get; }العقدة التي تسبق هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
virtual TextContent { get; set; }تقوم هذه السمة بإرجاع المحتوى النصي لهذه العقدة وتوابعها. عندما يتم تعريفه على أنه فارغ ، فإن تعيينه ليس له أي تأثير. عند الإعداد ، تتم إزالة أي أطفال محتملين قد تكون هذه العقدة لديهم ، وإذا لم تكن السلسلة الجديدة فارغة أو فارغة ، فسيتم استبدالها بعقدة نصية واحدة تحتوي على السلسلة التي تم تعيين هذه السمة عليها.

طُرق

اسموصف
AddEventListener(string, IEventListener)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, DOMEventHandler, bool)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, IEventListener, bool)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AppendChild(Node)يضيف العقدة newChild إلى نهاية قائمة العناصر الفرعية لهذه العقدة. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
virtual AppendData(string)قم بإلحاق السلسلة بنهاية بيانات الأحرف الخاصة بالعقدة.
CloneNode()إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
CloneNode(bool)إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
virtual DeleteData(int, int)قم بإزالة نطاق من وحدات 16 بت من العقدة.
DispatchEvent(Event)تسمح هذه الطريقة بإرسال الأحداث إلى نموذج حدث عمليات التنفيذ.
Dispose()تنفيذ مهام محددة بواسطة التطبيق مرتبطة بتحرير الموارد غير المُدارة أو تحريرها أو إعادة تعيينها.
virtual GetPlatformType()تُستخدم هذه الطريقة لاسترداد كائن ECMAScriptType .
virtual HasAttributes()إرجاع ما إذا كانت هذه العقدة (إذا كانت عنصرًا) لها أي سمات
HasChildNodes()إرجاع ما إذا كان لهذه العقدة أي توابع.
InsertBefore(Node, Node)يقوم بإدراج العقدة قبل تابع العقدة الفرعية الموجودة. إذا كان الطفل فارغًا ، فقم بإدراج العقدة في نهاية قائمة العناصر الفرعية . إذا كان الكائن الفرعي عبارة عن كائن DocumentFragment ، فسيتم إدراج جميع توابعه ، بالترتيب نفسه ، قبل التابع. إذا كان الطفل موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
virtual InsertData(int, string)أدخل سلسلة في إزاحة وحدة 16 بت المحددة.
IsDefaultNamespace(string)يتحقق هذا الأسلوب مما إذا كانت مساحة الاسم المحددة هي مساحة الاسم الافتراضية أم لا.
IsEqualNode(Node)اختبار ما إذا كانت العقدتان متساويتان. تختبر هذه الطريقة المساواة بين العقد ، وليس التماثل (أي ما إذا كانت العقدتان مرجعيتان لنفس الكائن) والتي يمكن اختبارها باستخدام Node.isSameNode (). جميع العقد التي هي نفسها ستكون متساوية أيضًا ، على الرغم من أن العكس قد لا يكون صحيحًا.
IsSameNode(Node)إرجاع ما إذا كانت هذه العقدة هي نفس العقدة المحددة. توفر هذه الطريقة طريقة لتحديد ما إذا كان مرجعان للعقدة يتم إرجاعهما بواسطة مرجع التطبيق نفس الكائن. عندما يكون مراجعان للعقدة مراجع لنفس الكائن ، حتى لو كان ذلك من خلال وكيل ، يمكن استخدام المراجع بشكل تبادلي تمامًا ، بحيث يكون لجميع السمات نفس القيم واستدعاء نفس طريقة DOM على أي مرجع يكون له نفس التأثير دائمًا.
LookupNamespaceURI(string)ابحث عن مساحة الاسم URI المرتبطة بالبادئة المحددة ، بدءًا من هذه العقدة.
LookupPrefix(string)ابحث عن البادئة المرتبطة بمساحة الاسم المحددة URI ، بدءًا من هذه العقدة. يتم تجاهل تعريفات مساحة الاسم الافتراضية بهذه الطريقة. راجع بحث بادئة مساحة الاسم للحصول على تفاصيل حول الخوارزمية المستخدمة بواسطة هذه الطريقة.
Normalize()وضع جميع العقد النصية في العمق الكامل للشجرة الفرعية أسفل هذه العقدة ، بما في ذلك عقد السمات ، في نموذج “عادي” حيث تفصل البنية فقط (على سبيل المثال ، العناصر والتعليقات وتعليمات المعالجة وأقسام CDATA ومراجع الكيانات) النص العقد ، أي لا توجد عقد نصية متجاورة ولا عقد نصية فارغة. يمكن استخدام هذا للتأكد من أن عرض DOM للمستند هو نفسه كما لو تم حفظه وإعادة تحميله ، ويكون مفيدًا عندما تكون العمليات (مثل عمليات بحث XPointer [XPointer]) التي تعتمد على بنية شجرة وثيقة معينة يستخدم. إذا كانت المعلمة “تطبيع الأحرف” لكائن DOMConfiguration المرفقة بـ Node.ownerDocument صحيحة ، فإن هذه الطريقة ستعمل أيضًا على تسوية أحرف العقد النصية بشكل كامل.
RemoveChild(Node)يزيل العقدة الفرعية التي أشار إليها oldChild من قائمة الأطفال ، ويعيدها .
RemoveEventListener(string, IEventListener)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, DOMEventHandler, bool)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, IEventListener, bool)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
ReplaceChild(Node, Node)يستبدل العقدة الفرعية oldChild بـ newChild في قائمة الأطفال ، ويعيد العقدة oldChild. إذا كان newChild هو كائن DocumentFragment ، فسيتم استبدال oldChild بكافة العناصر الفرعية DocumentFragment ، والتي يتم إدراجها بنفس الترتيب. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
virtual ReplaceData(int, int, string)استبدل الأحرف التي تبدأ من إزاحة وحدة 16 بت المحددة بالسلسلة المحددة.
virtual SubstringData(int, int)استخراج نطاق من البيانات من العقدة .
override ToString()إرجاع أString الذي يمثل هذا المثال.

أنظر أيضا