Share via


SPWeb.ApplyWebTemplate method (SPWebTemplate)

Aplica-se o objeto de definição do site especificado ou site modelo para o site que não tem nenhum modelo aplicado a ele.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Sub ApplyWebTemplate ( _
    webTemplate As SPWebTemplate _
)
'Uso
Dim instance As SPWeb
Dim webTemplate As SPWebTemplate

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

Parâmetros

Exceptions

Exception Condition
ArgumentNullException

webTemplate é null .

Comentários

Este método chama o método ApplyWebTemplate(String) com a propriedade Name do parâmetro webTemplate .

Aviso

Tenha cuidado ao chamar este método dentro de uma função de retorno de chamada de provisionamento de site. Se você chamar esse método dentro de uma função de retorno de chamada de provisionamento que é definido na mesma configuração de definição de site que está sendo aplicada, você poderá causar um loop infinito. Em vez disso, crie duas configurações de definição de site semelhante na definição do site, que está visível e que está oculto. A configuração, em seguida, pode conter uma função de retorno de chamada provisionamento assembly que se aplica a configuração oculta em sites.

Examples

O exemplo de código a seguir se aplica a um objeto de modelo do site especificado para um subsite no conjunto de sites atual.

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);
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPWeb class

SPWeb members

ApplyWebTemplate overload

Microsoft.SharePoint namespace