Łączenie dwóch kolekcji (LINQ to XML)

Plik XSD może ustanowić relacje w pliku XML, aby umożliwić łączenie elementów w celu utworzenia nowych typów elementów. Ten artykuł zawiera przykład dla języków C# i Visual Basic, które łączą elementy i tworzą nowy dokument XML.

Element lub atrybut w dokumencie XML może czasami odwoływać się do innego elementu lub atrybutu. Przykładowy plik XML dokumentu XML: Klienci i zamówienia zawierają listę klientów i listę zamówień. Każdy Customer element ma CustomerID atrybut, a każdy Order element zawiera CustomerID element. CustomerID Wartość elementu w elemecie Order odwołuje się do Customer elementu, który ma zgodną CustomerID wartość atrybutu.

Artykuł Przykładowy plik XSD: Klienci i zamówienia zawierają XSD, którego można użyć do zweryfikowania Customers and orders dokumentu. Używa funkcji xs:key i xs:keyref XSD, aby ustalić, że CustomerID atrybut Customer elementu jest kluczem, oraz do ustanowienia relacji między kluczem a CustomerID elementem elementów Order.

Korzystając z linQ to XML, możesz skorzystać z tej relacji, używając join klauzuli w celu dołączenia informacji o klientach w celu zamówienia informacji.

Aby uzyskać bardziej szczegółowe informacje na temat joinprogramu , zobacz Operacje dołączania (C#) i Operacje sprzężenia (Visual Basic).

Uwaga

Sprzężenia są wykonywane przy użyciu wyszukiwania liniowego. Brak indeksów zwiększających wydajność wyszukiwania.

Przykład: tworzenie nowego dokumentu XML zawierającego Customer elementy i Order sprzężone

Poniższy przykład generuje nowy dokument XML, który łączy Customer elementy przykładowego pliku XML: Klienci i zamówienia do Order elementów i zawierają CompanyName element w zamówieniach.

Przed wykonaniem zapytania przykład sprawdza, czy dokument jest zgodny ze schematem w przykładowym pliku XSD: Klienci i zamówienia. Dzięki temu klauzula sprzężenia będzie działać.

Zapytanie wybiera tylko zamówienia dla klientów o większej CustomerID niż "K". Projektuje nowe Order elementy zawierające informacje o kliencie w ramach każdego zamówienia.

XmlSchemaSet schemas = new XmlSchemaSet();
schemas.Add("", "CustomersOrders.xsd");

Console.Write("Attempting to validate, ");
XDocument custOrdDoc = XDocument.Load("CustomersOrders.xml");

bool errors = false;
custOrdDoc.Validate(schemas, (o, e) =>
                     {
                         Console.WriteLine("{0}", e.Message);
                         errors = true;
                     });
Console.WriteLine("custOrdDoc {0}", errors ? "did not validate" : "validated");

if (!errors)
{
    // Join customers and orders, and create a new XML document with
    // a different shape.

    // The new document contains orders only for customers with a
    // CustomerID > 'K'
    XElement custOrd = custOrdDoc.Element("Root");
    XElement newCustOrd = new XElement("Root",
        from c in custOrd.Element("Customers").Elements("Customer")
        join o in custOrd.Element("Orders").Elements("Order")
                   on (string)c.Attribute("CustomerID") equals
                      (string)o.Element("CustomerID")
        where ((string)c.Attribute("CustomerID")).CompareTo("K") > 0
        select new XElement("Order",
            new XElement("CustomerID", (string)c.Attribute("CustomerID")),
            new XElement("CompanyName", (string)c.Element("CompanyName")),
            new XElement("ContactName", (string)c.Element("ContactName")),
            new XElement("EmployeeID", (string)o.Element("EmployeeID")),
            new XElement("OrderDate", (DateTime)o.Element("OrderDate"))
        )
    );
    Console.WriteLine(newCustOrd);
}

Public Class Program
    Public Shared errors As Boolean = False

    Public Shared Function LamValidEvent(ByVal o As Object, _
                 ByVal e As ValidationEventArgs) As Boolean
        Console.WriteLine("{0}", e.Message)
        errors = True
    End Function

    Shared Sub Main()
        Dim schemas As New XmlSchemaSet()
        schemas.Add("", "CustomersOrders.xsd")

        Console.Write("Attempting to validate, ")
        Dim custOrdDoc As XDocument = XDocument.Load("CustomersOrders.xml")

        custOrdDoc.Validate(schemas, Function(o, e) LamValidEvent(0, e))
        If errors Then
            Console.WriteLine("custOrdDoc did not validate")
        Else
            Console.WriteLine("custOrdDoc validated")
        End If

        If Not errors Then
            'Join customers and orders, and create a new XML document with
            ' a different shape.
            'The new document contains orders only for customers with a
            ' CustomerID > 'K'.
            Dim custOrd As XElement = custOrdDoc.<Root>.FirstOrDefault
            Dim newCustOrd As XElement = _
                <Root>
                    <%= From c In custOrd.<Customers>.<Customer> _
                        Join o In custOrd.<Orders>.<Order> _
                        On c.@CustomerID Equals o.<CustomerID>.Value _
                        Where c.@CustomerID.CompareTo("K") > 0 _
                        Select _
                        <Order>
                            <CustomerID><%= c.@CustomerID %></CustomerID>
                            <%= c.<CompanyName> %>
                            <%= c.<ContactName> %>
                            <%= o.<EmployeeID> %>
                            <%= o.<OrderDate> %>
                        </Order> _
                    %>
                </Root>
            Console.WriteLine(newCustOrd)
        End If
    End Sub
End Class

Ten przykład generuje następujące wyniki:

Attempting to validate, custOrdDoc validated
<Root>
  <Order>
    <CustomerID>LAZYK</CustomerID>
    <CompanyName>Lazy K Kountry Store</CompanyName>
    <ContactName>John Steel</ContactName>
    <EmployeeID>1</EmployeeID>
    <OrderDate>1997-03-21T00:00:00</OrderDate>
  </Order>
  <Order>
    <CustomerID>LAZYK</CustomerID>
    <CompanyName>Lazy K Kountry Store</CompanyName>
    <ContactName>John Steel</ContactName>
    <EmployeeID>8</EmployeeID>
    <OrderDate>1997-05-22T00:00:00</OrderDate>
  </Order>
  <Order>
    <CustomerID>LETSS</CustomerID>
    <CompanyName>Let's Stop N Shop</CompanyName>
    <ContactName>Jaime Yorres</ContactName>
    <EmployeeID>1</EmployeeID>
    <OrderDate>1997-06-25T00:00:00</OrderDate>
  </Order>
  <Order>
    <CustomerID>LETSS</CustomerID>
    <CompanyName>Let's Stop N Shop</CompanyName>
    <ContactName>Jaime Yorres</ContactName>
    <EmployeeID>8</EmployeeID>
    <OrderDate>1997-10-27T00:00:00</OrderDate>
  </Order>
  <Order>
    <CustomerID>LETSS</CustomerID>
    <CompanyName>Let's Stop N Shop</CompanyName>
    <ContactName>Jaime Yorres</ContactName>
    <EmployeeID>6</EmployeeID>
    <OrderDate>1997-11-10T00:00:00</OrderDate>
  </Order>
  <Order>
    <CustomerID>LETSS</CustomerID>
    <CompanyName>Let's Stop N Shop</CompanyName>
    <ContactName>Jaime Yorres</ContactName>
    <EmployeeID>4</EmployeeID>
    <OrderDate>1998-02-12T00:00:00</OrderDate>
  </Order>
</Root>