Costruttore ServerDocument (String, FileAccess)

Articolo
05/17/2013

Inizializza una nuova istanza della classe ServerDocument utilizzando il percorso completo del documento da caricare e un valore indicante l'accesso al file per il documento.

Spazio dei nomi: Microsoft.VisualStudio.Tools.Applications
Assembly: Microsoft.VisualStudio.Tools.Applications.ServerDocument (in Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Sintassi

'Dichiarazione
Public Sub New ( _
    documentPath As String, _
    access As FileAccess _
)

public ServerDocument(
    string documentPath,
    FileAccess access
)

Parametri

documentPath
Tipo: System.String
Percorso completo del documento da caricare.

access
Tipo: System.IO.FileAccess
Valore che indica l'accesso al file per il documento.

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro documentPath è nullriferimento null (Nothing in Visual Basic), vuoto, oppure composto unicamente da spazi vuoti.
ArgumentException	Il valore di access è System.IO.FileAccess.Write.
FileNotFoundException	Il file specificato in documentPath non esiste.
DocumentNotCustomizedException	Il file specificato dal parametro documentPath non include una personalizzazione e il valore di access è System.IO.FileAccess.Read.
DocumentCustomizedWithPreviousRuntimeException	Il file specificato da documentPath dispone di una personalizzazione non creata con Visual Studio 2010 tools per Office runtime o Visual Studio Tools per Microsoft Office System (versione runtime 3,0).
UnknownCustomizationFileException	L'estensione di file specificata da documentPath non è supportata dal Runtime di Visual Studio Tools per Office.

Note

Utilizzare questo costruttore per accedere ai dati memorizzati nella cache o alle informazioni sul manifesto di distribuzione in un documento su disco per aprire il documento con accesso in sola lettura o in sola scrittura.Per impostazione predefinita, dagli altri costruttori ServerDocument il documento viene aperto con accesso in lettura/scrittura.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il costruttore ServerDocument(String, FileAccess) per creare un nuovo oggetto ServerDocument che esegue il caricamento di un documento specificato con accesso in sola lettura.Nel codice viene quindi visualizzato l'URL del manifesto di distribuzione per la personalizzazione associata al documento.

L'esempio presenta i seguenti requisiti:

Progetto di applicazione console o qualche altro progetto non-Office.
Riferimenti ai seguenti assembly:
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.dll (se il progetto è destinato a .NET Framework 4 o .NET Framework 4.5).
  
  oppure
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll e Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (se il progetto è destinato a .NET Framework 3.5).
Istruzioni Imports (per Visual Basic) o using (per C#) per gli spazi dei nomi Microsoft.VisualStudio.Tools.Applications e Microsoft.VisualStudio.Tools.Applications.Runtime all'inizio del file di codice

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ServerDocument Classe

Overload ServerDocument

Spazio dei nomi Microsoft.VisualStudio.Tools.Applications

Condividi tramite