Proprietà ServerDocument.DeploymentManifestUrl

Articolo
05/17/2013

Ottiene o imposta l'URL del manifesto della distribuzione per la personalizzazione che è associato al documento.

Spazio dei nomi: Microsoft.VisualStudio.Tools.Applications
Assembly: Microsoft.VisualStudio.Tools.Applications.ServerDocument (in Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Sintassi

'Dichiarazione
Public Property DeploymentManifestUrl As Uri

public Uri DeploymentManifestUrl { get; set; }

Valore proprietà

Tipo: System.Uri
URL che specifica il nome e il percorso del manifesto di distribuzione per la personalizzazione associata al documento.

Note

Impostare tale proprietà su un nuovo URL se il manifesto di distribuzione di una personalizzazione viene spostato in un percorso diverso e si desidera consentire al documento di individuare gli aggiornamenti della personalizzazione dal nuovo percorso.Se la proprietà viene impostata, l'URL deve puntare a un manifesto di distribuzione per la personalizzazione già associata al documento.

Non è possibile utilizzare la proprietà per associare una nuova personalizzazione a un documento.Per aggiungere una personalizzazione a un documento non personalizzato, utilizzare il metodo AddCustomization.Per aggiungere una personalizzazione diversa a un documento personalizzato, utilizzare innanzitutto il metodo RemoveCustomization per rimuovere la personalizzazione corrente, quindi utilizzare il metodo AddCustomization.

Ottenimento dell'URL nelle applicazioni destinate a .NET Framework 3.5

Quando si utilizza la classe ServerDocument nell'assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll di un'applicazione destinata a .NET Framework 3.5, la proprietà DeploymentManifestUrl restituisce l'URL del manifesto di distribuzione corrente solo se la personalizzazione a livello di documentazione viene installata nel computer dove si esegue l'applicazione.mentre negli altri casi restituisce nullriferimento null (Nothing in Visual Basic).

Se è necessario ottenere l'URL del manifesto di distribuzione di una personalizzazione a livello di documento non installata sul computer dal quale si esegue l'applicazione (ad esempio, su un server dove è pubblicata la personalizzazione a livello di documento), utilizzare .NET Framework 4 nell'applicazione, fare riferimento all'assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e usare la classe ServerDocument di tale assembly.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il costruttore ServerDocument(String) per creare un nuovo oggetto ServerDocument che esegue il caricamento di un documento specificato.Nell'esempio viene quindi visualizzato l'URL del manifesto di distribuzione per la personalizzazione associata al documento.

L'esempio presenta i seguenti requisiti:

Progetto di applicazione console o qualche altro progetto non-Office.
Riferimenti ai seguenti assembly:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.dll (se il progetto è destinato a .NET Framework 4 o .NET Framework 4.5).
  
  oppure
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (se il progetto è destinato a .NET Framework 3.5).
Istruzioni Imports (per Visual Basic) o using (per C#) per gli spazi dei nomi Microsoft.VisualStudio.Tools.Applications e Microsoft.VisualStudio.Tools.Applications.Runtime all'inizio del file di codice

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ServerDocument Classe

Spazio dei nomi Microsoft.VisualStudio.Tools.Applications

Condividi tramite