Сериализация в LINQ to SQL

В этой статье описываются возможности сериализации LINQ to SQL. Следующие абзацы содержат сведения о добавлении сериализации на этапе генерации кода при разработке и о поведении сериализации во время выполнения классов LINQ to SQL.

Код сериализации можно добавить во время разработки с помощью любого из следующих методов:

В конструкторе реляционных объектов измените свойство режима сериализации на юнинаправленное.
В командной строке SQLMetal добавьте параметр /serialization . Дополнительные сведения см. в разделеSqlMetal.exe (средство создания кода).

Обзор

Код, созданный LINQ to SQL, предоставляет возможности отложенной загрузки по умолчанию. Отложенная загрузка очень удобна на середине уровня для прозрачной загрузки данных по запросу. Однако для сериализации проблематично, так как сериализатор активирует отложенную загрузку независимо от того, предназначена ли отложенная загрузка. В действительности, когда объект сериализуется, его транзитивное закрытие во всех исходящих отложенных ссылках сериализуется.

Функция сериализации LINQ to SQL решает эту проблему в основном с помощью двух механизмов:

Режим DataContext отключения отложенной загрузки (ObjectTrackingEnabled). Дополнительные сведения см. в разделе DataContext.
Переключатель генерации кода для добавления атрибутов System.Runtime.Serialization.DataContractAttribute и System.Runtime.Serialization.DataMemberAttribute в создаваемых сущностях. Этот аспект, включая поведение классов отложенной загрузки при сериализации, является основной темой этого раздела.

Определения

Сериализатор DataContract: сериализатор по умолчанию, используемый компонентом Windows Communication Framework (WCF) платформы .NET Framework 3.0 или более поздней версии.
Однонаправленная сериализация: сериализованная версия класса, содержащая только односторонняя связь (чтобы избежать цикла). По соглашению свойство на родительской стороне связи первичного внешнего ключа помечается для сериализации. Другая сторона в двунаправленной ассоциации не сериализуется.

Однонаправленная сериализация — единственный тип сериализации, поддерживаемый LINQ to SQL.

Пример кода

Следующий код использует традиционные Customer и Order классы из примера базы данных Northwind и показывает, как эти классы украшены атрибутами сериализации.

// The class is decorated with the DataContract attribute.
[Table(Name="dbo.Customers")]
[DataContract()]
public partial class Customer : INotifyPropertyChanging, INotifyPropertyChanged
{

' The class is decorated with the DataContract attribute.
<Table(Name:="dbo.Customers"),  _
 DataContract()>  _
Partial Public Class Customer
    Implements System.ComponentModel.INotifyPropertyChanging, System.ComponentModel.INotifyPropertyChanged

// Private fields are not decorated with any attributes, and are
// elided.
private string _CustomerID;

// Public properties are decorated with the DataMember
// attribute and the Order property specifying the serial
// number. See the Order class later in this topic for
// exceptions.
public Customer()
{
    this.Initialize();
}

[Column(Storage="_CustomerID", DbType="NChar(5) NOT NULL", CanBeNull=false, IsPrimaryKey=true)]
[DataMember(Order=1)]
public string CustomerID
{
    get
    {
        return this._CustomerID;
    }
    set
    {
        if ((this._CustomerID != value))
        {
            this.OnCustomerIDChanging(value);
            this.SendPropertyChanging();
            this._CustomerID = value;
            this.SendPropertyChanged("CustomerID");
            this.OnCustomerIDChanged();
        }
    }
}

' Private fields are not decorated with any attributes,
' and are elided.
Private _CustomerID As String

' Public properties are decorated with the DataMember
' attribute and the Order property specifying the
' serial number. See the Order class later in this topic
' for exceptions
<Column(Storage:="_CustomerID", DbType:="NChar(5) NOT NULL", CanBeNull:=false, IsPrimaryKey:=true),  _
 DataMember(Order:=1)>  _
Public Property CustomerID() As String
    Get
        Return Me._CustomerID
    End Get
    Set
        If ((Me._CustomerID = value)  _
                    = false) Then
            Me.OnCustomerIDChanging(value)
            Me.SendPropertyChanging
            Me._CustomerID = value
            Me.SendPropertyChanged("CustomerID")
            Me.OnCustomerIDChanged
        End If
    End Set
End Property

// The following Association property is decorated with
// DataMember because it is the parent side of the
// relationship. The reverse property in the Order class
// does not have a DataMember attribute. This factor
// prevents a 'cycle.'
[Association(Name="FK_Orders_Customers", Storage="_Orders", OtherKey="CustomerID", DeleteRule="NO ACTION")]
[DataMember(Order=13)]
public EntitySet<Order> Orders
{
    get
    {
        return this._Orders;
    }
    set
    {
        this._Orders.Assign(value);
    }
}

