Class RawBsonArray
Represents an immutable BSON array that is represented using only the raw bytes.
[BsonSerializer(typeof(RawBsonArraySerializer))]
public class RawBsonArray : BsonArray, IComparable<BsonValue>, IConvertible, IEquatable<BsonValue>, IComparable<BsonArray>, IEquatable<BsonArray>, IList<BsonValue>, ICollection<BsonValue>, IEnumerable<BsonValue>, IEnumerable, IDisposable- Inheritance
-
RawBsonArray
- Implements
- Inherited Members
- Extension Methods
Constructors
RawBsonArray(IByteBuffer)
Initializes a new instance of the RawBsonArray class.
public RawBsonArray(IByteBuffer slice)Parameters
sliceIByteBufferThe slice.
Exceptions
- ArgumentNullException
slice
- ArgumentException
RawBsonArray cannot be used with an IByteBuffer that needs disposing.
Properties
Capacity
Gets or sets the total number of elements the internal data structure can hold without resizing.
public override int Capacity { get; set; }Property Value
Count
Gets the count of array elements.
public override int Count { get; }Property Value
IsReadOnly
Gets whether the array is read-only.
public override bool IsReadOnly { get; }Property Value
this[int]
Gets or sets a value by position.
public override BsonValue this[int index] { get; set; }Parameters
indexintThe position.
Property Value
- BsonValue
The value.
RawValues
Gets the array elements as raw values (see BsonValue.RawValue).
[Obsolete("Use ToArray to ToList instead.")]
public override IEnumerable<object> RawValues { get; }Property Value
Slice
Gets the slice.
public IByteBuffer Slice { get; }Property Value
- IByteBuffer
The slice.
Values
Gets the array elements.
public override IEnumerable<BsonValue> Values { get; }Property Value
Methods
Add(BsonValue)
Adds an element to the array.
public override BsonArray Add(BsonValue value)Parameters
valueBsonValueThe value to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<BsonValue>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<BsonValue> values)Parameters
valuesIEnumerable<BsonValue>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<ObjectId>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<ObjectId> values)Parameters
valuesIEnumerable<ObjectId>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<bool>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<bool> values)Parameters
valuesIEnumerable<bool>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<DateTime>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<DateTime> values)Parameters
valuesIEnumerable<DateTime>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<double>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<double> values)Parameters
valuesIEnumerable<double>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<int>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<int> values)Parameters
valuesIEnumerable<int>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<long>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<long> values)Parameters
valuesIEnumerable<long>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable<string>)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable<string> values)Parameters
valuesIEnumerable<string>A list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
AddRange(IEnumerable)
Adds multiple elements to the array.
public override BsonArray AddRange(IEnumerable values)Parameters
valuesIEnumerableA list of values to add to the array.
Returns
- BsonArray
The array (so method calls can be chained).
Clear()
Clears the array.
public override void Clear()Clone()
Creates a shallow clone of the array (see also DeepClone).
public override BsonValue Clone()Returns
- BsonValue
A shallow clone of the array.
Contains(BsonValue)
Tests whether the array contains a value.
public override bool Contains(BsonValue value)Parameters
valueBsonValueThe value to test for.
Returns
- bool
True if the array contains the value.
CopyTo(BsonValue[], int)
Copies elements from this array to another array.
public override void CopyTo(BsonValue[] array, int arrayIndex)Parameters
arrayBsonValue[]The other array.
arrayIndexintThe zero based index of the other array at which to start copying.
CopyTo(object[], int)
Copies elements from this array to another array as raw values (see BsonValue.RawValue).
[Obsolete("Use ToArray or ToList instead.")]
public override void CopyTo(object[] array, int arrayIndex)Parameters
arrayobject[]The other array.
arrayIndexintThe zero based index of the other array at which to start copying.
DeepClone()
Creates a deep clone of the array (see also Clone).
public override BsonValue DeepClone()Returns
- BsonValue
A deep clone of the array.
Dispose()
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
public void Dispose()Dispose(bool)
Releases unmanaged and - optionally - managed resources.
protected virtual void Dispose(bool disposing)Parameters
disposingbooltrueto release both managed and unmanaged resources;falseto release only unmanaged resources.
GetEnumerator()
Gets an enumerator that can enumerate the elements of the array.
public override IEnumerator<BsonValue> GetEnumerator()Returns
- IEnumerator<BsonValue>
An enumerator.
IndexOf(BsonValue)
Gets the index of a value in the array.
public override int IndexOf(BsonValue value)Parameters
valueBsonValueThe value to search for.
Returns
- int
The zero based index of the value (or -1 if not found).
IndexOf(BsonValue, int)
Gets the index of a value in the array.
public override int IndexOf(BsonValue value, int index)Parameters
valueBsonValueThe value to search for.
indexintThe zero based index at which to start the search.
Returns
- int
The zero based index of the value (or -1 if not found).
IndexOf(BsonValue, int, int)
Gets the index of a value in the array.
public override int IndexOf(BsonValue value, int index, int count)Parameters
valueBsonValueThe value to search for.
indexintThe zero based index at which to start the search.
countintThe number of elements to search.
Returns
- int
The zero based index of the value (or -1 if not found).
Insert(int, BsonValue)
Inserts a new value into the array.
public override void Insert(int index, BsonValue value)Parameters
Materialize(BsonBinaryReaderSettings)
Materializes the RawBsonArray into a regular BsonArray.
public BsonArray Materialize(BsonBinaryReaderSettings binaryReaderSettings)Parameters
binaryReaderSettingsBsonBinaryReaderSettingsThe binary reader settings.
Returns
- BsonArray
A BsonArray.
Remove(BsonValue)
Removes the first occurrence of a value from the array.
public override bool Remove(BsonValue value)Parameters
valueBsonValueThe value to remove.
Returns
- bool
True if the value was removed.
RemoveAt(int)
Removes an element from the array.
public override void RemoveAt(int index)Parameters
indexintThe zero based index of the element to remove.
ThrowIfDisposed()
Throws if disposed.
protected void ThrowIfDisposed()Exceptions
ToArray()
Converts the BsonArray to an array of BsonValues.
public override BsonValue[] ToArray()Returns
- BsonValue[]
An array of BsonValues.
ToList()
Converts the BsonArray to a list of BsonValues.
public override List<BsonValue> ToList()Returns
ToString()
Returns a string representation of the array.
public override string ToString()Returns
- string
A string representation of the array.