ServerDocument.DeploymentManifestUrl (Propiedad)

Obtiene o establece la dirección URL del manifiesto de implementación de la personalización que está asociada al documento.

Espacio de nombres:  Microsoft.VisualStudio.Tools.Applications
Ensamblado:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (en Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Sintaxis

'Declaración
Public Property DeploymentManifestUrl As Uri
    Get
    Set

public Uri DeploymentManifestUrl { get; set; }

Valor de propiedad

Tipo: System.Uri
Una dirección URL que especifica el nombre y la ubicación del manifiesto de implementación de la personalización que está asociada al documento.

Comentarios

Establezca esta propiedad en una nueva dirección URL si cambia el manifiesto de implementación de una personalización a una ubicación diferente y desea que el documento busque las actualizaciones de la personalización desde la nueva ubicación. Si establece esta propiedad, la dirección URL debe apuntar a un manifiesto de implementación de la personalización que ya está asociada al documento.

No puede utilizar esta propiedad para asociar una nueva personalización a un documento. Para agregar una personalización a un documento que no está personalizado, utilice el método AddCustomization. Para agregar una personalización diferente a un documento personalizado, utilice primero el método RemoveCustomization para quitar la personalización actual y, a continuación, utilice el método AddCustomization.

Obtener la dirección URL en aplicaciones que tienen como destino .NET Framework 3.5

Al utilizar la clase ServerDocument en el ensamblado de Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll en una aplicación destinada a .NET Framework 3.5, la propiedad DeploymentManifestUrl devuelve solo la dirección URL del manifiesto de implementación actual si la personalización de nivel de documentación se instala en el equipo donde se está ejecutando la aplicación. En caso contrario, esta propiedad devuelve nullreferencia null (Nothing en Visual Basic).

Si necesita obtener la dirección URL del manifiesto de implementación de una personalización de nivel de documento no instalada en el equipo donde se ejecuta la aplicación (por ejemplo, en un servidor donde se publica una personalización de nivel de documento), establezca como destino .NET Framework 4 en la aplicación, haga referencia al ensamblado Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll y use la clase ServerDocument en dicho ensamblado.

Ejemplos

En el ejemplo de código siguiente se utiliza el constructor ServerDocument(String) para crear un nuevo objeto ServerDocument que carga un documento especificado. En el ejemplo se muestra a continuación la dirección URL del manifiesto de implementación de la personalización adjunta al documento.

Este ejemplo necesita:

• Un proyecto de aplicación de consola o algún otro proyecto que no es de Office.

• Referencias a los siguientes ensamblados:

  • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll y Microsoft.VisualStudio.Tools.Applications.Runtime.dll (si el destino del proyecto es .NET Framework 4).

    O bien

  • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll and Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (si el proyecto está dirigido a .NET Framework 3.5).

• Instrucciones Imports (para Visual Basic) o using (para C#) para los espacios de nombres Microsoft.VisualStudio.Tools.Applications y Microsoft.VisualStudio.Tools.Applications.Runtime en la parte superior de su archivo de código.

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

ServerDocument Clase

Microsoft.VisualStudio.Tools.Applications (Espacio de nombres)