Compartir a través de

ServerDocument (Constructor) (String)

  • Artículo

Inicializa una nueva instancia de la clase ServerDocument utilizando la ruta de acceso completa del documento que se va a cargar.

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

Sintaxis

'Declaración
Public Sub New ( _
    documentPath As String _
)

public ServerDocument(
    string documentPath
)

Parámetros

  • documentPath
    Tipo: System.String
    Ruta de acceso completa del documento que se va a cargar.

Excepciones

Excepción Condición
ArgumentNullException

El parámetro documentPath es nullreferencia null (Nothing en Visual Basic) o está vacío, o se compone únicamente de caracteres de espacio en blanco.
FileNotFoundException

El archivo especificado por documentPath no existe.
DocumentCustomizedWithPreviousRuntimeException

El archivo especificado por documentPath tiene una personalización no creada con Visual Studio 2010 Tools para Office Runtime o herramientas de Visual Studio tools para Microsoft Office system (versión 3,0 del runtime).
UnknownCustomizationFileException

El archivo especificado por documentPath tiene una extensión de nombre de archivo que no es compatible con Runtime de Microsoft Visual Studio Tools para Office.

Comentarios

Utilice este constructor para tener acceso a los datos almacenados en memoria caché o a la información del manifiesto de implementación de un documento que está almacenado en disco.Cuando utiliza este constructor, el documento especificado se abre con acceso de lectura y escritura.

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

Vea también

Referencia

ServerDocument Clase

ServerDocument (Sobrecarga)

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