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.XML büyük küçük harfe duyarlı olduğundan, öğenin yazım belirtilen Name parametresi, şemada göründüğü gibi olmalıdır.Herhangi bir öğe adları belirtilen şemada 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üğü gibi yazılmalıdır.Belirtilen ad, herhangi bir belgeye ekli şemaların bulunamazsa, bir hata görüntülenir.
  • Range
    Tür: System.Object%
    Öğe uygulamak istediğiniz aralığı.Bir metin seçiliyse, öğe etiketleri ekleme noktasına veya seçimin çevresine yerleştirmek için varsayılandır.

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.Örnek ayrıca kullanır Add için yeni bir öğe eklemek için yöntem bir XMLNodes koleksiyonu belirtilen aralıkta 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ı