Propriedade ServerDocument.DeploymentManifestUrl

Artigo
08/01/2011

Obtém ou define o URL de manifesto de implantação para a personalização que está associado ao documento.

Namespace: Microsoft.VisualStudio.Tools.Applications
Assembly: Microsoft.VisualStudio.Tools.Applications.ServerDocument (em Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Sintaxe

'Declaração
Public Property DeploymentManifestUrl As Uri
    Get
    Set

public Uri DeploymentManifestUrl { get; set; }

Valor de propriedade

Tipo: System.Uri
Uma URL que especifica o nome e o local do manifesto de implantação para a personalização que está associado ao documento.

Comentários

Defina essa propriedade para um novo URL, se você move o manifesto de implantação para uma personalização para um local diferente e você deseja que o documento para localizar atualizações de personalização da nova localização. Se você definir essa propriedade, a URL deve apontar para um manifesto de implantação para a personalização que já está associado ao documento.

Você não pode usar essa propriedade para associar uma nova personalização de um documento. Para adicionar uma personalização para um documento não-personalizado, use o AddCustomization método. Para adicionar uma personalização diferente para um documento personalizado, primeiro use o RemoveCustomization método para remover a personalização atual e, em seguida, use o AddCustomization método.

Obtendo o URL em aplicativos que visam o.NET Framework 3.5

Quando você usa o ServerDocument a classe no assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll em um aplicativo que se destina a.NET Framework 3.5, o DeploymentManifestUrl propriedade retorna a URL de manifesto de implantação atual somente se a personalização de nível de documentação é instalada no computador onde você está executando o aplicativo. Caso contrário, essa propriedade retornará nulluma referência nula (Nothing no Visual Basic).

Se você precisar obter o URL de manifesto de implantação de uma personalização em nível de documento que não está instalado no computador onde você está executando o aplicativo (por exemplo, em um servidor onde uma personalização em nível de documento é publicada), direcione o.NET Framework 4 no aplicativo, faça referência ao conjunto de Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e use o ServerDocument classe no assembly.

Exemplos

O seguinte exemplo de código usa o ServerDocument(String) o construtor para criar um novo ServerDocument que carrega o documento especificado. O exemplo, em seguida, exibe a URL do manifesto de implantação para a personalização que é anexado ao documento.

This example requires:

Um projeto de aplicativo de console ou algum outro projeto de não-Office.
Referências aos assemblies seguintes:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.dll (se os destinos do projeto de .NET Framework 4).
  
  or
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (se os destinos do projeto a.NET Framework 3.5).
Imports(para Visual Basic) ou using (para C#) instruções para Microsoft.VisualStudio.Tools.Applications e Microsoft.VisualStudio.Tools.Applications.Runtime namespaces no topo do seu arquivo de código.

Private Sub CreateServerDocumentFromPath(ByVal documentPath As String)
    Dim runtimeVersion As Integer = 0
    Dim serverDocument1 As ServerDocument = Nothing

    Try
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
        If runtimeVersion = 3 Then
            serverDocument1 = New ServerDocument(documentPath)
            MessageBox.Show("The URL of the deployment manifest is: " & vbLf & _
                serverDocument1.DeploymentManifestUrl.ToString())
        End If

    Catch ex As System.IO.FileNotFoundException
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
    Catch ex As UnknownCustomizationFileException
        System.Windows.Forms.MessageBox.Show("The specified document has a file " & _
            "extension that is not supported by Visual Studio Tools for Office.")
    Finally
        If Not (serverDocument1 Is Nothing) Then
            serverDocument1.Close()
        End If
    End Try
End Sub

private void CreateServerDocumentFromPath(string documentPath)
{
    int runtimeVersion = 0;
    ServerDocument serverDocument1 = null;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
        if (runtimeVersion == 3)
        {
            serverDocument1 = new ServerDocument(documentPath);
            MessageBox.Show("The URL of the deployment manifest is: \n" +
                serverDocument1.DeploymentManifestUrl.ToString());
        }
    }
    catch (System.IO.FileNotFoundException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
    }
    catch (UnknownCustomizationFileException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document has a file " +
            "extension that is not supported by Visual Studio Tools for Office.");
    }
    finally
    {
        if (serverDocument1 != null)
            serverDocument1.Close();
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ServerDocument Classe

Namespace Microsoft.VisualStudio.Tools.Applications

Partilhar via