Właściwość ServerDocument.DeploymentManifestUrl —

Pobiera lub ustawia adres URL manifestu wdrażania dla dostosowania, jakie są skojarzone z dokumentem.

Przestrzeń nazw:  Microsoft.VisualStudio.Tools.Applications
Zestaw:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (w Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Składnia

'Deklaracja
Public Property DeploymentManifestUrl As Uri

public Uri DeploymentManifestUrl { get; set; }

Wartość właściwości

Typ: System.Uri
Adres URL, który określa nazwę i lokalizację manifestu wdrażania dla dostosowania, jakie są skojarzone z dokumentem.

Uwagi

Właociwooć tę można ustawić do nowego adresu URL, jeśli przeniesiesz manifest wdrażania dostosowań do innej lokalizacji i chcesz, aby dokument w celu zlokalizowania aktualizuje customization z nowej lokalizacji.Jeśli ta właściwość zostanie ustawiona, adres URL musi wskazywać manifest rozmieszczania dostosowywania, która jest już skojarzona z dokumentem.

Aby skojarzyć nowe dostosowania z dokumentu, nie można używać tej właściwości.Aby dodać dostosowań do niedostosowane dokumentu, użyj AddCustomization metody.Aby dodać inny dostosowania do dostosowanego dokumentu, należy najpierw użyć RemoveCustomization metoda, aby usunąć bieżące dostosowanie, a następnie użyj AddCustomization metody.

Uzyskiwanie adresu URL w aplikacji przeznaczonych dla.NET Framework 3.5

Podczas korzystania z ServerDocument klasy w zestawie Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll w aplikacji, która jest przeznaczony dla.NET Framework 3.5, DeploymentManifestUrl właściwość zwraca bieżący URL manifestu wdrażania tylko wtedy, gdy dostosowania poziomu dokumentacji jest zainstalowana na komputerze, na którym jest uruchamiana aplikacja.W przeciwnym razie ta właściwość zwraca nullodwołanie o wartości null (Nothing w języku Visual Basic).

Jeśli trzeba uzyskać adres URL manifestu wdrażania dostosowania poziomie dokumentu, który nie jest zainstalowany na komputerze, na którym uruchomiono aplikację (na przykład na serwerze, gdzie opublikowania dostosowania poziomu dokumentu), programem.NET Framework 4 w aplikacji, odwołać zgromadzenie Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll i użyć ServerDocument klasy w tym zestawie.

Przykłady

Następujący kod w przykładzie wykorzystano ServerDocument(String) Konstruktor, aby utworzyć nową ServerDocument który ładuje określonego dokumentu.Następnie w przykładzie wyświetlono adresu URL manifestu wdrażania dla dostosowania, który jest dołączony do dokumentu.

W tym przykładzie wymaga:

• Projekt aplikacji konsoli lub innych projektów nienależących do pakietu Office.

• Odwołania do następujących zestawów:

  • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll i Microsoft.VisualStudio.Tools.Applications.Runtime.dll (jeśli cele projektu .NET Framework 4 lub .NET Framework 4.5).

    lub

  • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll i Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (Jeśli projekt jest przeznaczony dla.NET Framework 3.5).

• Imports(dla Visual Basic) lub using (w przypadku C#) oświadczenia dla Microsoft.VisualStudio.Tools.Applications i Microsoft.VisualStudio.Tools.Applications.Runtime obszarów nazw u góry pliku kodu.

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

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

ServerDocument Klasa

Przestrzeń nazw Microsoft.VisualStudio.Tools.Applications