ServerDocument.Save أسلوب

قم بحفظ أية تغييرات تم إجراؤها إلى مستند باستخدام ServerDocumentفئة.

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

بناء الجملة

'إقرار
Public Sub Save

public void Save()

استثناءات

استثناء:	شرط
DocumentClosedException	ServerDocumentتم مغلق.
MissingHostItemIdException	Idخاصية CachedDataHostItemهو nullمرجع خالٍ (لا شيء في Visual Basic)أو فارغ.
MissingDataIdException	Idخاصية CachedDataItemهو nullمرجع خالٍ (لا شيء في Visual Basic)أو فارغ.
MissingTypeException	DataTypeخاصية CachedDataItemهو nullمرجع خالٍ (لا شيء في Visual Basic)أو فارغ.

ملاحظات

Saveأسلوب حفظ أية تغييرات قمت بإجرائها على بيانات المخزنة مؤقتاً أو للنشر بيان URL في التطبيق. إذا قمت بإنشاء ServerDocumentكائن باستخدام مستند تشغيل قرص، هذا الأسلوب بحفظ هذه التغييرات إلى قرص. إذا قمت بإنشاء ServerDocumentالكائن باستخدام مستند في ذاكرة، وذلك أسلوب يقوم بحفظ هذه التغييرات إلى احتياطي ذاكرة.

أمثلة

مثال التعليمة البرمجية التالية ينشئ جديد ServerDocumentلمصنف Excel معين، قم بتعديل القيمة سلسلة التي هو مؤقتاً في ورقة عمل باستخدام SerializeDataInstanceالأسلوب، وثم حفظ التغييرات باستخدام Saveالأسلوب.

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

• تخصيص المستوى المستندات ل Excel الذي يحتوي على Sheet1فئة في ExcelWorkbook1مساحة الاسم، وسلسلة المخزنة مؤقتاً في Sheet1فئة المسمى CachedString.

• مشروع تطبيقات وحدة تحكم أو بعض المشاريع بخلاف المكتب الأخرى.

• مراجع إلى تجميعات التالية:

  • 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 ModifyCachedString(ByVal documentPath As String)
    Dim runtimeVersion As Integer = 0
    Dim serverDocument1 As ServerDocument = Nothing

    Try
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
        If runtimeVersion <> 3 Then
            MessageBox.Show("This document does not have a Visual Studio Tools for Office " & _
                "customization, or it has a customization that was created with a version of " & _
                "the runtime that is incompatible with this version of the ServerDocument class.")
            Return
        End If

        If ServerDocument.IsCacheEnabled(documentPath) Then
            serverDocument1 = New ServerDocument(documentPath)
            Dim hostItem1 As CachedDataHostItem = _
                serverDocument1.CachedData.HostItems("ExcelWorkbook1.Sheet1")
            Dim dataItem1 As CachedDataItem = hostItem1.CachedData("CachedString")

            If dataItem1 IsNot Nothing AndAlso _
                Type.GetType(dataItem1.DataType).Equals(GetType(String)) Then

                dataItem1.SerializeDataInstance("This is the new cached string value.")
                serverDocument1.Save()
            End If
        Else
            MessageBox.Show("The specified document does not have cached data.")
        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 ModifyCachedString(string documentPath)
{
    int runtimeVersion = 0;
    ServerDocument serverDocument1 = null;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);

        if (runtimeVersion != 3)
        {
            MessageBox.Show("This document does not have a Visual Studio Tools for " +
                "Office customization, or it has a customization that was created with " +
                "a version of the runtime that is incompatible with this version of the " +
                "ServerDocument class.");
            return;
        }

        if (ServerDocument.IsCacheEnabled(documentPath))
        {
            serverDocument1 = new ServerDocument(documentPath);
            CachedDataHostItem hostItem1 = 
                serverDocument1.CachedData.HostItems["ExcelWorkbook1.Sheet1"];
            CachedDataItem dataItem1 = hostItem1.CachedData["CachedString"];

            if (dataItem1 != null &&
                Type.GetType(dataItem1.DataType) == typeof(string))
            {
                dataItem1.SerializeDataInstance("This is the new cached string value.");
                serverDocument1.Save();
            }
        }
        else
        {
            MessageBox.Show("The specified document does not have cached data.");
        }
    }
    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();
    }
}

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

ServerDocument الفئة

ServerDocument الأعضاء

Microsoft.VisualStudio.Tools.Applications مساحة الاسم