5- أهم دوال وخصائص GeckoNode.

بسم الله الرحمن الرحيم

السلام عليكم ورحمة الله وبركاته

اللهم علمنا ماينفعنا وانفعنا بما علمتنا إنك أنت العليم الحكيم

====>What is Gecko Node ?<====

هو Interface تقوم العديد من الفصائل في GeckoFX بتنفيذها ،لتسمح لهذه الفصائل المختلفة أن تعامل بالمثل أو بنفس الطريقة.

====>أهم الخصائص<====

1- ChildNodes

تعيد GeckoNodeCollection تحتوي على العناصر الموجودة داخل أو تحت هذا العنصر.

VB.Net

Dim Element As GeckoElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") For Each Child As GeckoNode In Element.ChildNodes If Child.LocalName = "tbody" Then MsgBox("Table text content = " & Child.TextContent) Next

C Sharp

GeckoElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); foreach (GeckoNode Child in Element.ChildNodes) { if (Child.LocalName == "tbody") MessageBox.Show("Table text content = " + Child.TextContent); }

2-LocalName

تعيد الوسم الخاص بالعنصر.

إن لم يكن من نوع GeckoElement أي ليس له TagName ستعيد Null ("").

VB.Net

Dim Node As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Node.LocalName)

C Sharp

GeckoNode Node = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Node.LocalName);

3- NameSpaceURI

تعيد رابط الفضاء الخاص بالـNode.

إن لم تكن الـNode في فضاء ستعيد Null (لا شيء).

VB.Net

Dim Element As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.NamespaceURI)

C Sharp

GeckoNode Node = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Node.NamespaceURI);

4-NextSibling

تعيد "الأخ" التالي للـNode الحالي في القائمة ChildNodes الخاصة بــ"أب" الـNode الحالي☻.

تعيد الـNode التالي في القائمة ChildNodes الخاصة بــ"أب" الـNode الحالي☻.

VB.Net

Dim Cell As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("th")(0) Do While Not IsNothing(Cell) If Cell.NodeType = NodeType.Element Then MsgBox(Cell.TextContent) End If Cell = Cell.NextSibling Loop

C Sharp

GeckoNode Cell = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("th")[0]; while (Cell != null) { if (Cell.NodeType == NodeType.Element) { MessageBox.Show(Cell.TextContent); } Cell = Cell.NextSibling; }

5- PreviousSibling

تعيد "الأخ" السابق للـNode الحالي في القائمة ChildNodes الخاصة بــ"أب" الـNode الحالي.

تعيد الـNode السابق في القائمة ChildNodes الخاصة بــ"أب" الـNode الحالي.

VB.Net

Dim Node As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim Brother As GeckoNode = Node.PreviousSibling

C Sharp

GeckoNode Node = NameOfYourWebBrowser.Document.GetElementById("Testtable"); GeckoNode Brother = Node.PreviousSibling;

6- NodeName

تعيد إسم الـNode.

تختلف القيمة باختلاف نوع الـNode الجدول التالي يوضح القيمة التي تعيدها الخاصية باختلاف النوع.

النوع	قيمة nodeName
`Attr`	قيمة `Attr.name`
`CDATASection`	`"#cdata-section"`
`Comment`	`"#comment"`
`Document`	`"#document"`
`DocumentFragment`	`"#document-fragment"`
`DocumentType`	قيمة `DocumentType.name`
`Element`	قيمة `Element.tagName`
`Entity`	The entity name
`EntityReference`	The name of entity reference
`Notation`	The notation name
`ProcessingInstruction`	قيمة `ProcessingInstruction.target`
`Text`	`"#text"`

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(TableNode.NodeName)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(TableNode.NodeName);

5- NodeValue

تعيد قيمة الـNode.

تختلف القيمة باختلاف نوع الـNode الجدول التالي يوضح القيمة التي تعيدها الخاصية باختلاف النوع.

النوع	قيمة Node.NodeValue
CDATASection	content of the CDATA Section
Comment	content of the comment
Document	null
DocumentFragment	null
DocumentType	null
Element	null
NamedNodeMap	null
EntityReference	null
Notation	null
ProcessingInstruction	entire content excluding the target
Text	content of the text node

6- NodeType

تعيد رقم يمثل نوع الـ"عنصر".

دلالات الأرقام يمكنك أن تجدها في الـEnum

