Partager via


SPWeb.ApplyWebTemplate - Méthode (SPWebTemplate)

Applique l'objet de définition de site spécifié ou l'objet de modèle de site au site Web qui ne possède aucun modèle qui lui est appliqué.

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

Syntaxe

'Déclaration
Public Sub ApplyWebTemplate ( _
    webTemplate As SPWebTemplate _
)
'Utilisation
Dim instance As SPWeb
Dim webTemplate As SPWebTemplate

instance.ApplyWebTemplate(webTemplate)
public void ApplyWebTemplate(
    SPWebTemplate webTemplate
)

Paramètres

Exceptions

Exception Condition
ArgumentNullException

webTemplate est null .

Remarques

Cette méthode appelle la méthode ApplyWebTemplate(String) avec la propriété Name du paramètre webTemplate .

Avertissement

Soyez prudent sur l'appel de cette méthode dans une fonction de rappel mise en service de site Web. Si vous appelez cette méthode à l'intérieur d'une fonction de rappel de mise en service qui est définie dans la même configuration de définition de site est appliquée, vous pouvez provoquer une boucle infinie. À la place, créez deux configurations de définition de site similaires au sein de la définition du site, qui est visible et l'autre est masquée. La configuration peut contenir une fonction de rappel assembly approvisionnement auxquels s'applique la configuration masquée à des sites Web.

Exemples

L'exemple de code suivant s'applique à un objet de modèle de site spécifié à un sous-site Web dans la collection de sites actuelle.

Dim siteCollection As SPSite = SPContext.Current.Site
Using webSite As SPWeb = siteCollection.OpenWeb("Website_URL")
    Dim webTemplates As SPWebTemplateCollection = 
        siteCollection.GetCustomWebTemplates(Locale_ID)
    Dim webTemplate As SPWebTemplate = webTemplates("Template_Name")
    webSite.ApplyWebTemplate(webTemplate)
End Using
SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSiteCollection.OpenWeb("Website_URL"))
{
    SPWebTemplateCollection collWebTemplates = oSiteCollection.GetCustomWebTemplates(Locale_ID);
    SPWebTemplate oWebTemplate = collWebTemplates["Template_Name"];

    oWebsite.ApplyWebTemplate(oWebTemplate);
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPWeb classe

SPWeb - Membres

ApplyWebTemplate - Surcharge

Microsoft.SharePoint - Espace de noms