Class Document (2.5.0)

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

A Firestore document.

Must not exceed 1 MiB - 4 bytes.

Inheritance

Object > Document

Namespace

Google.Cloud.Firestore.V1

Assembly

Google.Cloud.Firestore.V1.dll

Constructors

Document()

public Document()

Document(Document)

public Document(Document other)
Parameter
NameDescription
otherDocument

Properties

CreateTime

public Timestamp CreateTime { get; set; }

Output only. The time at which the document was created.

This value increases monotonically when a document is deleted then recreated. It can also be compared to values from other documents and the read_time of a query.

Property Value
TypeDescription
Timestamp

Fields

public MapField<string, Value> Fields { get; }

The document's fields.

The map keys represent field names.

A simple field name contains only characters a to z, A to Z, 0 to 9, or _, and must not start with 0 to 9. For example, foo_bar_17.

Field names matching the regular expression __.*__ are reserved. Reserved field names are forbidden except in certain documented contexts. The map keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty.

Field paths may be used in other contexts to refer to structured fields defined here. For map_value, the field path is represented by the simple or quoted field names of the containing fields, delimited by .. For example, the structured field &quot;foo&quot; : { map_value: { &quot;x&amp;y&quot; : { string_value: &quot;hello&quot; }}} would be represented by the field path foo.x&amp;y.

Within a field path, a quoted field name starts and ends with ` and may contain any character. Some characters, including ` , must be escaped using a \. For example, `x&amp;y` represents x&amp;y and `bak\`tik` represents bak`tik.

Property Value
TypeDescription
MapField<String, Value>

Name

public string Name { get; set; }

The resource name of the document, for example projects/{project_id}/databases/{database_id}/documents/{document_path}.

Property Value
TypeDescription
String

UpdateTime

public Timestamp UpdateTime { get; set; }

Output only. The time at which the document was last changed.

This value is initially set to the create_time then increases monotonically with each change to the document. It can also be compared to values from other documents and the read_time of a query.

Property Value
TypeDescription
Timestamp