CollectionDataContractAttribute 類別

定義

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

繼承

Object

Attribute

CollectionDataContractAttribute

屬性

AttributeUsageAttribute

範例

下列範例會將 CollectionDataContractAttribute 套用至繼承自 List<T> 類別的類別。 這段程式碼會將 Name 和 ItemName 屬性設定為自訂值。

[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

當 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 用來產生用戶端的程式碼時，程式碼會類似下列範例。 請注意，類別的名稱以及 ItemName 都已經變更過。 當使用泛型時，型別參數名稱會用來建立結果型別名稱。

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

備註

CollectionDataContractAttribute這是為了在處理來自非 WCF 提供者的資料時簡化互通性，以及控制序列化實例的確切形狀。 為此，ItemName 屬性能夠讓您控制集合內重複項目的名稱。 這個方法在提供者不使用 XML 項目型別名稱做為陣列項目名稱時特別有用，例如，當提供者使用 "String" 當做項目型別名稱，而不是使用 XSD 型別名稱 "string" 的情況。

CollectionDataContractAttribute 也可以用來搭配字典型別，以便處理索引集合。 字典型別是會實作 IDictionary 或 IDictionary<TKey,TValue> 介面的類別，例如 Dictionary<TKey,TValue>。 使用 KeyName 和 ValueName 屬性，即可在使用 Dictionary<TKey,TValue> 類別時設定自訂名稱。

如需使用 DataContractSerializer 的詳細資訊，請參閱 使用資料合約。

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

• DataContractSerializer