XMLNodes.Add(String, String, Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
XMLNode Získá objekt, který představuje nově přidaný prvek.
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
Parametry
- Name
- String
Název elementu ve schématu XML určeném v parametru Namespace
. Vzhledem k tomu, že xml rozlišuje malá a velká písmena, musí být pravopis elementu zadaného v parametru Name
přesně tak, jak se zobrazuje ve schématu. Pokud neodpovídá žádnému názvu elementu ve schématu zadaném v parametru Namespace
, zobrazí se chyba.
- Namespace
- String
Název schématu definovaný ve schématu. V parametru se Namespace
rozlišují malá a velká písmena a musí být napsaný přesně tak, jak se zobrazuje ve schématu. Pokud zadaný obor názvů nelze najít v žádném ze schémat připojených k dokumentu, zobrazí se chyba.
- Range
- Object
Oblast, na kterou chcete použít prvek. Pokud je vybraný text, ve výchozím nastavení se značky elementů umístí na pozici kurzoru nebo kolem výběru.
Návraty
Objekt XMLNode , který představuje nově přidaný prvek.
Příklady
Následující příklad kódu ukazuje obslužné rutiny událostí pro AfterInsert události a BeforeDelete . Kód zobrazí okno se zprávou před odstraněním Microsoft.Office.Interop.Word.XMLNode položky z dokumentu a po Microsoft.Office.Interop.Word.XMLNode přidání souboru do dokumentu. Příklad také používá metodu Add k přidání nového prvku do XMLNodes kolekce v zadaném rozsahu a programové vyvolání AfterInsert události. Tento příklad předpokládá, že aktuální dokument obsahuje kolekci XMLNodes s názvem SampleInsertNodes
, která má nadřazený objekt XMLNode s názvem SampleNode
.
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
Poznámky
Volitelné parametry
Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro systém Office.