CollectionDataContractAttribute Třída

Definice

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

Dědičnost

Object

Attribute

CollectionDataContractAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad použije CollectionDataContractAttribute třídu, která dědí z List<T> třídy. Kód nastaví Name vlastnosti a ItemName na vlastní hodnoty.

[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

Při použití nástroje ServiceModel Metadata Utility Tool (Svcutil.exe) ke generování kódu pro klienta se kód podobá následujícímu příkladu. Všimněte si, že se změnil název třídy a ItemNametaké . Při použití obecných typů se název parametru typu použije k vytvoření výsledného názvu typu.

// 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

Poznámky

Účelem CollectionDataContractAttribute je usnadnit interoperabilitu při práci s daty z jiných poskytovatelů než WCF a řídit přesný tvar serializovaných instancí. Za tímto účelem ItemName vám vlastnost umožňuje řídit názvy opakujících se položek v kolekci. To je užitečné zejména v případě, že zprostředkovatel jako název položky pole nepoužívá název typu elementu XML, například pokud zprostředkovatel jako název typu elementu místo názvu typu XSD "string" používá "Řetězec".

Je CollectionDataContractAttribute také určen pro použití se slovníkovými typy pro zpracování kolekcí s klíči. Typy slovníku jsou třídy, které implementují IDictionary rozhraní nebo IDictionary<TKey,TValue> , Dictionary<TKey,TValue>například . KeyName Při použití Dictionary<TKey,TValue> třídy použijte vlastnosti a ValueName k nastavení vlastních názvů.

Další informace o používání nástroje najdete v DataContractSerializertématu Použití kontraktů dat.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• DataContractSerializer