CollectionDataContractAttribute Klas

Definitie

public ref class CollectionDataContractAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=false, Inherited=false)]
public sealed class CollectionDataContractAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=false, Inherited=false)>]
type CollectionDataContractAttribute = class
    inherit Attribute

Public NotInheritable Class CollectionDataContractAttribute
Inherits Attribute

Overname

Object

Attribute

CollectionDataContractAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld wordt de CollectionDataContractAttribute klasse toegepast op een klasse die wordt overgenomen van de List<T> klasse. De code stelt de Name en ItemName eigenschappen in op aangepaste waarden.

[CollectionDataContract(Name = "Custom{0}List", ItemName = "CustomItem")]
public class CustomList<T> : List<T>
{
    public CustomList()
        : base()
    {
    }

    public CustomList(T[] items)
        : base()
    {
        foreach (T item in items)
        {
            Add(item);
        }
    }
}

<CollectionDataContract(Name := "Custom{0}List", ItemName := "CustomItem")> _
Public Class CustomList(Of T)
    Inherits List(Of T)
    Public Sub New()
        MyBase.New()
    End Sub

    Public Sub New(ByVal items() As T)
        MyBase.New()
        For Each item As T In items
            Add(item)
        Next item
    End Sub
End Class

Wanneer het hulpprogramma hulpprogramma voor metagegevens van ServiceModel (Svcutil.exe) wordt gebruikt om code voor de client te genereren, lijkt de code op het volgende voorbeeld. U ziet dat de naam van de klasse wordt gewijzigd, evenals de ItemName. Wanneer u generics gebruikt, wordt de parameternaam van het type gebruikt om de resulterende typenaam te maken.

// This is the generated code. Note that the class is renamed to "CustomBookList",
// and the ItemName is set to "CustomItem".
[System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]
[System.Runtime.Serialization.CollectionDataContractAttribute(ItemName = "CustomItem")]
public class CustomBookList : System.Collections.Generic.List<Microsoft.Security.Samples.Book>
{
}

' This is the generated code. Note that the class is renamed to "CustomBookList", 
' and the ItemName is set to "CustomItem".
<System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0"), System.Runtime.Serialization.CollectionDataContractAttribute(ItemName := "CustomItem")> _
Public Class CustomBookList
    Inherits System.Collections.Generic.List(Of Microsoft.Security.Samples.Book)
End Class

Opmerkingen

Het CollectionDataContractAttribute is bedoeld om de interoperabiliteit te vereenvoudigen bij het werken met gegevens van niet-WCF-providers en om de exacte vorm van geserialiseerde exemplaren te beheren. Daarom kunt u met de ItemName eigenschap de namen van de herhalende items in een verzameling beheren. Dit is vooral handig wanneer de provider de naam van het XML-elementtype niet gebruikt als de naam van het matrixitem, bijvoorbeeld als een provider 'Tekenreeks' gebruikt als naam van het elementtype in plaats van de XSD-typenaam 'tekenreeks'.

Het CollectionDataContractAttribute is ook bedoeld om te worden gebruikt met woordenlijsttypen voor het verwerken van sleutelverzamelingen. Woordenlijsttypen zijn klassen die de IDictionary interface of de IDictionary<TKey,TValue> interface implementeren, bijvoorbeeld de Dictionary<TKey,TValue>. Gebruik de KeyName en ValueName eigenschappen om aangepaste namen in te stellen wanneer u de Dictionary<TKey,TValue> klasse gebruikt.

Zie Data Contracts gebruiken voor meer informatie over het gebruik van de DataContractSerializeropdracht.

Zie ook

• DataContractSerializer