XMLNodes.Add(String, String, Object) Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Word

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Word.dll

Yeni eklenen bir XMLNode öğeyi temsil eden bir nesnesi alır.

public Microsoft.Office.Interop.Word.XMLNode Add (string Name, string Namespace, ref object Range);

abstract member Add : string * string * obj -> Microsoft.Office.Interop.Word.XMLNode

Public Function Add (Name As String, Namespace As String, Optional ByRef Range As Object) As XMLNode

Parametreler

Name

String

PARAMETRESInde belirlenen Namespace XML şemasındaki öğenin adı. XML büyük/küçük harfe duyarlı olduğundan, parametresinde Name belirtilen öğenin yazım denetimi şemada göründüğü gibi olmalıdır. Parametresinde belirtilen Namespace şemadaki öğe adlarından herhangi biriyle eşleşmiyorsa bir hata görüntülenir.

Namespace

String

Şemada tanımlandığı gibi şemanın adı. Namespace parametresi büyük/küçük harfe duyarlıdır ve tam olarak şemada göründüğü gibi yazılmalıdır. Belirtilen ad alanı belgeye eklenmiş şemaların hiçbirinde bulunamazsa bir hata görüntülenir.

Range

Object

Öğesini uygulamak istediğiniz aralık. Varsayılan değer, öğe etiketlerini ekleme noktasına veya bir metin seçiliyse seçimin çevresine yerleştirmektir.

Döndürülenler

XMLNode

XMLNode Yeni eklenen bir öğeyi temsil eden nesne.

Örnekler

Aşağıdaki kod örneği ve BeforeDelete olayları için AfterInsert olay işleyicilerini gösterir. Kod, belgeden silinmeden önce Microsoft.Office.Interop.Word.XMLNode ve belgeye eklendikten sonra bir Microsoft.Office.Interop.Word.XMLNode ileti kutusu görüntüler. Örnekte ayrıca belirtilen aralıktaki Add bir XMLNodes koleksiyona yeni bir öğe eklemek ve olayı program aracılığıyla yükseltmek AfterInsert için yöntemi kullanılır. Bu örnekte, geçerli belgenin adlı üst SampleNodeXMLNode öğeye SampleInsertNodessahip adlı bir XMLNodes koleksiyon içerdiği varsayılır.

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.");
    }
}

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

Açıklamalar

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümleri'nde İsteğe Bağlı Parametreler.