Google Cloud Datastore v1 API - Class ArrayValue (4.4.0)

public sealed class ArrayValue : IMessage<ArrayValue>, IEquatable<ArrayValue>, IDeepCloneable<ArrayValue>, IBufferMessage, IMessage

Reference documentation and code samples for the Google Cloud Datastore v1 API class ArrayValue.

An array value.

Inheritance

Object > ArrayValue

Namespace

Google.Cloud.Datastore.V1

Assembly

Google.Cloud.Datastore.V1.dll

Constructors

ArrayValue()

public ArrayValue()

ArrayValue(ArrayValue)

public ArrayValue(ArrayValue other)
Parameter
NameDescription
otherArrayValue

Properties

Values

public RepeatedField<Value> Values { get; }

Values in the array. The order of values in an array is preserved as long as all values have identical settings for 'exclude_from_indexes'.

Property Value
TypeDescription
RepeatedField<Value>

Operators

Explicit(ArrayValue to ArrayValue[])

public static explicit operator ArrayValue[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
ArrayValue[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Entity[])

public static explicit operator Entity[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Entity[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Key[])

public static explicit operator Key[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Key[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Value[])

public static explicit operator Value[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Value[]

An array with converted values, or null if arrayValue is null.

Explicit(ArrayValue to ByteString[])

public static explicit operator ByteString[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
ByteString[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Timestamp[])

public static explicit operator Timestamp[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Timestamp[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to LatLng[])

public static explicit operator LatLng[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
LatLng[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Boolean[])

public static explicit operator bool[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Boolean[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Byte[][])

public static explicit operator byte[][](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Byte[][]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to DateTime[])

public static explicit operator DateTime[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
DateTime[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to DateTimeOffset[])

public static explicit operator DateTimeOffset[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
DateTimeOffset[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Double[])

public static explicit operator double[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Double[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Int64[])

public static explicit operator long[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Int64[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Nullable<Boolean>[])

public static explicit operator bool? [](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Nullable<Boolean>[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Nullable<DateTime>[])

public static explicit operator DateTime? [](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Nullable<DateTime>[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Nullable<DateTimeOffset>[])

public static explicit operator DateTimeOffset? [](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Nullable<DateTimeOffset>[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Nullable<Double>[])

public static explicit operator double? [](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Nullable<Double>[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to Nullable<Int64>[])

public static explicit operator long? [](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
Nullable<Int64>[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Explicit(ArrayValue to String[])

public static explicit operator string[](ArrayValue arrayValue)

Converts an ArrayValue to an array. Each value within arrayValue is converted to a Value using the individual explicit conversion. Any Value elements with a kind of Null are converted to null values in the resulting array.

Parameter
NameDescription
arrayValueArrayValue

The array value to convert.

Returns
TypeDescription
String[]

An array with converted values, or null if arrayValue is null.

Exceptions
TypeDescription
InvalidOperationException

An element in the array value does not have the expected kind.

Implicit(ArrayValue[] to ArrayValue)

public static implicit operator ArrayValue(ArrayValue[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesArrayValue[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Entity[] to ArrayValue)

public static implicit operator ArrayValue(Entity[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesEntity[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Key[] to ArrayValue)

public static implicit operator ArrayValue(Key[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesKey[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Value[] to ArrayValue)

public static implicit operator ArrayValue(Value[] values)

Converts an array to an ArrayValue instance. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesValue[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(ByteString[] to ArrayValue)

public static implicit operator ArrayValue(ByteString[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesByteString[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Timestamp[] to ArrayValue)

public static implicit operator ArrayValue(Timestamp[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesTimestamp[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(LatLng[] to ArrayValue)

public static implicit operator ArrayValue(LatLng[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesLatLng[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Boolean[] to ArrayValue)

public static implicit operator ArrayValue(bool[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion.

Parameter
NameDescription
valuesBoolean[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Byte[][] to ArrayValue)

public static implicit operator ArrayValue(byte[][] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesByte[][]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(DateTime[] to ArrayValue)

public static implicit operator ArrayValue(DateTime[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion.

Parameter
NameDescription
valuesDateTime[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(DateTimeOffset[] to ArrayValue)

public static implicit operator ArrayValue(DateTimeOffset[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion.

Parameter
NameDescription
valuesDateTimeOffset[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Double[] to ArrayValue)

public static implicit operator ArrayValue(double[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion.

Parameter
NameDescription
valuesDouble[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Int64[] to ArrayValue)

public static implicit operator ArrayValue(long[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion.

Parameter
NameDescription
valuesInt64[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Nullable<Boolean>[] to ArrayValue)

public static implicit operator ArrayValue(bool? [] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesNullable<Boolean>[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Nullable<DateTime>[] to ArrayValue)

public static implicit operator ArrayValue(DateTime? [] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesNullable<DateTime>[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Nullable<DateTimeOffset>[] to ArrayValue)

public static implicit operator ArrayValue(DateTimeOffset? [] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesNullable<DateTimeOffset>[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Nullable<Double>[] to ArrayValue)

public static implicit operator ArrayValue(double? [] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesNullable<Double>[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(Nullable<Int64>[] to ArrayValue)

public static implicit operator ArrayValue(long? [] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesNullable<Int64>[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.

Implicit(String[] to ArrayValue)

public static implicit operator ArrayValue(string[] values)

Converts an array to an ArrayValue instance. Each value within values is converted to a Value using the individual implicit conversion. Any null input values are converted to instances of Value with a kind of Null.

Parameter
NameDescription
valuesString[]

The array to convert.

Returns
TypeDescription
ArrayValue

An ArrayValue with converted values, or null if values is null.