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
webTemplate
Type : Microsoft.SharePoint.SPWebTemplateLa définition de site ou d'un modèle de site à appliquer.
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.