Class CollectionReference (2.5.0)

public sealed class CollectionReference : Query, IEquatable<Query>, IEquatable<CollectionReference>, IComparable<CollectionReference>

A reference to a collection in a Firestore database. The existence of this object does not imply that the collection currently exists in storage.

Inheritance

Object > Query > CollectionReference

Implements

IEquatable<Query>, IEquatable<CollectionReference>, IComparable<CollectionReference>

Inherited Members

Query.Database

Query.Select(String[])

Query.Select(FieldPath[])

Query.WhereEqualTo(String, Object)

Query.WhereEqualTo(FieldPath, Object)

Query.WhereNotEqualTo(String, Object)

Query.WhereNotEqualTo(FieldPath, Object)

Query.WhereLessThan(String, Object)

Query.WhereLessThan(FieldPath, Object)

Query.WhereLessThanOrEqualTo(String, Object)

Query.WhereLessThanOrEqualTo(FieldPath, Object)

Query.WhereGreaterThan(String, Object)

Query.WhereGreaterThan(FieldPath, Object)

Query.WhereGreaterThanOrEqualTo(String, Object)

Query.WhereGreaterThanOrEqualTo(FieldPath, Object)

Query.WhereArrayContains(String, Object)

Query.WhereArrayContains(FieldPath, Object)

Query.WhereArrayContainsAny(String, IEnumerable)

Query.WhereArrayContainsAny(FieldPath, IEnumerable)

Query.WhereIn(String, IEnumerable)

Query.WhereIn(FieldPath, IEnumerable)

Query.WhereNotIn(String, IEnumerable)

Query.WhereNotIn(FieldPath, IEnumerable)

Query.OrderBy(String)

Query.OrderByDescending(String)

Query.OrderBy(FieldPath)

Query.OrderByDescending(FieldPath)

Query.Limit(Int32)

Query.LimitToLast(Int32)

Query.Offset(Int32)

Query.StartAt(Object[])

Query.StartAfter(Object[])

Query.EndBefore(Object[])

Query.EndAt(Object[])

Query.StartAt(DocumentSnapshot)

Query.StartAfter(DocumentSnapshot)

Query.EndBefore(DocumentSnapshot)

Query.EndAt(DocumentSnapshot)

Query.GetSnapshotAsync(CancellationToken)

Query.StreamAsync(CancellationToken)

Query.Listen(Func<QuerySnapshot, CancellationToken, Task>, CancellationToken)

Query.Listen(Action<QuerySnapshot>, CancellationToken)

Object.GetType()

Object.MemberwiseClone()

Namespace

Google.Cloud.Firestore

Assembly

Google.Cloud.Firestore.dll

Properties

Id

public string Id { get; }

The final part of the complete collection path; this is the identity of the collection relative to its parent document.

Property Value
Type	Description
`String`

Parent

public DocumentReference Parent { get; }

The parent document, or null if this is a root collection.

Property Value
Type	Description
`DocumentReference`

Path

public string Path { get; }

The complete collection path, including project and database ID.

Property Value
Type	Description
`String`

Methods

AddAsync(Object, CancellationToken)

public Task<DocumentReference> AddAsync(object documentData, CancellationToken cancellationToken = default(CancellationToken))

Asynchronously creates a document with the given data in this collection. The document has a randomly generated ID.

Parameters
Name	Description
`documentData`	`Object` The data for the document. Must not be null.
`cancellationToken`	`CancellationToken` A cancellation token to monitor for the asynchronous operation.

Returns
Type	Description
`Task<DocumentReference>`	The reference for the newly-created document.

Remarks

If the WriteResult for the operation is required, use CreateAsync(Object, CancellationToken) instead of this method.

CompareTo(CollectionReference)

public int CompareTo(CollectionReference other)

Parameter
Name	Description
`other`	`CollectionReference`

Returns
Type	Description
`Int32`

Document()

public DocumentReference Document()

Creates a DocumentReference for a direct child document of this collection with a random ID. This performs no server-side operations; it only generates the appropriate DocumentReference.

Returns
Type	Description
`DocumentReference`	A DocumentReference to a child document of this collection with a random ID.

Document(String)

public DocumentReference Document(string path)

Creates a DocumentReference for a child document of this reference.

Parameter
Name	Description
`path`	`String` The path to the document, relative to this collection. Must not be null, and must contain an odd number of slash-separated path elements.

Returns
Type	Description
`DocumentReference`	A DocumentReference for the specified document.

GetHashCode()

public override int GetHashCode()

Returns
Type	Description
`Int32`

Overrides

Query.GetHashCode()

ListDocumentsAsync()

public IAsyncEnumerable<DocumentReference> ListDocumentsAsync()

Lists the documents in this collection. The results include documents which don't exist in their own right, but which have nested documents which do exist.

Returns
Type	Description
`IAsyncEnumerable<DocumentReference>`	A lazily-iterated sequence of document references within this collection.

ToString()

public override string ToString()

Returns
Type	Description
`String`

Overrides

Object.ToString()