CachedDataItem.SerializeDataInstance أسلوب

بيانات تم تخزينها مؤقتاً serializes كائن بيانات الذي هو تمثيلها بواسطة CachedDataItem.

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

بناء الجملة

'إقرار
Public Sub SerializeDataInstance ( _
    value As Object _
)

public void SerializeDataInstance(
    Object value
)

المعلمات

• value
  النوع: System.Object
  الكائن الذي يحتوي على بيانات التي تريد حفظها إلى كائن ذاكرة تخزين مؤقت للبيانات.

ملاحظات

استخدام SerializeDataInstanceأسلوب إلى يهيّئ أو تعديل القيمة كائن بيانات المخزنة مؤقتاً. وهذا أسلوب serializes valueكائن معلمة في بيانات المخزنة مؤقتاً التي CachedDataItemيمثل. لإجراء تغييرات على قيم بيانات محددة في كائن بيانات مخزنة مؤقتاً معقدة، مثل على DataSetأو DataTable، إلغاء تسلسل تمثيل XML من البيانات المخزنة مؤقتاً في مثيل جديد للكائن المخزن مؤقتاً، عمل تغييرات على هذه النسخة و ثم استخدم SerializeDataInstanceالطريقة إجراء تسلسل التغييرات مرة أخرى إلى ذاكرة تخزين مؤقت للبيانات. للمزيد من المعلومات، راجع الوصول إلى البيانات في المستندات على خادم وكيفية: تغيير البيانات المخزنة مؤقتاً في مصنف على خادم.

يستخدم هذا الأسلوب تنسيق DiffGram لسلسلة DataSet، DataTable، و كتابة الكائنات مجموعة بيانات في ذاكرة تخزين مؤقت للبيانات. وهذا ما يضمن تغييرات بيانات ذاكرة تخزين مؤقت في مستند دون اتصال المرسلة إلى الملقم بشكل صحيح. لمزيد من المعلومات، راجع DiffGrams (ADO.NET).

أمثلة

يستخدم المثال التالي رمز SerializeDataInstanceالأسلوب لتعديل القيمة سلسلة التي هو في ورقة عمل على مصنف Excel.

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

• تخصيص المستوى المستندات ل 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.

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

راجع أيضًَا

المرجع

CachedDataItem الفئة

CachedDataItem الأعضاء

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

موارد أخرى

الوصول إلى البيانات في المستندات على خادم