Firebase.Database.FirebaseDatabase

The entry point for accessing a FirebaseDatabase.

Summary

The entry point for accessing a FirebaseDatabase. You can get an instance by calling DefaultInstance . To access a location in the database and read or write data, use GetReference()

Properties

App
Returns the Firebase.FirebaseApp instance to which this FirebaseDatabase belongs.
DefaultInstance
Gets the instance of FirebaseDatabase for the default Firebase.App.
LogLevel
By default, this is set to Info This includes any internal errors ( Error ) and any security debug messages ( Info ) that the client receives.
RootReference
Gets a DatabaseReference for the root location of this FirebaseDatabase.

Public static functions

GetInstance(FirebaseApp app)
Gets an instance of FirebaseDatabase for a specific Firebase.FirebaseApp.
GetInstance(String url)
Gets an instance of FirebaseDatabase for the specified URL.
GetInstance(FirebaseApp app, String url)
Gets a FirebaseDatabase instance for the specified URL, using the specified FirebsaeApp.

Public functions

GetReference(string path)
Gets a DatabaseReference for the provided path.
GetReferenceFromUrl(Uri url)
Gets a DatabaseReference for the provided URL.
GetReferenceFromUrl(string url)
Gets a DatabaseReference for the provided URL.
GoOffline()
void
Shuts down our connection to the FirebaseDatabase backend until GoOnline() is called.
GoOnline()
void
Resumes our connection to the FirebaseDatabase backend after a previous GoOffline() Call.
PurgeOutstandingWrites()
void
The FirebaseDatabase client automatically queues writes and sends them to the server at the earliest opportunity, depending on network connectivity.
SetPersistenceEnabled(bool enabled)
void
Sets whether pending write data will persist between application exits.

Properties

App

FirebaseApp App

Returns the Firebase.FirebaseApp instance to which this FirebaseDatabase belongs.

Details
Returns
The Firebase.FirebaseApp instance to which this FirebaseDatabase belongs.

DefaultInstance

static FirebaseDatabase DefaultInstance

Gets the instance of FirebaseDatabase for the default Firebase.App.

A FirebaseDatabase instance.

LogLevel

LogLevel LogLevel

By default, this is set to Info This includes any internal errors ( Error ) and any security debug messages ( Info ) that the client receives.

Set to Debug to turn on the diagnostic logging.

On Android this can only be set before any operations have been performed with the object.

The desired minimum log level

RootReference

DatabaseReference RootReference

Gets a DatabaseReference for the root location of this FirebaseDatabase.

A DatabaseReference instance.

Public static functions

GetInstance

FirebaseDatabase GetInstance(
  FirebaseApp app
)

Gets an instance of FirebaseDatabase for a specific Firebase.FirebaseApp.

Details
Parameters
app
Returns
A FirebaseDatabase instance.

GetInstance

FirebaseDatabase GetInstance(
  String url
)

Gets an instance of FirebaseDatabase for the specified URL.

Details
Parameters
url
The URL to the FirebaseDatabase instance you want to access.
Returns
A FirebaseDatabase instance.

GetInstance

FirebaseDatabase GetInstance(
  FirebaseApp app,
  String url
)

Gets a FirebaseDatabase instance for the specified URL, using the specified FirebsaeApp.

Details
Parameters
app
url
The URL to the FirebaseDatabase instance you want to access.
Returns
A FirebaseDatabase instance.

Public functions

GetReference

DatabaseReference GetReference(
  string path
)

Gets a DatabaseReference for the provided path.

Details
Parameters
path
Path to a location in your FirebaseDatabase.
Returns
A DatabaseReference pointing to the specified path.

GetReferenceFromUrl

DatabaseReference GetReferenceFromUrl(
  Uri url
)

Gets a DatabaseReference for the provided URL.

Gets a DatabaseReference for the provided URL. The URL must be a URL to a path within this FirebaseDatabase. To create a DatabaseReference to a different database, create a Firebase.FirebaseApp with a Firebase.FirebaseOptions

object configured with the appropriate database URL.

Details
Parameters
url
A URL to a path within your database.
Returns
A DatabaseReference for the provided URL.

GetReferenceFromUrl

DatabaseReference GetReferenceFromUrl(
  string url
)

Gets a DatabaseReference for the provided URL.

Gets a DatabaseReference for the provided URL. The URL must be a URL to a path within this FirebaseDatabase. To create a DatabaseReference to a different database, create a Firebase.FirebaseApp with a Firebase.FirebaseOptions

object configured with the appropriate database URL.

Details
Parameters
url
A URL to a path within your database.
Returns
A DatabaseReference for the provided URL.

GoOffline

void GoOffline()

Shuts down our connection to the FirebaseDatabase backend until GoOnline() is called.

GoOnline

void GoOnline()

Resumes our connection to the FirebaseDatabase backend after a previous GoOffline() Call.

PurgeOutstandingWrites

void PurgeOutstandingWrites()

The FirebaseDatabase client automatically queues writes and sends them to the server at the earliest opportunity, depending on network connectivity.

The FirebaseDatabase client automatically queues writes and sends them to the server at the earliest opportunity, depending on network connectivity. In some cases (e.g. offline usage) there may be a large number of writes waiting to be sent. Calling this method will purge all outstanding writes so they are abandoned. All writes will be purged, including transactions and DatabaseReference.OnDisconnect() writes. The writes will be rolled back locally, perhaps triggering events for affected event listeners, and the client will not (re-)send them to the Firebase backend.

SetPersistenceEnabled

void SetPersistenceEnabled(
  bool enabled
)

Sets whether pending write data will persist between application exits.

The FirebaseDatabase client will cache synchronized data and keep track of all writes you've initiated while your application is running. It seamlessly handles intermittent network connections and re-sends write operations when the network connection is restored. However by default your write operations and cached data are only stored in-memory and will be lost when your app restarts. By setting this value to true, the data will be persisted to on-device (disk) storage and will thus be available again when the app is restarted (even when there is no network connectivity at that time).

Note:SetPersistenceEnabled should be called before creating any instances of DatabaseReference, and only needs to be called once per application.

Details
Parameters
enabled
Set this to true to persist write data to on-device (disk) storage, or false to discard pending writes when the app exists.