CollectionDataContractAttribute Sınıf

Tanım

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

Devralma

Object

Attribute

CollectionDataContractAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek, öğesini CollectionDataContractAttribute sınıfından devralan bir sınıfa List<T> uygular. Kod, ve ItemName özelliklerini özel değerlere ayarlarName.

[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

İstemci için kod oluşturmak için ServiceModel Meta Veri Yardımcı Programı Aracı (Svcutil.exe) kullanıldığında, kod aşağıdaki örneğe benzer. sınıfının adının ve değerinin değiştirildiğine ItemNamedikkat edin. Genel değerler kullanılırken, sonuçta elde edilen tür adını oluşturmak için tür parametresi adı kullanılır.

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

Açıklamalar

, CollectionDataContractAttribute WCF olmayan sağlayıcılardan gelen verilerle çalışırken birlikte çalışabilirliği kolaylaştırmak ve serileştirilmiş örneklerin tam şeklini denetlemek için tasarlanmıştır. Bu amaçla özelliği, ItemName bir koleksiyon içindeki yinelenen öğelerin adlarını denetlemenizi sağlar. Bu, özellikle sağlayıcı dizi öğesi adı olarak XML öğe türü adını kullanmadığında yararlıdır; örneğin, sağlayıcı XSD tür adı "string" yerine öğe türü adı olarak "String" kullanıyorsa.

CollectionDataContractAttribute ayrıca anahtarlı koleksiyonları işlemek için sözlük türleriyle birlikte kullanılmak üzere tasarlanmıştır. Sözlük türleri, veya arabirimini IDictionary<TKey,TValue> uygulayan IDictionary sınıflardır; örneğin, Dictionary<TKey,TValue>. sınıfını KeyName kullanırken Dictionary<TKey,TValue> özel adlar ayarlamak için ve ValueName özelliklerini kullanın.

kullanma hakkında DataContractSerializerdaha fazla bilgi için bkz. Veri Sözleşmelerini Kullanma.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• DataContractSerializer