Gecko.NodeType

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(TableNode.NodeType.ToString)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(TableNode.NodeType.ToString());

7- ParentNode

تعيد GeckoNode هو "أب" الـNode الحالي.

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim TableParentNode As GeckoNode = TableNode.ParentNode MsgBox(TableParentNode.NodeName)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); GeckoNode TableParentNode = TableNode.ParentNode; MessageBox.Show(TableNode.NodeName.ToString()); <br>

8- OwnerDocument

تعيد الـDocument التي تحتوي على الـNode.

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim OwnerDocument As GeckoDocument = TableNode.OwnerDocument MsgBox("Owner Document URi = " & OwnerDocument.Uri)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); GeckoDocument OwnerDocument = TableNode.OwnerDocument; MessageBox.Show("Owner Document URi = " + OwnerDocument.Uri);

9- TextContent

تعيد النص الخاص بالعنصر.

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(TableNode.TextContent)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(TableNode.TextContent);

10- Prefix

تعيد "البادئة(Prefix)" الخاصة بالـNode.

إن لم يكن للـNode بادئة(Prefix) ستعيد Null (لا شيء).

====>أهم الدوال<====

1- AppendChild

تقوم بإضافة Node إلى قائمة ChildNodes الخاصة بالـNode المحدد.

VB.Net

Dim TableBodyNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")(0) Dim Row As GeckoElement = TableBodyNode.OwnerDocument.CreateElement("tr") Dim Cell = TableBodyNode.OwnerDocument.CreateElement("td") Cell.TextContent = "New Row" Row.AppendChild(Cell) TableBodyNode.AppendChild(Row)

C Sharp

GeckoNode TableBodyNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; GeckoNode Row = TableBodyNode.OwnerDocument.CreateElement("tr"); GeckoNode Cell = Row.OwnerDocument.CreateElement("td"); Cell.TextContent = "New Row"; Row.AppendChild(Cell); TableBodyNode.AppendChild(Row)

2- CloneNode

تستخدم لنسخ الـNode إلى Node جديد.
عند إستخدام هذه الدالة فإنها تقوم بنسخ الـID وجميع الخصائص.

المعاملات(Parameters):
Deep: تحدد إذا ما كنت تريد نسخ الـNdoes الموجودة داخل الـNode (قيمة الخاصية ChildNodes).

VB.Net

Dim TableNode As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim NewTableWithOutCells As GeckoNode = TableNode.CloneNode(False) Dim Body As GeckoNode = NewTableWithOutCells.OwnerDocument.CreateElement("tbody") Dim Row As GeckoNode = NewTableWithOutCells.OwnerDocument.CreateElement("tr") Dim FCell As GeckoNode = NewTableWithOutCells.OwnerDocument.CreateElement("td") FCell.TextContent = "First Cell in the New table :)" Row.AppendChild(FCell) Body.AppendChild(Row) NewTableWithOutCells.AppendChild(Body) TableNode.OwnerDocument.Body.AppendChild(NewTableWithOutCells)

C Sharp

GeckoNode TableNode = NameOfYourWebBrowser.Document.GetElementById("Testtable"); GeckoNode NewTableWithOutCells = TableNode.CloneNode(false); GeckoNode Body = NewTableWithOutCells.OwnerDocument.CreateElement("tbody"); GeckoNode Row = NewTableWithOutCells.OwnerDocument.CreateElement("tr"); GeckoNode FCell = NewTableWithOutCells.OwnerDocument.CreateElement("td"); FCell.TextContent = "First Cell in the New table :)"; Row.AppendChild(FCell); Body.AppendChild(Row); NewTableWithOutCells.AppendChild(Body); TableNode.OwnerDocument.Body.AppendChild(NewTableWithOutCells);

3- EvaluateXPath

تستخدم لتنفيذ التعبيرات(expressions) من نوع

XPath (XML Path Language).

VB.Net

Dim Table As GeckoNode = Nothing Table = NameOfYourWebBrowser.Document.EvaluateXPath("//*[@id='Testtable']").GetNodes(0)

C Sharp

GeckoNode Table = null; System.Collections.Generic.IEnumerator<geckonode> ER = NameOfYourWebBrowser.Document.EvaluateXPath("//*[@id='Testtable']").GetNodes().GetEnumerator() as System.Collections.Generic.IEnumerator<geckonode>; ER.MoveNext(); Table = ER.Current;

