Właściwość ServerDocument.DeploymentManifestUrl —

Artykuł
05/08/2013

Pobiera lub ustawia adres URL manifestu wdrażania dla dostosowania, które jest 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, które jest skojarzone z dokumentem.

Uwagi

Zestaw tej właściwości do nowego adresu URL, jeśli przeniesiesz manifest wdrażania dostosowań do innej lokalizacji, a dokument ma zlokalizować aktualizacje dostosowywania z nowej lokalizacji.Jeśli ta właściwość adres URL musi wskazywać rozmieszczenia oczywiste dla dostosowania, który jest już skojarzone z dokumentem.

Za pomocą tej właściwości nie można skojarzyć dostosowywania nowy dokument.Aby dodać dostosowań do niedostosowane dokumentu, użyj AddCustomization metoda.Aby dodać inny dostosowywania dostosowany dokument, należy najpierw użyć RemoveCustomization metoda, aby usunąć bieżące dostosowanie, a następnie za pomocą AddCustomization metoda.

Uzyskiwanie adresu URL w aplikacje przeznaczone 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 zainstalowany 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 jest uruchamiana aplikacja (na przykład na serwerze, gdzie opublikowania dostosowania poziomie dokumentu), z programem.NET Framework 4 w we wniosku, odwołać się za Zgromadzenia Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll i korzystania z 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.W przykładzie następnie 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 innego projektu 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 języka Visual Basic) lub using (dla języka 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 Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

ServerDocument Klasa

Przestrzeń nazw Microsoft.VisualStudio.Tools.Applications

Udostępnij za pośrednictwem