Como: Executar um comando do SharePoint

Se você quiser usar o modelo de objeto do servidor em uma extensão de ferramentas do SharePoint, você deve criar um personalizado comando do SharePoint para chamar a API. Depois de definir o comando e implantá-la com sua extensão de ferramentas do SharePoint, sua extensão pode executar o comando para chamar o modelo de objeto de servidor do SharePoint. Para executar o comando, use um da ExecuteCommand métodos de um ISharePointConnection objeto.

Para obter mais informações sobre a finalidade dos comandos do SharePoint, consulte A chamada para os modelos de objeto do SharePoint.

Para executar um comando do SharePoint

1. Na sua extensão de ferramentas do SharePoint, obter um ISharePointConnection objeto. A maneira como você obtém uma ISharePointConnection objeto depende do tipo de extensão que você está criando:

   • Na extensão do sistema de projeto do SharePoint, use o ISharePointProject.SharePointConnection propriedade.

     Para obter mais informações sobre extensões de sistema do projeto, consulte Estendendo o sistema de projeto do SharePoint.

   • Em uma extensão da sharepoint Connections nó Server Explorer, use o IExplorerNodeContext.SharePointConnection propriedade. Para obter um IExplorerNodeContext de objeto, use o IExplorerNode.Context propriedade.

     Para obter mais informações sobre Server Explorer extensões, consulte Estendendo o nó de conexões do SharePoint no Server Explorer.

   • No código que não faz parte de uma extensão das ferramentas do SharePoint, como, por exemplo, um Assistente de modelo de projeto, use o ISharePointProjectService.SharePointConnection propriedade.

     Para obter mais informações sobre como recuperar o serviço de projeto, consulte Usando o serviço de projeto do SharePoint.

2. Chamar um da ExecuteCommand métodos para a ISharePointConnection objeto. Passe o nome do comando que você deseja executar para o primeiro argumento do ExecuteCommand método. Se o comando possui um parâmetro personalizado, passar o parâmetro para o segundo argumento do ExecuteCommand método.

   Há uma outra ExecuteCommand de sobrecarga para cada assinatura de comando com suporte. A tabela a seguir lista as assinaturas com suporte e qual sobrecarga para cada assinatura.

   Assinatura de comando	Sobrecarga de ExecuteCommand para usar
   O comando tem apenas o padrão ISharePointCommandContext parâmetro e nenhum valor de retorno.	ExecuteCommand(String)
   O comando tem apenas o padrão ISharePointCommandContext parâmetro e um valor de retorno.	ExecuteCommand<TResult>(String)
   O comando tem dois parâmetros (o padrão ISharePointCommandContext parâmetro e um parâmetro personalizado) e nenhum valor de retorno.	ExecuteCommand<T>(String, T)
   O comando tem dois parâmetros e um valor de retorno.	ExecuteCommand<T, TResult>(String, T)

Exemplo

O exemplo de código a seguir demonstra como usar o ExecuteCommand<T>(String, T) sobrecarga para chamar o Contoso.Commands.UpgradeSolution comando que é descrito em Como: Criar um comando do SharePoint.

Private Sub Execute(ByVal context As IDeploymentContext) _
    Implements IDeploymentStep.Execute
    context.Logger.WriteLine("Upgrading solution: " & solutionName, LogCategory.Status)
    context.Project.SharePointConnection.ExecuteCommand("Contoso.Commands.UpgradeSolution", _
        solutionFullPath)
End Sub

public void Execute(IDeploymentContext context)
{
    context.Logger.WriteLine("Upgrading solution: " + solutionName, LogCategory.Status);
    context.Project.SharePointConnection.ExecuteCommand("Contoso.Commands.UpgradeSolution",
        solutionFullPath);
}

O Execute método mostrado neste exemplo é uma implementação da Execute método o IDeploymentStep interface em uma etapa de implantação personalizada. Para ver este código no contexto de um exemplo maior, consulte Demonstra Passo a passo: A criação de uma etapa de implantação personalizado para projetos do SharePoint.

Observe os seguintes detalhes sobre a chamada para o ExecuteCommand<T>(String, T) método:

• O primeiro parâmetro identifica o comando que você deseja chamar. Essa seqüência de caracteres corresponde ao valor que você passa para o SharePointCommandAttribute na definição de comando.

• O segundo parâmetro é o valor que você deseja passar para o segundo parâmetro do comando personalizado. Nesse caso, é o caminho completo do arquivo. wsp que está sendo atualizado para o site do SharePoint.

• O código não passa o implícito ISharePointCommandContext parâmetro para o comando. Este parâmetro é passado para o comando automaticamente quando você chamar o comando a partir de uma extensão do sistema de projeto do SharePoint ou uma extensão do sharepoint Connections nó na Server Explorer. Em outros tipos de soluções, como em um Assistente de modelo de projeto que implementa o Microsoft.VisualStudio.TemplateWizard.IWizard interface, esse parâmetro é null.

Compilando o código

Este exemplo requer uma referência ao assembly Microsoft.VisualStudio.SharePoint.

Consulte também

Tarefas

Demonstra Passo a passo: Estendendo o Server Explorer para exibir Web Parts

Conceitos

A chamada para os modelos de objeto do SharePoint

Outros recursos

Como: Criar um comando do SharePoint