Document

Document class

يمثل المستند مستند HTML أو XML أو SVG بأكمله. من الناحية المفاهيمية ، فهو جذر شجرة المستند ، ويوفر الوصول الأساسي إلى بيانات المستند.

public class Document : Node, IDocumentEvent, IDocumentStyle, IDocumentTraversal, 
    IGlobalEventHandlers, INonElementParentNode, IParentNode, IXPathEvaluator

الخصائص

اسم وصف
virtual Attributes { get; } خريطة NamedNodeMap تحتوي على سمات هذه العقدة (إذا كانت عنصرًا) أو خالية بخلاف ذلك.
override BaseURI { get; } URI الأساسي المطلق لهذه العقدة أو فارغ إذا لم يتمكن التطبيق من الحصول على URI مطلق.
CharacterSet { get; } الحصول على ترميز المستند.
Charset { get; } الحصول على ترميز المستند.
ChildElementCount { get; } إرجاع العدد الحالي لعُقد العناصر التابعة لهذا العنصر. 0 إذا كان هذا العنصر لا يحتوي على عقد فرعية من نوع العقدة 1.
ChildNodes { get; } قائمة NodeList التي تحتوي على كافة توابع هذه العقدة. إذا لم يكن هناك أطفال ، فهذه قائمة NodeList لا تحتوي على عقد ..
Children { get; } إرجاع العناصر الفرعية .
ContentType { get; } الحصول على نوع محتوى المستند.
Context { get; } يحصل على سياق التصفح الحالي.
DefaultView { get; } السمة الافتراضية للعرض IDL لواجهة المستند ، عند الحصول على ، يجب أن تعيد كائن WindowProxy الخاص بسياق الاستعراض الخاص بهذا المستند ، إذا كان هذا المستند يحتوي على سياق استعراض مرتبط ، أو فارغًا بخلاف ذلك.
Doctype { get; } إقرار نوع المستند المرتبط بهذا المستند .
DocumentElement { get; } هذه سمة ملائمة تتيح الوصول المباشر إلى العقدة الفرعية التي تمثل عنصر المستند في المستند.
DocumentURI { get; } مكان المستند أو فارغ إذا لم يتم تعريفه أو إذا تم إنشاء المستند باستخدام DOMImplementation.createDocument.
FirstChild { get; } الطفل الأول لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
FirstElementChild { get; } إرجاع أول عقدة عنصر فرعي لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عناصر فرعية.
Implementation { get; } كائن DOMImplementation الذي يعالج هذا المستند.
InputEncoding { get; } الحصول على ترميز المستند.
LastChild { get; } آخر تابع لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
LastElementChild { get; } إرجاع آخر عقدة عنصر فرعي لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عناصر فرعية.
virtual LocalName { get; } إرجاع الجزء المحلي من الاسم المؤهل لهذه العقدة . بالنسبة للعقد من أي نوع بخلاف ELEMENT_NODE و ATTRIBUTE_NODE والعقد التي تم إنشاؤها باستخدام طريقة DOM من المستوى 1 ، مثل Document.createElement () ، يكون هذا دائمًا فارغًا.
Location { get; } مكان المستند.
virtual NamespaceURI { get; } معرف مساحة الاسم لهذه العقدة ، أو فارغ إذا كانت غير محددة.
NextElementSibling { get; } إرجاع عقدة العنصر الشقيق التالية لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عقد شقيقة لعنصر تأتي بعد هذا في شجرة الوثيقة.
NextSibling { get; } العقدة التي تلي هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
override NodeName { get; } اسم هذه العقدة حسب نوعها.
override NodeType { get; } رمز يمثل نوع الكائن الأساسي.
virtual NodeValue { get; set; } قيمة هذه العقدة حسب نوعها.
Origin { get; } يحصل على اصل الوثيقة .
override OwnerDocument { get; } الحصول على مستند المالك.
ParentElement { get; } يحصل على الوالدElement من هذه العقدة.
ParentNode { get; } أصل هذه العقدة. قد يكون لجميع العقد ، باستثناء Attr و Document و DocumentFragment و Entity و Notation ، أصل. ومع ذلك ، إذا تم إنشاء عقدة للتو ولم تتم إضافتها بعد إلى الشجرة ، أو إذا تمت إزالتها من الشجرة ، فسيكون ذلك فارغًا.
virtual Prefix { get; set; } بادئة مساحة الاسم لهذه العقدة ، أو فارغة إذا كانت غير محددة. عندما يتم تعريفه على أنه فارغ ، فإن الإعداد ليس له أي تأثير
PreviousElementSibling { get; } إرجاع عقدة العنصر الشقيقة السابقة لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عقد شقيقة لعنصر تأتي قبل هذا في شجرة الوثيقة.
PreviousSibling { get; } العقدة التي تسبق هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
ReadyState { get; } إرجاع جاهزية المستند. “التحميل” أثناء تحميل المستند ، “تفاعلي” بمجرد الانتهاء من التحليل مع استمرار تحميل الموارد الفرعية ، و “اكتمال” بمجرد تحميله.
StrictErrorChecking { get; set; } سمة تحدد ما إذا كان التحقق من الخطأ يتم فرضه أم لا. عند التعيين على “خطأ” ، يكون التطبيق مجانيًا في عدم اختبار كل حالة خطأ محتملة يتم تحديدها عادةً على عمليات DOM ، وعدم رفع أي استثناءات DOM على عمليات DOM أو الإبلاغ عن الأخطاء أثناء استخدام Document.normalizeDocument (). في حالة الخطأ ، يكون السلوك غير محدد. هذه السمة صحيحة بشكل افتراضي.
StyleSheets { get; } قائمة تحتوي على جميع أوراق الأنماط المرتبطة أو المضمنة في مستند بشكل صريح. بالنسبة لمستندات HTML ، يتضمن ذلك أوراق الأنماط الخارجية ، المضمنة عبر عنصر HTML LINK ، وعناصر النمط المضمنة.
virtual TextContent { get; set; } تقوم هذه السمة بإرجاع المحتوى النصي لهذه العقدة وتوابعها. عندما يتم تعريفه على أنه فارغ ، فإن تعيينه ليس له أي تأثير. عند الإعداد ، تتم إزالة أي أطفال محتملين قد تكون هذه العقدة لديهم ، وإذا لم تكن السلسلة الجديدة فارغة أو فارغة ، يتم استبدالها بعقدة نصية واحدة تحتوي على السلسلة التي تم تعيين هذه السمة عليها.
XmlStandalone { get; set; } سمة تحدد ، كجزء من إعلان XML ، ما إذا كان هذا المستند مستقلاً. هذا خطأ عندما يكون غير محدد.
XmlVersion { get; set; } سمة تحدد ، كجزء من إعلان XML ، رقم إصدار هذا المستند. إذا لم يكن هناك إعلان وإذا كان هذا المستند يدعم ميزة “XML” ، فإن القيمة هي “1.0”. إذا كان هذا المستند لا يدعم ميزة “XML” ، فستكون القيمة دائمًا خالية.

