ServerDocument.DeploymentManifestUrl - свойство

Статья
08/11/2011

Получает или задает URL-адрес манифеста развертывания для настройки, связанной с документом.

Пространство имен: Microsoft.VisualStudio.Tools.Applications
Сборка: Microsoft.VisualStudio.Tools.Applications.ServerDocument (в Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Синтаксис

'Декларация
Public Property DeploymentManifestUrl As Uri
    Get
    Set

public Uri DeploymentManifestUrl { get; set; }

Значение свойства

Тип: System.Uri
URL-адрес, указывающий имя и расположение манифеста развертывания для настройки, связанной с документом.

Заметки

Если необходимо переместить манифест развертывания для настройки в другое место размещения, а документ должен искать обновления настройки в новом месте, следует задать новый URL-адрес в этом свойстве. При задании значения этого свойства URL-адрес должен указывать на манифест развертывания для настройки, уже связанной с документом.

Нельзя использовать это свойство для связи новой настройки с документом. Чтобы добавить настройку к ненастроенному документу, следует использовать метод AddCustomization. Чтобы добавить другую настройку к настроенному документу, сначала следует использовать метод RemoveCustomization для удаления текущей настройки, а затем применить метод AddCustomization.

Получение URL в приложениях, ориентированных на .NET Framework 3.5

При использовании класса ServerDocument в сборке Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll в приложении для .NET Framework 3.5, свойство DeploymentManifestUrl возвращает текущий манифест развертывания URL-адреса, только если на компьютере, где выполняется приложение установлены настройки уровня документации. В противном случае это свойство возвращает значение nullпустая ссылка (Nothing в Visual Basic).

Если требуется получить URL-адрес манифеста развертывания для настройки на уровне документа, не установленной на компьютере, где выполняется приложение (например на сервере, где опубликована настройка уровня документа), задайте приложению в качестве целевой платформы .NET Framework 4, создайте ссылку на сборку Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll и используйте в этой сборке класс ServerDocument.

Примеры

В следующем примере кода показывается, как использовать конструктор ServerDocument(String) для создания нового объекта ServerDocument, который загружает указанный документ. Затем в примере отображается URL-адрес манифеста развертывания для настройки, прикрепленной к документу.

Для этого примера требуется:

Проект консольного приложения или другой проект, не связанный с Office.
Ссылки на следующие сборки:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll и Microsoft.VisualStudio.Tools.Applications.Runtime.dll (если проект предназначен для платформы .NET Framework 4).
  
  или
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll и Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (если проект предназначен для платформы .NET Framework 3.5).
Операторы Imports (для Visual Basic) или using (для C#) для пространств имен Microsoft.VisualStudio.Tools.Applications и Microsoft.VisualStudio.Tools.Applications.Runtime вверху вашего файла с кодом.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ServerDocument Класс

Microsoft.VisualStudio.Tools.Applications - пространство имен

Поделиться через