ServerDocument.DeploymentManifestUrl – vlastnost

Článek
01/03/2014

Získá nebo nastaví adresu URL manifestu nasazení vlastního nastavení, který je spojen s dokumentem.

Obor názvů: Microsoft.VisualStudio.Tools.Applications
Sestavení: Microsoft.VisualStudio.Tools.Applications.ServerDocument (v Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Syntaxe

'Deklarace
Public Property DeploymentManifestUrl As Uri

public Uri DeploymentManifestUrl { get; set; }

Hodnota vlastnosti

Typ: System.Uri
Adresa URL, která určuje název a umístění manifestu nasazení vlastního nastavení, který je spojen s dokumentem.

Poznámky

Nastavte tuto vlastnost na novou adresu URL manifestu nasazení přizpůsobení přesunete do jiného umístění a chcete dokument vyhledejte aktualizace vlastního nastavení z nového umístění.Pokud nastavíte tuto vlastnost, adresa URL musí odkazovat manifest nasazení vlastního nastavení, který je spojen s dokumentem.

Tuto vlastnost nelze použít, pokud chcete přidružit k nové úpravy dokumentu.Přidání vlastního nastavení do nepřizpůsobené dokumentu, použijte AddCustomization metody.Přidat různé možnosti přizpůsobení vlastního dokumentu, nejprve použít RemoveCustomization metoda odebrat aktuální vlastní nastavení a potom použít AddCustomization metody.

Získávání adresy URL v aplikacích, které jsou cíleny rozhraní.NET Framework 3.5

Při použití ServerDocument třídy v sestavení Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll aplikace, která cílí na rozhraní.NET Framework 3.5 DeploymentManifestUrl vlastnost vrátí aktuální adresy URL manifestu nasazení pouze v případě přizpůsobení úrovni dokumentace je nainstalována v počítači kde se spuštěnou aplikací.V opačném případě vrátí tato vlastnost nullodkaz null (Nothing v jazyce Visual Basic).

Pokud potřebujete získat URL manifestu nasazení přizpůsobení úrovni dokumentu, který není nainstalován v počítači, kde běží aplikace (např. na serveru, kde je publikován úrovni dokumentu přizpůsobení), zaměřují na rozhraní.NET Framework 4 v aplikaci odkazovat na sestavení Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll a použít ServerDocument třídy v sestavení.

Příklady

Následující příklad kódu používá ServerDocument(String) konstruktor pro vytvoření nového ServerDocument , načte zadaný dokument.Příkladu se potom zobrazí adresu URL manifestu nasazení vlastního nastavení, který je připojen k dokumentu.

Tento příklad vyžaduje:

Projekt aplikace konzoly nebo jiného projektu mimo sadu Office.
Odkazy na následující sestavení:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll a Microsoft.VisualStudio.Tools.Applications.Runtime.dll (Pokud projekt cílen .NET Framework 4 nebo .NET Framework 4.5).
  
  nebo
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll a Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (Pokud je projekt cílen na rozhraní.NET Framework 3.5).
Imports(pro Visual Basic) nebo using (pro jazyk C#) příkazy pro Microsoft.VisualStudio.Tools.Applications a Microsoft.VisualStudio.Tools.Applications.Runtime obory názvů v horní části souboru kódu.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ServerDocument Třída

Microsoft.VisualStudio.Tools.Applications – obor názvů

Sdílet prostřednictvím