Aracılığıyla paylaş

XMLNodes.Add Yöntem

  • Makale

Alır bir Microsoft.Office.Interop.Word.XMLNode , yeni eklenen bir öğeyi temsil eden nesne.

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 şemada göründüğü şekliyle parametresi olmalıdır.Öğe adları belirtilen şema hiçbirini eşleşmezse, Namespace parametresi, bir hata görüntülenir.
  • Namespace
    Tür: System.String
    Şemada tanımlanan şema adı. Namespace Parametresi duyarlıdır ve şemada göründüğü şekilde yazılmalıdır.Herhangi bir belgeye ekli şemaların 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çimin çevresine yerleştirmektir.

Dönüş Değeri

Tür: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode , yeni eklenen bir öğeyi temsil eden nesne.

Notlar

İ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 belgeye eklenir.Bu örnek de kullanır Add yöntemi yeni bir öğe eklemek için bir XMLNodes koleksiyonu belirtilen aralık ve programlı olarak yükseltmek AfterInsert olay.Bu örnek, geçerli belge içerdiğini varsayar bir XMLNodes adlı koleksiyon 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ı