Construtor ServerDocument (String)

Artigo
08/01/2011

Inicializa uma nova instância de ServerDocument classe usando o caminho completo do documento a ser carregado.

Namespace: Microsoft.VisualStudio.Tools.Applications
Assembly: Microsoft.VisualStudio.Tools.Applications.ServerDocument (em Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Sintaxe

'Declaração
Public Sub New ( _
    documentPath As String _
)

public ServerDocument(
    string documentPath
)

Parâmetros

documentPath
Tipo: System.String
O caminho completo do documento a ser carregado.

Exceções

Exceção	Condição
ArgumentNullException	O documentPath parâmetro é nulluma referência nula (Nothing no Visual Basic) vazio ou consiste inteiramente de caracteres de espaço em branco.
FileNotFoundException	O arquivo especificado por documentPath não existe.
DocumentCustomizedWithPreviousRuntimeException	O arquivo especificado por documentPath tem uma personalização que não foi criada com o Visual Studio 2010 Tools for Office Runtime ou o Visual Studio Tools para o sistema de Microsoft Office (versão 3.0 Runtime).
UnknownCustomizationFileException	O arquivo especificado por documentPath tem uma extensão de nome de arquivo não oferece suporte a Visual Studio Tools for Office runtime.

Comentários

Use este construtor para acessar os dados ou implantação manifesto informações armazenadas em um documento que está no disco. Quando você usa esse construtor, o documento especificado é aberto com acesso de leitura/gravação.

Exemplos

O seguinte exemplo de código usa o ServerDocument(String) o construtor para criar um novo ServerDocument que carrega o documento especificado. O exemplo, em seguida, exibe a URL do manifesto de implantação para a personalização que é anexado ao documento.

This example requires:

Um projeto de aplicativo de console ou algum outro projeto de não-Office.
Referências aos assemblies seguintes:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.dll (se os destinos do projeto de .NET Framework 4).
  
  or
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (se os destinos do projeto a.NET Framework 3.5).
Imports(para Visual Basic) ou using (para C#) instruções para Microsoft.VisualStudio.Tools.Applications e Microsoft.VisualStudio.Tools.Applications.Runtime namespaces no topo do seu arquivo 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();
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ServerDocument Classe

Sobrecargas ServerDocument

Namespace Microsoft.VisualStudio.Tools.Applications

Compartilhar via