CollectionDataContractAttribute Třída

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.Serialization.Primitives.dll

Zdroj:

CollectionDataContractAttribute.cs

Při použití na typ kolekce povolí vlastní specifikaci prvků položky kolekce. Tento atribut lze použít pouze pro typy, které jsou rozpoznány DataContractSerializer jako platné serializovatelné kolekce.

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

CollectionDataContractAttribute()

Inicializuje novou instanci CollectionDataContractAttribute třídy.

Vlastnosti

IsItemNameSetExplicitly	Získá, zda ItemName byl explicitně nastaven.
IsKeyNameSetExplicitly	Získá, zda KeyName byl explicitně nastaven.
IsNameSetExplicitly	Získá, zda Name byl explicitně nastaven.
IsNamespaceSetExplicitly	Získá, zda Namespace byl explicitně nastaven.
IsReference	Získá nebo nastaví hodnotu, která označuje, zda zachovat data odkazu na objekt.
IsReferenceSetExplicitly	Získá, zda odkaz byl explicitně nastaven.
IsValueNameSetExplicitly	Získá, zda ValueName byl explicitně nastaven.
ItemName	Získá nebo nastaví vlastní název pro prvek kolekce.
KeyName	Získá nebo nastaví vlastní název pro název klíče slovníku.
Name	Získá nebo nastaví název kontraktu dat pro typ kolekce.
Namespace	Získá nebo nastaví obor názvů pro kontrakt dat.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
ValueName	Získá nebo nastaví vlastní název pro název hodnoty slovníku.

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• DataContractSerializer