Aracılığıyla paylaş

XMLNodes.Add Yöntem

  • Makale

Alır bir Microsoft.Office.Interop.Word.XMLNode nesnesini temsil eden yeni eklenen bir öğe.

Ad alanı:  Microsoft.Office.Tools.Word
Derleme:  Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll içinde)

Sözdizimi

'Bildirim
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

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

Parametreler

  • Name
    Tür: System.String
    İçinde belirlenen xml Schema'da öğesinin adı Namespace parametresi.Yazım öğesinin xml büyük küçük harfe duyarlı olduğundan, belirtilen Name parametresi olmalıdır tam olarak göründüğü şema.Öğe adları belirtilen şema biriyle eşleşmezse, Namespace parametresi, bir hata görüntülenir.
  • Namespace
    Tür: System.String
    Şemada tanımlanan şema adı.Namespace Parametresi büyük küçük harf duyarlı ve gerekir yazıldığını tam olarak göründüğü şema.Herhangi bir belgeye ekli şemalar belirtilen ad bulunamazsa, bir hata görüntülenir.
  • Range
    Tür: System.Object%
    Öğe uygulamak istediğiniz aralığı.Varsayılan bir metin seçiliyse öğe etiketlerini ekleme noktasına veya seçim çevresinde yerleştirmektir.

Dönüş Değeri

Tür: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode nesnesini temsil eden yeni eklenen bir öğe.

Açıklamalar

İsteğe bağlı parametreler

İsteğe bağlı parametreler hakkında daha fazla bilgi için bkz: Office Çözümlerinde İsteğe Bağlı Parametreler.

Örnekler

Aşağıdaki kod örneği için olay işleyicilerini gösterir AfterInsert ve BeforeDelete olayları. Kod önce bir ileti kutusu görüntüler bir Microsoft.Office.Interop.Word.XMLNode belgeden ve sonra silinen bir Microsoft.Office.Interop.Word.XMLNode eklenir belge. Örnek de kullanır Add Yeni bir öğe eklemek için yöntem bir XMLNodes koleksiyonu belirtilen ve programlı olarak yükseltmek AfterInsert olay. Bu örnek, geçerli belge içerdiğini varsayar bir XMLNodes collection adlı SampleInsertNodes, sahip olduğu bir üst XMLNode adlı 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 Güvenliği

Ayrıca bkz.

Başvuru

XMLNodes Arabirim

Microsoft.Office.Tools.Word Ad Alanı