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

Makale
02/26/2013

Belge düzeyi özelleştirmelerinde özel xml bölümü oluşturarak, bir Microsoft Office Excel çalışma kitabı veya Microsoft Office Word belgesine xml veri depolayabilir.Daha fazla bilgi için bkz. Özel XML Bölümlerine Genel Bakış.

Uygulama alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine yöneliktir: Excel 2013 ve Excel 2010; Word 2013 ve Word 2010. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

[!NOT]

Visual Studio, Microsoft Office PowerPoint için belge düzeyi projeleri sağlamaz.Uygulama düzeyi eklentisi kullanarak PowerPoint sunusunu özel xml bölümleri ekleme hakkında daha fazla bilgi için bkz: Nasıl yapılır: uygulama düzeyinde eklentileri kullanarak özel xml bölümleri belgelere ekleme.

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.

Private Sub AddCustomXmlPartToWorkbook()
    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 = Me.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToWorkbook()
{
    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 = this.CustomXMLParts.Add(xmlString, missing);
}

Ekleme AddCustomXmlPartToWorkbook yöntemine ThisWorkbook sınıf Excel için belge düzeyi projesi içinde.
Projenizdeki başka koddan yöntemi çağırın.Örneğin, kullanıcı çalışma kitabını açtığında özel xml bölümü oluşturmak için çağırın ThisWorkbook_Startup olay işleyicisi.

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.

Private Sub AddCustomXmlPartToDocument()
    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 = _
        Me.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToDocument()
{
    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 = this.CustomXMLParts.Add(xmlString, missing);
}

Ekleme AddCustomXmlPartToDocument yöntemine ThisDocument sınıf Word için belge düzeyi projesi içinde.
Projenizdeki başka koddan yöntemi çağırın.Örneğin, kullanıcı belgeyi açtığında özel xml bölümü oluşturmak için çağırın ThisDocument_Startup olay işleyicisi.

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: uygulama düzeyinde eklentileri kullanarak özel xml bölümleri belgelere ekleme

Kavramlar

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

Aracılığıyla paylaş