   ' The following Association property is decorated with
   ' DataMember because it is the parent side of the
   ' relationship. The reverse property in the Order
   ' class does not have a DataMember attribute. This
   ' factor prevents a 'cycle.'
   <Association(Name:="FK_Orders_Customers", Storage:="_Orders", OtherKey:="CustomerID", DeleteRule:="NO ACTION"), _
 DataMember(Order:=13)> _
Public Property Orders() As EntitySet(Of [Order])
       Get
           Return Me._Orders
       End Get
       Set(ByVal value As EntitySet(Of [Order]))
           Me._Orders.Assign(Value)
       End Set
   End Property

Order Для класса в следующем примере отображается только свойство обратной связи, соответствующее Customer классу, для краткости. У него нет атрибута DataMemberAttribute , чтобы избежать цикла.

// The class for the Orders table is also decorated with the
// DataContract attribute.
[Table(Name="dbo.Orders")]
[DataContract()]
public partial class Order : INotifyPropertyChanging, INotifyPropertyChanged

' The class for the Orders table is also decorated with the
' DataContract attribute.
<Table(Name:="dbo.Orders"),  _
 DataContract()>  _
Partial Public Class [Order]
    Implements System.ComponentModel.INotifyPropertyChanging, System.ComponentModel.INotifyPropertyChanged

// Private fields for the Orders table are not decorated with
// any attributes, and are elided.
private int _OrderID;

// Public properties are decorated with the DataMember
// attribute.
// The reverse Association property on the side of the
// foreign key does not have the DataMember attribute.
[Association(Name = "FK_Orders_Customers", Storage = "_Customer", ThisKey = "CustomerID", IsForeignKey = true)]
public Customer Customer

' Private fields for the Orders table are not decorated with
' any attributes, and are elided.
Private _CustomerID As String

' Public properties are decorated with the DataMember
' attribute.
' The reverse Association property on the side of the
' foreign key does not have the DataMember attribute.
<Association(Name:="FK_Orders_Customers", Storage:="_Customer", ThisKey:="CustomerID", IsForeignKey:=true)>  _
Public Property Customer() As Customer

Как сериализовать сущности

Вы можете сериализовать сущности в кодах, показанных в предыдущем разделе, как показано ниже;

Northwnd db = new Northwnd(@"c\northwnd.mdf");

Customer cust = db.Customers.Where(c => c.CustomerID ==
    "ALFKI").Single();

DataContractSerializer dcs =
    new DataContractSerializer(typeof(Customer));
StringBuilder sb = new StringBuilder();
XmlWriter writer = XmlWriter.Create(sb);
dcs.WriteObject(writer, cust);
writer.Close();
string xml = sb.ToString();

Dim db As New Northwnd("...")

Dim cust = (From c In db.Customers _
            Where c.CustomerID = "ALFKI").Single

Dim dcs As New DataContractSerializer(GetType(Customer))

Dim sb As StringBuilder = New StringBuilder()
Dim writer As XmlWriter = XmlWriter.Create(sb)
dcs.WriteObject(writer, cust)
writer.Close()
Dim xml As String = sb.ToString()

Self-Recursive Отношения

Саморекурсивные связи соответствуют тому же шаблону. Свойство ассоциации, соответствующее внешнему ключу, не имеет атрибута DataMemberAttribute, тогда как родительское свойство его имеет.

Рассмотрим следующий класс с двумя самокурсивными связями: Employee.Manager/Reports и Employee.Mentor/Mentees.

// No DataMember attribute.
public Employee Manager;
[DataMember(Order = 3)]
public EntitySet<Employee> Reports;

// No DataMember
public Employee Mentor;
[DataMember(Order = 5)]
public EntitySet<Employee> Mentees;

' No DataMember attribute
Public Manager As Employee
<DataMember(Order:=3)> _
Public Reports As EntitySet(Of Employee)

' No DataMember attribute
Public Mentor As Employee
<DataMember(Order:=5)> _
Public Mentees As EntitySet(Of Employee)

См. также

Last updated on 2025-12-03