XMLNodes.Add(String, String, Object) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 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 SampleNode
XMLNode öğeye SampleInsertNodes
sahip 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.