MessageHeaderArrayAttribute Class (System.ServiceModel)

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

MessageHeaderArrayAttribute Class

Specifies that the default wrapper element in the SOAP message must not be written around array types in a header element.

Namespace: System.ServiceModel
Assembly: System.ServiceModel (in System.ServiceModel.dll)

Syntax

Visual Basic (Declaration)

<AttributeUsageAttribute(AttributeTargets.Property Or AttributeTargets.Field, AllowMultiple := False,  _
    Inherited := False)> _
Public NotInheritable Class MessageHeaderArrayAttribute _
    Inherits MessageHeaderAttribute

Visual Basic (Usage)

Dim instance As MessageHeaderArrayAttribute

[AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field, AllowMultiple = false, 
    Inherited = false)]
public sealed class MessageHeaderArrayAttribute : MessageHeaderAttribute

Visual C++

[AttributeUsageAttribute(AttributeTargets::Property|AttributeTargets::Field, AllowMultiple = false, 
    Inherited = false)]
public ref class MessageHeaderArrayAttribute sealed : public MessageHeaderAttribute

JScript

public final class MessageHeaderArrayAttribute extends MessageHeaderAttribute

Remarks

Use the MessageHeaderArrayAttribute attribute to turn off the standard array wrapper element when you want to emit an unbounded number of identical elements either inside the <soap:Header> directly or inside the first and only child of <soap:Header> without the default wrapper element for array types.

MessageHeaderArrayAttribute can be applied only to members of an array type. If specified, the Name and Namespace are used as the name and namespace of the element of each array item. If not specified, the array item elements are named using the same convention used for naming non-repeating body parts. For more information, see Name and Namespace.

For information about controlling the serialization of the contents of a SOAP body without modifying the default SOAP envelope itself, see System.Runtime.Serialization..::.DataContractAttribute, Specifying Data Transfer in Service Contracts, and Data Contracts Overview.

For more information about creating message contracts, see Using Message Contracts.

Inheritance Hierarchy

System..::.Object
  System..::.Attribute
    System.ServiceModel..::.MessageContractMemberAttribute
      System.ServiceModel..::.MessageHeaderAttribute
        System.ServiceModel..::.MessageHeaderArrayAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

MessageHeaderArrayAttribute Members

System.ServiceModel Namespace