Class JsonValue

Inheritance
object
JsonValue
JsonArray
JsonObject
Implements
Inherited Members
Namespace: Subsembly.Json
Assembly: Subsembly.Json.dll
Syntax
public class JsonValue : ICloneable

Constructors

JsonValue(bool)

Declaration
public JsonValue(bool f)
Parameters
Type Name Description
bool f

JsonValue(decimal)

Declaration
public JsonValue(decimal n)
Parameters
Type Name Description
decimal n

JsonValue(double)

Declaration
public JsonValue(double n)
Parameters
Type Name Description
double n

JsonValue(int)

Declaration
public JsonValue(int n)
Parameters
Type Name Description
int n

JsonValue(long)

Declaration
public JsonValue(long n)
Parameters
Type Name Description
long n

JsonValue(float)

Declaration
public JsonValue(float n)
Parameters
Type Name Description
float n

JsonValue(string)

Declaration
public JsonValue(string s)
Parameters
Type Name Description
string s

Fields

Null

Declaration
public static readonly JsonValue Null
Field Value
Type Description
JsonValue

Undefined

Declaration
public static readonly JsonValue Undefined
Field Value
Type Description
JsonValue

Properties

this[int]

Access to the indexed elements of a JSON array.

Declaration
public JsonValue this[int nIndex] { get; set; }
Parameters
Type Name Description
int nIndex
Property Value
Type Description
JsonValue
Remarks

Access an index that is outside of the range of the array will return null, and NOT a JsonValue of type Undefined.

Exceptions
Type Condition
JsonTypeException

Thrown is this is not an Array.
ArgumentOutOfRangeException

An attempt was made to set a value with an index outside of the range of the array. It is not possible to grow an array just by setting values outside of the current range of values.

this[string]

Access to the named properties of a JSON object.

Declaration
public JsonValue this[string sName] { get; set; }
Parameters
Type Name Description
string sName

Name of property, or path to a nested property seperated with dots.
Property Value
Type Description
JsonValue
Remarks

Setting a property to null will delete that property, and not insert a new JsonValue of type Null. If you want an empty property you have to explicitly pass an appropriate JsonValue.

Getting a property that is not defined will return null and NOT a JsonValue of type Undefined.

Exceptions
Type Condition
ArgumentNullException

The index sName was null.
JsonTypeException

Thrown if this is not an Object.

JsonType

Declaration
public JsonType JsonType { get; }
Property Value
Type Description
JsonType

Value

The primitive value.

Declaration
public object Value { get; }
Property Value
Type Description
object

ValueAsBoolean

Declaration
public bool ValueAsBoolean { get; }
Property Value
Type Description
bool

ValueAsNumber

Declaration
public double ValueAsNumber { get; }
Property Value
Type Description
double

ValueAsString

Returns the value as a string.

Declaration
public string ValueAsString { get; }
Property Value
Type Description
string
Remarks

If this value is not a String, then this method attempts to convert it to a string, first. Conversion is done using the usual JavaScript conversion rules, including conversion of type Undefined to string "undefined" and type Null to string "null".

Methods

Clone()

Declaration
public object Clone()
Returns
Type Description
object

Load(Stream)

Declaration
public static JsonValue Load(Stream aStream)
Parameters
Type Name Description
Stream aStream
Returns
Type Description
JsonValue

Load(TextReader)

Declaration
public static JsonValue Load(TextReader aTextReader)
Parameters
Type Name Description
TextReader aTextReader
Returns
Type Description
JsonValue

Load(string)

Declaration
public static JsonValue Load(string sFileName)
Parameters
Type Name Description
string sFileName
Returns
Type Description
JsonValue

Parse(byte[])

Declaration
public static JsonValue Parse(byte[] vbJson)
Parameters
Type Name Description
byte[] vbJson
Returns
Type Description
JsonValue

Parse(string)

Declaration
public static JsonValue Parse(string sJson)
Parameters
Type Name Description
string sJson
Returns
Type Description
JsonValue

Save(Stream)

Declaration
public void Save(Stream aStream)
Parameters
Type Name Description
Stream aStream

Save(TextWriter)

Declaration
public void Save(TextWriter aTextWriter)
Parameters
Type Name Description
TextWriter aTextWriter

Save(string)

Declaration
public void Save(string sFileName)
Parameters
Type Name Description
string sFileName

ToByteArray()

Declaration
public byte[] ToByteArray()
Returns
Type Description
byte[]

ToString()

Converts this value into its JSON string representation.

Declaration
public override string ToString()
Returns
Type Description
string
Overrides

Operators

implicit operator bool(JsonValue)

Declaration
public static implicit operator bool(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
bool

implicit operator decimal(JsonValue)

Declaration
public static implicit operator decimal(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
decimal

implicit operator double(JsonValue)

Declaration
public static implicit operator double(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
double

implicit operator int(JsonValue)

Declaration
public static implicit operator int(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
int

implicit operator long(JsonValue)

Declaration
public static implicit operator long(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
long

implicit operator float(JsonValue)

Declaration
public static implicit operator float(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
float

implicit operator string(JsonValue)

Declaration
public static implicit operator string(JsonValue aValue)
Parameters
Type Name Description
JsonValue aValue
Returns
Type Description
string

implicit operator JsonValue(bool)

Declaration
public static implicit operator JsonValue(bool f)
Parameters
Type Name Description
bool f
Returns
Type Description
JsonValue

implicit operator JsonValue(decimal)

Declaration
public static implicit operator JsonValue(decimal n)
Parameters
Type Name Description
decimal n
Returns
Type Description
JsonValue

implicit operator JsonValue(double)

Declaration
public static implicit operator JsonValue(double n)
Parameters
Type Name Description
double n
Returns
Type Description
JsonValue

implicit operator JsonValue(int)

Declaration
public static implicit operator JsonValue(int n)
Parameters
Type Name Description
int n
Returns
Type Description
JsonValue

implicit operator JsonValue(long)

Declaration
public static implicit operator JsonValue(long n)
Parameters
Type Name Description
long n
Returns
Type Description
JsonValue

implicit operator JsonValue(float)

Declaration
public static implicit operator JsonValue(float n)
Parameters
Type Name Description
float n
Returns
Type Description
JsonValue

implicit operator JsonValue(string)

Declaration
public static implicit operator JsonValue(string s)
Parameters
Type Name Description
string s
Returns
Type Description
JsonValue

Implements