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
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.
Para este ejemplo se 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 proyecto tiene como destino .NET Framework 4 o .NET Framework 4.5).
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
Microsoft.VisualStudio.Tools.Applications (Espacio de nombres)