All files
[pithos-ms-client] / trunk / Libraries / Json40r2 / Source / Src / Newtonsoft.Json / JsonArrayAttribute.cs
1 #region License
2 // Copyright (c) 2007 James Newton-King
3 //
4 // Permission is hereby granted, free of charge, to any person
5 // obtaining a copy of this software and associated documentation
6 // files (the "Software"), to deal in the Software without
7 // restriction, including without limitation the rights to use,
8 // copy, modify, merge, publish, distribute, sublicense, and/or sell
9 // copies of the Software, and to permit persons to whom the
10 // Software is furnished to do so, subject to the following
11 // conditions:
12 //
13 // The above copyright notice and this permission notice shall be
14 // included in all copies or substantial portions of the Software.
15 //
16 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
18 // OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
20 // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
21 // WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23 // OTHER DEALINGS IN THE SOFTWARE.
24 #endregion
25
26 using System;
27 using System.Collections.Generic;
28 using System.Linq;
29 using System.Text;
30
31 namespace Newtonsoft.Json
32 {
33   /// <summary>
34   /// Instructs the <see cref="JsonSerializer"/> how to serialize the collection.
35   /// </summary>
36   [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = false)]
37   public sealed class JsonArrayAttribute : JsonContainerAttribute
38   {
39     private bool _allowNullItems;
40
41     /// <summary>
42     /// Gets or sets a value indicating whether null items are allowed in the collection.
43     /// </summary>
44     /// <value><c>true</c> if null items are allowed in the collection; otherwise, <c>false</c>.</value>
45     public bool AllowNullItems
46     {
47       get { return _allowNullItems; }
48       set { _allowNullItems = value; }
49     }
50
51     /// <summary>
52     /// Initializes a new instance of the <see cref="JsonArrayAttribute"/> class.
53     /// </summary>
54     public JsonArrayAttribute()
55     {
56     }
57
58     /// <summary>
59     /// Initializes a new instance of the <see cref="JsonObjectAttribute"/> class with a flag indicating whether the array can contain null items
60     /// </summary>
61     /// <param name="allowNullItems">A flag indicating whether the array can contain null items.</param>
62     public JsonArrayAttribute(bool allowNullItems)
63     {
64       _allowNullItems = allowNullItems;
65     }
66
67     /// <summary>
68     /// Initializes a new instance of the <see cref="JsonArrayAttribute"/> class with the specified container Id.
69     /// </summary>
70     /// <param name="id">The container Id.</param>
71     public JsonArrayAttribute(string id)
72       : base(id)
73     {
74     }
75   }
76 }