XMLNodes.Add أسلوب

يحصل Microsoft.Office.Interop.Word.XMLNodeكائن الذي يمثل العنصر المضاف حديثا.

مساحة الاسم:  Microsoft.Office.Tools.Word
التجميع:  Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

XMLNode Add(
    string Name,
    string Namespace,
    ref Object Range
)

المعلمات

• Name
  النوع: System.String
  الاسم عنصر في مخطط XML المعين في Namespaceمعلمة.ونظرا لأن XML تحسس حالة الأحرف، كتابة العنصر المحدد في Nameيجب أن تكون معلمة تماما كما يظهر في المخطط.في حالة عدم مطابقته أي من أسماء العناصر في المخطط المحدد في Namespaceالمعلمة، خطأ هو dهوplayed.

• Namespace
  النوع: System.String
  اسم المخطط كـ المعرفة في المخطط. Namespaceمعلمة هو حساسة لحالة الأحرف يجب أن يكون الحقل مكتوبة تماما كما يظهر في المخطط.إذا تعذر العثور على مساحة الاسم المحددة في أي من رسوم تخطيطية المرفق بالمستند، خطأ هو dهوplayed.

• Range
  النوع: System.Object%
  النطاق إلى الذي تريده إلى تطبيق العنصر.الإعداد الافتراضي هو لوضع علامات العناصر عند يؤشر الإدراج أو حول تحديد إذا كان نص هو المحدد.

القيمة المُرجعة

النوع: Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Interop.Word.XMLNodeالكائن الذي يمثل حديثا تمت الإضافة العنصر.

ملاحظات

المعلمات الإختيارية

ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.

أمثلة

يلي تعليمات برمجية يوضح المثال معالجات الأحداث ل AfterInsertو BeforeDeleteالأحداث. dهوplays رمز صندوق رسالة قبل Microsoft.Office.Interop.Word.XMLNodeهو حذفها من مستند وبعد Microsoft.Office.Interop.Word.XMLNodeهو قم بإضافتها إلى مستند. يستخدم المثال أيضا Addطريقة لإضافة عنصر جديد إلى XMLNodesمجموعة في نطاق معين و رفع برمجياً AfterInsertحدث. يفترض هذا المثال أن يحتوي أن مستند الحالي على XMLNodesمجموعة باسم SampleInsertNodes، الذي يحتوي على أصل XMLNodeباسم SampleNode.

Private Sub XMLNodeAddAndDelete()
    Dim range1 As Object = Me.SampleInsertNodes(1).Range

    ' This will raise the AfterInsert event.
    Dim node1 As Word.XMLNode = _
        Me.SampleInsertNodes.Add("MemoFrom", _
        Me.SampleNode.NamespaceURI, range1)
End Sub

Private Sub SampleInsertNodes_AfterInsert(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs)


    If e.InUndoRedo Then
        MessageBox.Show("A child element of SampleInsertNodes was " & _
            "inserted as a result of an undo or redo operation.")
    Else
        MessageBox.Show("A child element of SampleInsertNodes " & _
            "was inserted.")
    End If
End Sub

Private Sub SampleInsertNodes_BeforeDelete(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs)


    If e.InUndoRedo Then
        MessageBox.Show("A child element of SampleInsertNodes " & _
            "is about to be deleted as a result of an undo or " & _
            "redo operation.")
    Else
        MessageBox.Show("A child element of SampleInsertNodes " & _
        "is about to be deleted.")
    End If
End Sub

private void XMLNodeAddAndDelete()
{
    object range1 = this.SampleInsertNodes[1].Range;

    this.SampleInsertNodes.AfterInsert +=
        new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
        SampleInsertNodes_AfterInsert);

    this.SampleInsertNodes.BeforeDelete +=
        new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
        SampleInsertNodes_BeforeDelete);

    // This will raise the AfterInsert event.
    Word.XMLNode node1 = this.SampleInsertNodes.Add("MemoFrom",
        this.SampleNode.NamespaceURI, ref range1);
}

void SampleInsertNodes_AfterInsert(object sender,
    Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
    if (e.InUndoRedo)
    {
        MessageBox.Show("A child element of SampleInsertNodes was " +
            "inserted as a result of an undo or redo operation.");
    }
    else
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "was inserted.");
    }
}

void SampleInsertNodes_BeforeDelete(object sender,
    Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
    if (e.InUndoRedo)
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "is about to be deleted as a result of an undo or " +
            "redo operation.");
    }
    else
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "is about to be deleted.");
    }
}

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

XMLNodes واجهة

XMLNodes الأعضاء

Microsoft.Office.Tools.Word مساحة الاسم