ServerDocument.DeploymentManifestUrl-Eigenschaft (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft die URL des Bereitstellungsmanifests für die Visual Studio Tools for Office-Anpassung, die dem Dokument zugeordnet ist, ab oder legt diese fest.

Namespace: Microsoft.VisualStudio.Tools.Applications
Assembly: Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0 (in Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll)

Syntax

Public Property DeploymentManifestUrl As Uri

Dim instance As ServerDocument
Dim value As Uri

value = instance.DeploymentManifestUrl

instance.DeploymentManifestUrl = value

public Uri DeploymentManifestUrl { get; set; }

Eigenschaftenwert

Typ: System.Uri

Eine URL, die den Namen und den Speicherort des Bereitstellungsmanifests für die Anpassung angibt, die dem Dokument zugeordnet ist.

Hinweise

Legen Sie diese Eigenschaft auf eine neue URL fest, wenn Sie das Bereitstellungsmanifest für eine Anpassung an einen anderen Speicherort verschieben möchten und das Dokument in der Lage sein soll, Anpassungsupdates am neuen Speicherort zu finden. Wenn Sie diese Eigenschaft festlegen, muss die URL auf ein Bereitstellungsmanifest für die Anpassung verweisen, die bereits dem Dokument zugeordnet ist.

Sie können diese Eigenschaft nicht verwenden, um einem Dokument eine neue Anpassung zuzuordnen. Um einem nicht angepassten Dokument eine Anpassung hinzuzufügen, verwenden Sie die AddCustomization-Methode. Um einem angepassten Dokument eine andere Anpassung hinzuzufügen, entfernen Sie zunächst mit der RemoveCustomization-Methode die aktuelle Anpassung. Anschließend verwenden Sie die AddCustomization-Methode.

Beispiele

Im folgenden Codebeispiel wird der ServerDocument(String)-Konstruktor zum Erstellen eines neuen ServerDocument-Objekts verwendet, das ein angegebenes Dokument lädt. Im Beispiel wird dann die URL des Bereitstellungsmanifests für die Visual Studio Tools for Office-Anpassung angezeigt, die an das Dokument angefügt ist.

Für dieses Beispiel ist am Anfang der Codedatei ein Verweis auf die Assemblys Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll und Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll sowie auf die Anweisung Imports (für Visual Basic) oder using (für C#) für die Namespaces Microsoft.VisualStudio.Tools.Applications und Microsoft.VisualStudio.Tools.Applications.Runtime erforderlich.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ServerDocument-Klasse

ServerDocument-Member

Microsoft.VisualStudio.Tools.Applications-Namespace

Freigeben über