ServerDocument (Constructor) (String, FileAccess)

Inicializa una nueva instancia de la clase ServerDocument utilizando la ruta de acceso completa del documento que se va a cargar y un valor que indica el acceso a archivos del 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 Sub New ( _
    documentPath As String, _
    access As FileAccess _
)

public ServerDocument(
    string documentPath,
    FileAccess access
)

Parámetros

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

• access
  Tipo: System.IO.FileAccess
  Valor que indica el acceso a archivos del documento.

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.
ArgumentException	El valor de access es System.IO.FileAccess.Write.
FileNotFoundException	El archivo especificado por documentPath no existe.
DocumentNotCustomizedException	El archivo especificado por el parámetro documentPath no tiene una personalización y el valor de access es System.IO.FileAccess.Read.
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 si desea abrir el documento con acceso de sólo lectura o de sólo escritura.De forma predeterminada, los otros constructores de ServerDocument abren el documento con acceso de lectura y escritura.

Ejemplos

En el ejemplo de código siguiente se utiliza el constructor ServerDocument(String, FileAccess) para crear un nuevo objeto ServerDocument que carga un documento especificado con acceso de sólo lectura.En el código 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 CreateServerDocumentReadOnly(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, System.IO.FileAccess.Read)
            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 DocumentNotCustomizedException
        System.Windows.Forms.MessageBox.Show("The specified document does not " & _
            "have a customization.")
    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 CreateServerDocumentReadOnly(string documentPath)
{
    int runtimeVersion = 0;
    ServerDocument serverDocument1 = null;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
        if (runtimeVersion == 3)
        {
            serverDocument1 = new ServerDocument(documentPath,
                System.IO.FileAccess.Read);
            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 (DocumentNotCustomizedException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document does not " +
            "have a customization.");
    }
    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

ServerDocument Clase

ServerDocument (Sobrecarga)

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