XMLNodes.Add – metoda
Získá Microsoft.Office.Interop.Word.XMLNode objekt, který představuje nově přidaný prvek.
Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)
Syntaxe
'Deklarace
Function Add ( _
Name As String, _
Namespace As String, _
ByRef Range As Object _
) As XMLNode
XMLNode Add(
string Name,
string Namespace,
ref Object Range
)
Parametry
- Name
Typ: System.String
Název prvku ve schématu XML určený v Namespace parametr.Protože kódu XML rozlišována malá a velká písmena, podle pravopisu prvku Name parametr musí být úplně stejně jako ve schématu.Pokud neodpovídá žádné názvy prvků ve schématu zadané v Namespace se zobrazí parametr chybu.
- Namespace
Typ: System.String
Název schématu, jak jsou definovány ve schématu. Namespace Parametr je velká a malá písmena a musí být zadán přesně tak, jak bude vypadat ve schématu.Zadaný obor názvů nebyl nalezen v žádném schémata připojené k dokumentu, zobrazí se chyba.
- Range
Typ: System.Object%
Oblast, do které chcete použít prvek.Ve výchozím nastavení je umístit tagů elementů v místě kurzoru nebo ve výběru, pokud je vybrán text.
Vrácená hodnota
Typ: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode objekt, který představuje nově přidaný prvek.
Poznámky
Volitelné parametry
Informace o nepovinných parametrů naleznete v tématu Volitelné parametry v řešeních pro systém Office.
Příklady
Následující příklad kódu ukazuje obslužné rutiny AfterInsert a BeforeDelete události.Kód zobrazí okno se zprávou před Microsoft.Office.Interop.Word.XMLNode je odstraněn z dokumentu a po Microsoft.Office.Interop.Word.XMLNode je přidán do dokumentu.V příkladu se používá také Add metodu pro přidání nového prvku XMLNodes kolekce na zadaný rozsah a programově zvýšit AfterInsert události.Tento příklad předpokládá, že obsahuje aktuální dokument XMLNodes kolekci s názvem SampleInsertNodes, který má nadřazený XMLNode s názvem 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.");
}
}
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.