SPContentType.DocumentTemplateUrl - Propriété

Article
05/12/2015

Obtient ou définit l'URL d'un modèle de document du type de contenu.

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public ReadOnly Property DocumentTemplateUrl As String
    Get
'Utilisation
Dim instance As SPContentType
Dim value As String

value = instance.DocumentTemplateUrl

public string DocumentTemplateUrl { get; }

Valeur de propriété

Type : System.String
L'URL du modèle de document. La valeur par défaut est String.Empty.

Remarques

La valeur de cette propriété est une chaîne vide si aucun modèle de document n'existe pour le type de contenu. Sinon, la valeur peut être une URL relative de serveur ou une URL absolue pour le modèle, selon si le modèle de document existe sur en cours ou de site (URL relative de serveur) existe sur un autre site (URL absolue).

Lorsqu'un type de contenu est appliqué à une bibliothèque, le modèle de document du type de contenu est copié dans le dossier formulaires de la bibliothèque. Dans ce cas, la valeur de la propriété DocumentTemplateUrl est toujours une URL relative de serveur.

Exemples

L'exemple suivant est une application console qui obtient une référence à un type de contenu de site et une référence à une copie du même type de contenu qui a été appliqué à une bibliothèque de documents dans le site. L'application imprime alors la valeur des propriétés DocumentTemplate() et DocumentTemplateUrl chaque type de contenu.

Notez que l'exemple de code suppose l'existence d'un type de contenu nommé « Proposition de Test », une bibliothèque de documents nommée « Documents de Test », et un modèle de document a été chargé pour le type de contenu.

Imports System
Imports Microsoft.SharePoint

Module ConsoleApp

    Sub Main()
        Console.WriteLine()

        Dim oSPSite As SPSite = New SPSite("https://localhost")
        Dim oSPWeb As SPWeb = oSPSite.OpenWeb()

        Dim contentTypeName As String = "Test Proposal"
        Dim libraryName As String = "Test Documents"

        ' Get a reference to a site content type.
        Dim siteContentType As SPContentType = oSPWeb.ContentTypes(contentTypeName)
        Console.WriteLine("Site content type")
        Console.WriteLine("Content type: " + siteContentType.Name)
        Console.WriteLine("Document template: " + siteContentType.DocumentTemplate)
        Console.WriteLine("Document template Url: " + siteContentType.DocumentTemplateUrl)
        Console.WriteLine()

        ' Get a reference to the same content type after it is applied to a list.
        Dim list As SPList = oSPWeb.Lists(libraryName)
        Dim listContentType As SPContentType = list.ContentTypes(contentTypeName)
        Console.WriteLine("List content type")
        Console.WriteLine("Content type: " + listContentType.Name)
        Console.WriteLine("Document template: " + listContentType.DocumentTemplate)
        Console.WriteLine("Document template Url: " + listContentType.DocumentTemplateUrl)

        oSPWeb.Dispose()
        oSPSite.Dispose()

        Console.WriteLine()
        Console.Write("Press ENTER to continue...")
        Console.ReadLine()
    End Sub

End Module

using System;
using Microsoft.SharePoint;

namespace Test
{
    class ConsoleApp
    {
        static void Main(string[] args)
        {
            Console.WriteLine();
            SPSite oSPSite = new SPSite("https://localhost");
            SPWeb oSPWeb = oSPSite.OpenWeb();

            string contentTypeName = "Test Proposal";
            string libraryName = "Test Documents";

            // Get a reference to a site content type.
            SPContentType siteContentType = oSPWeb.ContentTypes[contentTypeName];
            Console.WriteLine("Site content type");
            Console.WriteLine("Content type: " + siteContentType.Name);
            Console.WriteLine("Document template: " + siteContentType.DocumentTemplate);
            Console.WriteLine("Document template Url: " + siteContentType.DocumentTemplateUrl);
            Console.WriteLine();

            // Get a reference to the same content type after it is applied to a list.
            SPList list = oSPWeb.Lists[libraryName];
            SPContentType listContentType = list.ContentTypes[contentTypeName];
            Console.WriteLine("List content type");
            Console.WriteLine("Content type: " + listContentType.Name);
            Console.WriteLine("Document template: " + listContentType.DocumentTemplate);
            Console.WriteLine("Document template Url: " + listContentType.DocumentTemplateUrl);

            oSPWeb.Dispose();
            oSPSite.Dispose();

            Console.WriteLine();
            Console.Write("Press ENTER to continue...");
            Console.ReadLine();
        }
    }
}

L'application imprime la sortie suivante sur la console.

Site content type
Content type: Test Proposal
Document template: Test Proposal.dotx
Document template Url: /_cts/Test Proposal/Test Proposal.dotx

List content type
Content type: Test Proposal
Document template: Test Proposal.dotx
Document template Url: /Test Documents/Forms/Test Proposal/Test Proposal.dotx

Press ENTER to continue...