Propriedade ServerDocument.DeploymentManifestUrl

Artigo
05/21/2013

Obtém ou define o URL de manifesto de implantação para personalização que está associada com o 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

public Uri DeploymentManifestUrl { get; set; }

Valor de propriedade

Tipo: System.Uri
UM URL que especifica o nome e o local do manifesto de implantação para personalização que está associada com o documento.

Comentários

Defina essa propriedade como um novo URL se você mover 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 do novo local.Se você definir essa propriedade, a URL deve apontar para um manifesto de implantação para personalização que já está associada com o documento.

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

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

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

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

Exemplos

O exemplo de código usa o construtor de ServerDocument(String) para criar uma nova ServerDocument ao carregar um documento especificado.O exemplo exibe no URL de manifesto de implantação para personalização que é anexada ao documento.

Este exemplo requer:

Um projeto de aplicativo do console ou qualquer outro projeto do Office não.
Referências para os seguintes conjuntos de módulos (assemblies):
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.dll (se o projeto utiliza .NET Framework 4 ou .NET Framework 4.5).
  
  ou
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (se o projeto utiliza o .NET Framework 3.5).
Imports (Visual Basic) ou instruções de using (para C#) para Microsoft.VisualStudio.Tools.Applications e namespaces de Microsoft.VisualStudio.Tools.Applications.Runtime na parte superior do 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

Compartilhar via