Share via

Usando o modelo de objeto para atualização

  • Artigo

Modelo de objeto do espaço para nome Microsoft.SharePoint.Upgrade fornece um meio para definir atualizar ações para um aplicativo compilado após a plataforma Microsoft Windows SharePoint Services ao atualizar para o próximo versão ou compilar de SharePoint. Você define uma seqüência de ações para executar vários tarefas específicas em um consistente maneira exigido por um aplicativo para atualizar para uma nova versão ou compilar de Windows SharePoint Services.

Atualizar classes

O SPAction classe T:Microsoft.SharePoint.Upgrade.SPAction é a classe base a partir da qual derivam personalizado classes projetadas para necessidades específicas em um atualizar. Você pode criar classes que herdam SPAction, ou usar o SPDatabaseAction T:Microsoft.SharePoint.Upgrade.SPDatabaseAction classe na maiúsculas e minúsculas específica de definir ações para atualizar os bancos de dados. Substituir o método Upgrade T:Microsoft.SharePoint.Upgrade.SPAction.Upgrade para atualizar executar lógica.

The SPSequence class is the ultimate base class for the other sequence classes in the Microsoft.SharePoint.Upgrade namespace, which includes SPActionSequence, from which derives SPDatabaseSequence, SPIisWebSiteSequence, SPPersistedObjectSequence, and SPSiteSequence. Modelo de objeto também fornece recursos como a SPManager e SPMigrator classes para atualizar acessar propriedades e instalações migrar. Use o SPUpgradeException T:Microsoft.SharePoint.Upgrade.SPUpgradeException classe para interceptar exceções específicas para Windows SharePoint Services.

Uma prática recomendada é criar uma classe super que deriva de uma classe ação ou seqüência do espaço para nome Microsoft.SharePoint.Upgrade e criar outras classes que derivar de sua classe super para atualizar específico executar ações. Um personalizado atualizar aplicativo pode precisar, de exemplo, ações para atualizar um farm servidor, bem como ações que atualizar Sites Serviços de Informações da Internet (IIS), bancos de dados, coleções site do SharePoint, aplicativos da Web e servidores.

Um atualizar classe seqüência tem atribuição que especifica a tipo base de atualizar ação para carregar e executar. Cada atualizar ação possui uma marca atributo versão semelhante a seguinte que ajuda a identificar se um determinado atualizar ação precisa executar ou não, por comparando o atual versão do recurso que está sendo atualizado com a versão destino da atualizar ação. A marca atributo versão também é usada na classificação de individual atualizar ações.

                    [TargetSchemaVersion("12.0.1.0")]
[ActionBaseType(typeof(MyWebAppAction))]
[TargetUpgradableObject(typeof(SPWebApplication))]

O atributo TargetSchemaVersion TargetSchemaVersion da seqüência deve coincidir com o atributo TargetSchemaVersion TargetSchemaVersion de ação de atualização mais recente no módulo de ação.

Arquivos de configuração

Depois de criar classes que derivar de classes do espaço para nome Microsoft.SharePoint.Upgrade N:Microsoft.SharePoint.Upgrade, você pode registrar o assembly, criando um arquivo de configuração no Local_Drive :\Program Files\Common Files\Microsoft Shared\web server extensions\12\Config\Upgrade extensions\12\Config\Upgrade servidor \Program Files\Common Files\Microsoft Shared\web. Um arquivo de configuração é um arquivo XML que indica os nomes de todos os plug-ins DLL e classe. Esses arquivos são usados ao executar-tempo para criar instância de classes corretas e executá-los usando reflexão.

Um arquivo de configuração se parece com o seguinte:

                    <?xml version='1.0'?>
<Config xmlns="urn:Microsoft.SharePoint.Upgrade">
  <Assembly name="Microsoft.Office.Server, Version=12.0.0.0, Culture=neutral, PublicKeyToken=94de0004b6e3fcc5, Custom=null">     <Order>3</Order>
  </Assembly>
</Config>

O atributo Name nome no Assembly Conjunto de Módulos (Assembly) marca indica o nome de um assembly que contém a atualizar seqüência para um determinado recurso atualizável. O nó Order ordem indica a ordem dessa seqüência with respect to a atualizar seqüência de outro recurso do mesmo tipo. Para atualizar um Windows SharePoint Services exemplo, seqüência tem uma ordem 1 e é executado antes de quaisquer outro atualizar seqüência.