طُرق

اسم وصف
AddEventListener(string, IEventListener) تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, DOMEventHandler, bool) تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, IEventListener, bool) تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AppendChild(Node) يضيف العقدة newChild إلى نهاية قائمة العناصر الفرعية لهذه العقدة. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
CloneNode() إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
CloneNode(bool) إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
CreateAttribute(string) لإنشاء Attr بالاسم المحدد .
CreateAttributeNS(string, string) ينشئ سمة للاسم المؤهل المحدد ومساحة URI.
CreateCDATASection(string) ينشئ عقدة CDATAS تكون قيمتها هي السلسلة المحددة.
CreateComment(string) يقوم بإنشاء عقدة تعليق بالنظر إلى السلسلة المحددة .
CreateDocumentFragment() إنشاء كائن DocumentFragment فارغ .
CreateDocumentType(string, string, string, string) ينشئ عقدة DocumentType .
CreateElement(string) لتكوين عنصر من النوع المحدد. لاحظ أن المثيل الذي تم إرجاعه يطبق واجهة العنصر ، لذلك يمكن تحديد السمات مباشرة على الكائن الذي تم إرجاعه.
CreateElementNS(string, string) ينشئ عنصرًا للاسم المؤهل المحدد ومساحة الاسم URI.
CreateEntityReference(string) إنشاء كائن EntityReference. بالإضافة إلى ذلك ، إذا كان الكيان المشار إليه معروفًا ، فستكون القائمة الفرعية لعقدة EntityReference مماثلة لقائمة عقدة الكيان المقابلة.
CreateEvent(string) ينشئ ملفEvent من النوع الذي يدعمه التنفيذ .
CreateExpression(string, IXPathNSResolver) لتكوين تعبير XPath تم تحليله باستخدام مساحات الأسماء التي تم حلها. هذا مفيد عندما يُعاد استخدام تعبير في أحد التطبيقات لأنه يجعل من الممكن تجميع سلسلة التعبير في نموذج داخلي أكثر كفاءة و حل جميع بادئات مساحة الاسم التي تحدث داخل التعبير.
CreateNodeIterator(Node) قم بإنشاء NodeIterator جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
CreateNodeIterator(Node, long) قم بإنشاء NodeIterator جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
CreateNodeIterator(Node, long, INodeFilter) قم بإنشاء NodeIterator جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
CreateNSResolver(Node) تتكيف مع أي عقدة DOM لتحليل مساحات الأسماء بحيث يمكن بسهولة تقييم تعبير XPath بالنسبة إلى سياق العقدة حيث ظهر داخل المستند. يعمل هذا المحول مثل طريقة DOM المستوى 3lookupNamespaceURI على العقد في حل مساحة الاسمURI من بادئة معينة باستخدام المعلومات الحالية المتاحة في التسلسل الهرمي للعقدة في time lookupNamespaceURI ، يتم أيضًا حل بادئة xml الضمنية بشكل صحيح.
CreateProcessingInstruction(string, string) ينشئ عقدة ProcessingInstruction مع إعطاء الاسم المحدد وسلاسل البيانات.
CreateTextNode(string) يقوم بإنشاء عقدة نصية مع إعطاء السلسلة المحددة .
CreateTreeWalker(Node) قم بإنشاء TreeWalker جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
CreateTreeWalker(Node, long) قم بإنشاء TreeWalker جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
CreateTreeWalker(Node, long, INodeFilter) قم بإنشاء TreeWalker جديد فوق الشجرة الفرعية التي تم تحديد جذرها في العقدة المحددة.
DispatchEvent(Event) تسمح هذه الطريقة بإرسال الأحداث إلى نموذج حدث عمليات التنفيذ.
Dispose() تنفيذ مهام محددة بواسطة التطبيق مرتبطة بتحرير الموارد غير المُدارة أو تحريرها أو إعادة تعيينها.
Evaluate(string, Node, IXPathNSResolver, XPathResultType, object) بتقييم سلسلة تعبير XPath وإرجاع نتيجة من النوع المحدد إن أمكن.
GetElementById(string) إرجاع العنصر الذي يحتوي على سمة معرف بالقيمة المحددة. إذا لم يكن هذا العنصر موجودًا ، فسيتم إرجاعه فارغًا. إذا كان هناك أكثر من عنصر واحد يحتوي على سمة معرف بهذه القيمة ، فإن ما يتم إرجاعه يكون غير محدد.
GetElementsByClassName(string) إرجاع كائن NodeList مباشر يحتوي على جميع العناصر في المستند التي تحتوي على جميع الفئات المحددة في الوسيطة . http://www.w3.org/TR/dom/
GetElementsByTagName(string) إرجاع NodeList لجميع العناصر بترتيب المستند مع اسم علامة محدد ومضمنة في المستند.
GetElementsByTagNameNS(string, string) إرجاع NodeList لجميع العناصر مع اسم محلي محدد ومساحة اسم URI بترتيب المستند.
virtual GetPlatformType() تُستخدم هذه الطريقة لاسترداد كائن ECMAScriptType .
virtual HasAttributes() إرجاع ما إذا كانت هذه العقدة (إذا كانت عنصرًا) لها أي سمات
HasChildNodes() إرجاع ما إذا كان لهذه العقدة أي توابع.
ImportNode(Node, bool) يستورد عقدة من مستند آخر إلى هذا المستند ، بدون تغيير أو إزالة العقدة المصدر من المستند الأصلي ؛ هذه الطريقة تنشئ نسخة جديدة من العقدة المصدر.
InsertBefore(Node, Node) يقوم بإدراج العقدة قبل تابع العقدة الفرعية الموجودة. إذا كان التابع فارغًا ، أدخل العقدة في نهاية قائمة العناصر الفرعية . إذا كان الكائن الفرعي عبارة عن كائن DocumentFragment ، فسيتم إدراج جميع توابعه ، بالترتيب نفسه ، قبل التابع. إذا كان الطفل موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
IsDefaultNamespace(string) يتحقق هذا الأسلوب مما إذا كانت مساحة الاسم المحددة هي مساحة الاسم الافتراضية أم لا.
IsEqualNode(Node) اختبار ما إذا كانت العقدتان متساويتان. تختبر هذه الطريقة المساواة بين العقد ، وليس التماثل (أي ما إذا كانت العقدتان مرجعيتان لنفس الكائن) والتي يمكن اختبارها باستخدام Node.isSameNode (). جميع العقد التي هي نفسها ستكون متساوية أيضًا ، على الرغم من أن العكس قد لا يكون صحيحًا.
IsSameNode(Node) إرجاع ما إذا كانت هذه العقدة هي نفس العقدة المحددة. توفر هذه الطريقة طريقة لتحديد ما إذا كان مرجعان للعقدة يتم إرجاعهما بواسطة مرجع التطبيق نفس الكائن. عندما يكون مراجعان للعقدة مراجع لنفس الكائن ، حتى لو كان ذلك من خلال وكيل ، يمكن استخدام المراجع بشكل تبادلي تمامًا ، بحيث يكون لجميع السمات نفس القيم واستدعاء نفس طريقة DOM على أي مرجع له نفس التأثير دائمًا.
LookupNamespaceURI(string) ابحث عن مساحة الاسم URI المرتبطة بالبادئة المحددة ، بدءًا من هذه العقدة.
LookupPrefix(string) ابحث عن البادئة المرتبطة بمساحة الاسم المحددة URI ، بدءًا من هذه العقدة. يتم تجاهل تعريفات مساحة الاسم الافتراضية بهذه الطريقة. راجع بحث بادئة مساحة الاسم للحصول على تفاصيل حول الخوارزمية المستخدمة بواسطة هذه الطريقة.
Navigate(RequestMessage) تحميل المستند بناءً على كائن الطلب المحدد ، مع استبدال المحتوى السابق.
Navigate(string) تحميل المستند في محدد موقع المعلومات (URL) المحدد في المثيل الحالي ، مع استبدال المحتوى السابق.
Navigate(Url) تحميل المستند في محدد موقع المعلومات (URL) المحدد في المثيل الحالي ، مع استبدال المحتوى السابق.
Navigate(Stream, string) تحميل المستند من محتوى محدد واستخدام baseUri لحل الموارد ذات الصلة ، واستبدال المحتوى السابق. يبدأ تحميل المستند من الموضع الحالي في الدفق .
Navigate(Stream, Url) تحميل المستند من محتوى محدد واستخدام baseUri لحل الموارد ذات الصلة ، واستبدال المحتوى السابق. يبدأ تحميل المستند من الموضع الحالي في الدفق .
Navigate(string, string) تحميل المستند من محتوى محدد واستخدام baseUri لحل الموارد ذات الصلة ، واستبدال المحتوى السابق.
Navigate(string, Url) تحميل المستند من محتوى محدد واستخدام baseUri لحل الموارد ذات الصلة ، واستبدال المحتوى السابق.
Normalize() وضع جميع العقد النصية في العمق الكامل للشجرة الفرعية أسفل هذه العقدة ، بما في ذلك عقد السمات ، في نموذج “عادي” حيث تفصل البنية فقط (على سبيل المثال ، العناصر والتعليقات وإرشادات المعالجة وأقسام CDATA ومراجع الكيانات) النص العقد ، أي لا توجد عقد نصية متجاورة ولا عقد نصية فارغة. يمكن استخدام هذا للتأكد من أن عرض DOM للمستند هو نفسه كما لو تم حفظه وإعادة تحميله ، ويكون مفيدًا عندما تكون العمليات (مثل عمليات بحث XPointer [XPointer]) التي تعتمد على بنية شجرة وثيقة معينة يستخدم. إذا كانت المعلمة “تطبيع الأحرف” لكائن DOMConfiguration المرفقة بـ Node.ownerDocument صحيحة ، فإن هذه الطريقة ستعمل أيضًا على تسوية أحرف العقد النصية بشكل كامل.
QuerySelector(string) إرجاع العنصر الأول في المستند الذي يتطابق مع selector
QuerySelectorAll(string) إرجاع قائمة NodeList لجميع العناصر الموجودة في المستند ، والتي تطابق selector
RemoveChild(Node) يزيل العقدة الفرعية التي أشار إليها oldChild من قائمة الأطفال ، ويعيدها .
RemoveEventListener(string, IEventListener) تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, DOMEventHandler, bool) تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, IEventListener, bool) تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
virtual RenderTo(IDevice) تُستخدم هذه الطريقة لتقديم محتويات المستند الحالي إلى جهاز رسومي محدد.
ReplaceChild(Node, Node) يستبدل العقدة الفرعية oldChild بـ newChild في قائمة الأطفال ، ويعيد العقدة oldChild. إذا كان newChild هو كائن DocumentFragment ، فسيتم استبدال oldChild بكافة العناصر الفرعية DocumentFragment ، والتي يتم إدراجها بنفس الترتيب. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
override ToString() إرجاع أString الذي يمثل هذا المثال.
Write(params string[]) اكتب سلسلة نصية إلى تدفق مستند تم فتحه بواسطة open (). لاحظ أن الوظيفة ستنتج document الذي لا يكون بالضرورة مدفوعًا ب DTD وبالتالي قد ينتج عن ذلك نتيجة غير صالحة في سياق المستند.
WriteLn(params string[]) اكتب سلسلة نصية متبوعة بحرف سطر جديد إلى دفق document مفتوح بواسطة open (). لاحظ أن الوظيفة will تنتج مستندًا ليس بالضرورة مدفوعًا بـ DTD و وبالتالي قد ينتج نتيجة غير صالحة في سياق document

أنظر أيضا