4- InsertBefore

تضيف Node قبل الـNode المحدد(في المعامل الثاني).

المعاملات(Parameters):

NewElement: العنصر الجديد.

ReferenceElement: الـعنصر الذي تريد إضافة عنصر قبله ☻.

VB.Net

GeckoNode TableBody = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; GeckoNode NewRow = TableBody.OwnerDocument.CreateElement("tr"); GeckoNode NCell = TableBody.OwnerDocument.CreateElement("td"); GeckoNode LatestRow = TableBody.ChildNodes(TableBody.ChildNodes.Count - 2); NCell.TextContent = "New Row Inserted before the latest one"; NewRow.AppendChild(NCell); TableBody.InsertBefore(NewRow, LatestRow);

C Sharp

5- RemoveChild

تزيل الـNode المحدد(في المعامل الثاني) من قائمة ChildNodes.

تعيد الـNode التي تمت إزالتها.

المعاملات(Parameters):

Child: الـNode التي تريد إزالته.

VB.Net

Dim TableBody As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")(0) Dim LatestRow As GeckoNode = TableBody.ChildNodes(TableBody.ChildNodes.Count - 2) TableBody.RemoveChild(LatestRow)

C Sharp

GeckoNode TableBody = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; GeckoNode LatestRow = TableBody.ChildNodes[TableBody.ChildNodes.Length - 2]; TableBody.RemoveChild(LatestRow);

6- ReplaceChild

تستبدل الـNode المحدد(في المعامل الثاني) من قائمة ChildNodes بالـNode الجديد(في المعامل الأول).

المعاملات(Parameters):

NewChild: العنصر الجديد.

OldChild: العنصر الذي تريد إستبداله.

VB.Net

Dim TableBody As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")(0) Dim NewRow As GeckoNode = TableBody.OwnerDocument.CreateElement("tr") Dim NCell As GeckoNode = NewRow.OwnerDocument.CreateElement("td") NCell.TextContent = "New Row" NewRow.AppendChild(NCell) TableBody.ReplaceChild(NewRow, TableBody.ChildNodes(TableBody.ChildNodes.Count - 2))

C Sharp

GeckoNode TableBody = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; GeckoNode NewRow = TableBody.OwnerDocument.CreateElement("tr"); GeckoNode NCell = NewRow.OwnerDocument.CreateElement("td"); NCell.TextContent = "New Row"; NewRow.AppendChild(NCell); TableBody.ReplaceChild(NewRow, TableBody.ChildNodes[TableBody.ChildNodes.Length - 2]);

7- FindFirstChildInTree

تقوم بتنفيذ شرط على العناصر في قائمة ChildNodes إذا تحقق الشرط تعيد العنصر الذي تحقق عليه الشرط.

المعاملات(Parameters):

الشرط ☻: دالة تعيد Boolean لتنفيذها على العناصر لمعرفة إذا ما كان العنصر يحقق الشرط.

VB.Net

Dim TableBody As GeckoNode = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")(0) Dim ELe As GeckoNode = TableBody.FindFirstChildInTree(Of GeckoNode)(Function(Son As GeckoNode) Son.TextContent.ToLower.Contains("programmer"))

C Sharp

GeckoNode TableBody = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; GeckoNode ELe = TableBody.FindFirstChildInTree<geckonode>((GeckoNode Son) => Son.TextContent.ToLower().Contains("programmer"));

========================================================

أداة لتقوم بتجربة الأكواد

المبرمج العربي	المبرمج العربي	شرح أهم خصائص ودوال HtmlElement	المبرمج	العربي
المبرمج العربي	The Arabian Programmer	HtmlElement most Important properties and Functions	The Arabian	Programmer

=========================================================

وفي الدروس القادمة سنتعرف إن شاء الله عن أهم دوال وخصائص الفصيلة(Class)
GeckoElement التي لم تذكر في هذا الدرس ☻.

<======================================================>

إن أصبت فمن الله ، وإن اخطئت فمني ومن الشيطان اترككم في امان الله ورعايته

والسلام عليكم ورحمة الله وبركاته

DoneByA

GeckoFX. Gecko . GeckoNode .المتصفح Gecko . كيفية إستخدام المتصفح Gecko