ServerDocument الفئة

مقالة
09/21/2010

يوفر الوصول إلى بيانات وتخصيص المعلومات المخزنة مؤقتاً في مستند أو مصنف هو جزء من تخصيص المستوى مستندات التي تم إنشاؤها باستخدام أدوات تطوير المكتب في Studio Vهوual.

مساحة الاسم: Microsoft.VisualStudio.Tools.Applications
التجميع: Microsoft.VisualStudio.Tools.Applications.ServerDocument (في Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

بناء الجملة

'إقرار
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ServerDocument _
    Implements IDisposable

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ServerDocument : IDisposable

ملاحظات

استخدام ServerDocumentالفئة إلى إدارة جوانب معينة من cusإلىmizations المستوى المستندات تشغيل كمبيوتر لديها Excel أو الكلمة مثبت. أنت تستخدم نموذجياً هذا فئة في تطبيقات لا تتكامل مع المكتب، مثل وحدة التحكم بمشاريع أو مشاريع Windows Forms، بدلاً من المكتب مشاريع.

استخدام الأعضاء التاليين من ServerDocumentالفئة إلى إجراء مهام شائعة:

إلى الوصول وتعديل بيانات في ذاكرة تخزين مؤقت للبيانات من مستند تشغيل خادم، استخدم CachedDataخاصية.
إلى برمجياً بيرفق cusإلىmization إلى مستند أو إزالة cusإلىmization من مستند، استخدم AddCustomizationو RemoveCustomizationالأساليب.
للوصول إلى أو تغيير URL الخاص بنشر الملف الظاهري المقترن بالمستند، استخدم DeploymentManifestUrlخاصية.

يوجد إصدارين مختلفين من ServerDocumentفئة في Visual Studio Tools لـ Office Runtime. يجب عليك استخدام الإصدار يعتمد تشغيل الهدف من برنامج.NET Framework تطبيق الذي تريد استخدامه فئة:

التطبيقات التي تستهدف .NET Framework 4، استخدم Microsoft.VisualStudio.Tools.Applications.ServerDocumentالفئة في تجميع Microsoft.VisualStudio.أدوات.Applications.ServerDocument.dll.
للتطبيقات التي تستهدف 3.5 إطار عمل.NET، باستخدام Microsoft.VisualStudio.Tools.Applications.ServerDocumentفئة في تجميع Microsoft.VisualStudio.أدوات.Applications.ServerDocument.v10.0.dll.

لمزيد من المعلومات، راجع إدارة المستندات على خادم عن طريق استخدام فئة ServerDocument.

اختيار ما هو الدالة الإنشائية إلى استخدم

لاستخدام ServerDocumentالفئة للوصول إلى بيانات المخزنة مؤقتاً أو توزيع بيان URL في مستند، يجب أن تقوم بإنشاء ServerDocumentالكائن.

هناك مجموعتان من ServerDocumentالمنشئات:

تعيين أ التي يمكنك استخدم الوصول إلى مستند تم فتحه مسبقاً في ذاكرة.
أ تعيين التي يمكنك استخدامها للوصول إلى أحد مستندات التي هو تشغيل dهوk.

الوصول إلى مستند في ذاكرة

إلى الوصول مستند تم فتحه مسبقاً في ذاكرة، استخدم واحد المنشئات التالية:

قبول هذه المنشئات بايت صفيفة أو Streamالذي يمثل مستند الموجود في ذاكرة. Th هو هو مفيدة إذا كنت ترغب في تعديل بيانات المخزنة مؤقتاً أو تطبيق بيان في مستند قبل التدفق إلى وجهة باستخدام بروتوكول HTTP. إلى استخدم هذه المنشئات مستند يجب أن يتم مسبقاً تخصيص؛ وإلا سوف الإلقاء هذه المنشئات CannotLoadManifestException‏‏ استثناء.

الوصول إلى مستند تشغيل قرص

للوصول إلى واحد مستندات التي هو تشغيل dهوk، استخدم واحد المنشئات التالية:

قبول هذه construcإلىrs مسار الكامل للمستند الذي تريد إلى فتح. افتراضياً، يكون للمستند هو فتحه مع وصول القراءه/الكتابه. إذا كنت ترغب في فتح مستند باستخدام حق الوصول للقراءة فقط أو للكتابة فقط، استخدم الدالة الإنشائية يحتوي FileAccessمعلمة.

أمثلة

إنشاء مثال التعليمة البرمجية التالية جديدة ServerDocumentالذي يحمل المستند المحدد، ثم dهوplays URL الخاص بنشر بيان التخصيص التي هو المرفق بالمستند.

يتطلب هذا المثال:

مشروع تطبيقات وحدة تحكم أو بعض المشاريع بخلاف المكتب الأخرى.
مراجع إلى تجميعات التالية:
- Microsoft.VisualStudio.أدوات.Applications.ServerDocument.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.dll (إذا كان مشروع تستهدف .NET Framework 4).
  
  أو
- Microsoft.VisualStudio.أدوات.Applications.ServerDocument.v10.0.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.v9.0.dll (إذا كان مشروع تستهدف 3.5 إطار عمل.NET).
Imports (for Visual Basic) or using (for C#) statements for Microsoft.VisualStudio.Tools.Applications and Microsoft.VisualStudio.Tools.Applications.Runtime namespaces at the top of your code file.

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