Nasıl yapılır: uygulama düzeyinde eklentileri kullanarak özel xml bölümleri belgelere ekleme

Makale
02/26/2013

Belge düzeyi eklentilerinde özel XML kısmı oluşturarak, XML verilerini aşağıdaki belge türlerinde saklayabilirsiniz.

Microsoft Office Excel çalışma kitabı.
Microsoft Office Word belgesi.
Microsoft Office PowerPoint sunusu.

Daha fazla bilgi için bkz. Özel XML Bölümlerine Genel Bakış.

İçin geçerlidir: bu konudaki bilgiler, uygulama düzeyinde projeleri aşağıdaki uygulamalar için geçerlidir: Excel 2010; PowerPoint 2010; Word'ün 2010.Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Excel çalışma kitabına özelleşmiş bir XML bölümü eklemek için

Çalışma kitabında CustomXMLParts koleksiyonuna CustomXMLPart nesnesini ekleyin.CustomXMLPart, çalışma kitabında saklamak istediğiniz XML dizesini içerir.

Aşağıdaki kod örneğinde özel XML bölümleri, belirli bir çalışma kitabına eklenir.

Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
    Dim xmlString As String = _
        "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
            "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                "<employee>" & _
                    "<name>Karina Leal</name>" & _
                    "<hireDate>1999-04-01</hireDate>" & _
                    "<title>Manager</title>" & _
                "</employee>" & _
            "</employees>"

    Dim employeeXMLPart As Office.CustomXMLPart = _
        workbook.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook)
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = workbook.CustomXMLParts.Add(xmlString, missing);
}

Excel için uygulama düzeyi projesindeki ThisAddIn sınıfına AddCustomXmlPartToWorkbook yöntemini ekleyin.
Projenizdeki başka koddan yöntemi çağırın.Örneğin, kullanıcı çalışma kitabı açtığında özel XML bölümü oluşturmak amacıyla, WorkbookOpen olayı için bir olay işleyicisinden yöntemi çağırın.

Word belgesine özel XML bölümü eklemek için

Belgedeki CustomXMLParts koleksiyonuna CustomXMLPart nesnesini ekleyin.CustomXMLPart, belgede saklamak istediğiniz XML dizesini içerir.

Aşağıdaki kod örneğinde özel XML bölümleri, belirli bir belgeye eklenir.

Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
    Dim xmlString As String = _
        "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
            "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                "<employee>" & _
                    "<name>Karina Leal</name>" & _
                    "<hireDate>1999-04-01</hireDate>" & _
                    "<title>Manager</title>" & _
                "</employee>" & _
            "</employees>"

    Dim employeeXMLPart As Office.CustomXMLPart = _
        document.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToActiveDocument(Word.Document document)
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = document.CustomXMLParts.Add(xmlString, missing);
}

Word için uygulama düzeyi projesindeki ThisAddIn sınıfına AddCustomXmlPartToDocument yöntemini ekleyin.
Projenizdeki başka koddan yöntemi çağırın.Örneğin, kullanıcı belgeyi açtığında özel XML bölümü oluşturmak amacıyla, DocumentOpen olayı için bir olay işleyicisinden yöntemi çağırın.

PowePoint sunusuna, özel XML bölümü eklemek için

Sunudaki CustomXMLParts koleksiyonuna CustomXMLPart nesnesini ekleyin.CustomXMLPart, sunuda saklamak istediğiniz XML dizesini içerir.

Aşağıdaki kod örneğinde özel XML bölümleri, belirli bir sunuya eklenir.

Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
    Dim xmlString As String = _
        "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
            "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                "<employee>" & _
                    "<name>Karina Leal</name>" & _
                    "<hireDate>1999-04-01</hireDate>" & _
                    "<title>Manager</title>" & _
                "</employee>" & _
            "</employees>"
    Dim employeeXMLPart As Office.CustomXMLPart = _
        presentation.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = 
        presentation.CustomXMLParts.Add(xmlString, missing);
}

PowerPoint için uygulama düzeyi projesindeki ThisAddIn sınıfına AddCustomXmlPartToPresentation yöntemini ekleyin.
Projenizdeki başka koddan yöntemi çağırın.Örneğin, kullanıcı sunuyu açtığında özel XML bölümü oluşturmak amacıyla, AfterPresentationOpen olayı için bir olay işleyicisinden yöntemi çağırın.

Güçlü Programlama

Kolaylık sağlamak için, bu örnekte yöntemdeki yerel değişken olarak tanımlanmış bir XML dizesi kullanılır.Genellikle dosya veya veritabanı gibi dış kaynaklardan XML'i elde etmelisiniz.

Ayrıca bkz.

Görevler

Nasıl yapılır: özel xml bölümleri belge düzeyinde özelleştirmeler ekleme

Kavramlar

Özel XML Bölümlerine Genel Bakış

Aracılığıyla paylaş