ServerDocument Конструктор (Stream, String) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Инициализирует новый экземпляр класса ServerDocument с помощью потока, который представляет документ, который требуется загрузить, а также расширение файла документа.

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

Синтаксис

'Декларация
Public Sub New ( _
    stream As Stream, _
    fileType As String _
)
'Применение
Dim stream As Stream
Dim fileType As String

Dim instance As New ServerDocument(stream, _
    fileType)

public ServerDocument(
    Stream stream,
    string fileType
)

Параметры

stream
Тип: System.IO.Stream
Поток, представляющий документ, который требуется загрузить.

fileType
Тип: System.String
Перед расширением имени файла документа, сохраняемого в параметре bytes, должна стоять точка (.) — например, ".xlsx" или ".docx".

Исключения

Исключение	Условие
ArgumentNullException	Параметр stream имеет значение nullссылка null (Nothing в Visual Basic) или пуст. –или– Параметр fileType равен nullссылка null (Nothing в Visual Basic), пуст или содержит только пробелы.
ArgumentException	Параметр stream имеет нулевую длину или его текущее положение — в конце потока.
UnknownCustomizationFileException	Параметр fileType задает расширение имени файла, которое не поддерживается Visual Studio Tools for Office.
DocumentCustomizedWithPreviousRuntimeException	Файл, заданный в параметре documentPath, имеет настройку, созданную в предыдущей версии среды выполнения Visual Studio Tools for Office.

Заметки

Этот конструктор используется для получения доступа к кэшированным данным или данным манифеста развертывания в документе, находящемся в памяти. При использовании этого конструктора документ открывается с правом доступа на чтение/запись.

Параметр fileType используется только для определения типа документа, который хранится в массиве данных. Значение fileType сопоставляется с одним из типов файлов, которые поддерживаются настройками уровня документов. Попытка открытия файла не предпринимается. При необходимости можно передавать полное имя файла (например, "Workbook1.xlsx"); однако при этом используется только расширение имени файла. Дополнительные сведения о поддерживаемых типах файлов см. в разделе Архитектура настроек на уровне документа.

Для получения доступа к массиву байтов, чтобы получить документ после вызова этого конструктора, следует использовать свойство Document.

Примеры

В следующем примере кода для создания нового объекта ServerDocument из потока FileStream, содержащего рабочую книгу Excel с расширением имени файла XLSX, используется конструктор ServerDocument(Stream, String). Затем в примере отображается URL-адрес манифеста развертывания для настройки Visual Studio Tools for Office, прикрепленной к документу.

Для этого примера требуются ссылки на сборки Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll, Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll и операторы Imports (в Visual Basic) или using (в C#) для пространств имен Microsoft.VisualStudio.Tools.Applications и Microsoft.VisualStudio.Tools.Applications.Runtime в начале файла с кодом.

Private Sub CreateServerDocumentFromStream(ByVal documentPath As String)
    Dim runtimeVersion As Integer = 0
    Dim serverDocument1 As ServerDocument = Nothing
    Dim stream As System.IO.FileStream = Nothing

    Try
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
        If runtimeVersion = 3 Then
            stream = New System.IO.FileStream(documentPath, System.IO.FileMode.Open)
            serverDocument1 = New ServerDocument(stream, "*.xlsx")
            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
        If Not (stream Is Nothing) Then
            stream.Close()
        End If
    End Try
End Sub

private void CreateServerDocumentFromStream(string documentPath)
{
    int runtimeVersion = 0;
    ServerDocument serverDocument1 = null;
    System.IO.FileStream stream = null;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
        if (runtimeVersion == 3)
        {
            stream = new System.IO.FileStream(
                documentPath, System.IO.FileMode.Open);
            serverDocument1 = new ServerDocument(stream,
                "*.xlsx");
            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();
        if (stream != null)
            stream.Close();
    }
}

Разрешения

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