Skip to main content

Definition

Assembly: CloudNimble.BlazorEssentials.TursoDb.dll Namespace: CloudNimble.BlazorEssentials.TursoDb Inheritance: CloudNimble.BlazorEssentials.TursoDb.TursoDatabase

Syntax

Summary

Base class for sync-enabled Turso databases. Extends TursoDatabase with Turso Cloud synchronization capabilities (pull, push, sync).

Examples

Constructors

.ctor Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Initializes a new instance of the TursoDatabase class.

Syntax

Parameters

Exceptions

.ctor Inherited

Inherited from object

Syntax

Properties

AuthToken Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets or sets the authentication token for remote Turso databases.

Syntax

Property Value

Type: string?

AutoCreateSchema Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets or sets whether to automatically create tables on connect.

Syntax

Property Value

Type: bool

DbSets Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets the list of DbSets in this database.

Syntax

Property Value

Type: System.Collections.Generic.List<CloudNimble.BlazorEssentials.TursoDb.ITursoDbSet>

EncryptionEnabled

Gets or sets whether encryption is enabled for the local database.

Syntax

Property Value

Type: bool

EncryptionKey

Gets or sets the encryption key for the local database.

Syntax

Property Value

Type: string?

IsConnected Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets whether the database is currently connected.

Syntax

Property Value

Type: bool

IsSyncing

Gets whether a sync operation is currently in progress.

Syntax

Property Value

Type: bool

Name Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets or sets the database name/identifier. This is used as the connection key in JavaScript.

Syntax

Property Value

Type: string

SyncAuthToken

Gets or sets the authentication token for Turso Cloud sync.

Syntax

Property Value

Type: string

SyncIntervalMs

Gets or sets the sync interval in milliseconds. Set to 0 to disable automatic periodic sync. Default is 0.

Syntax

Property Value

Type: int

SyncOnConnect

Gets or sets whether to sync on connect. Default is true.

Syntax

Property Value

Type: bool

SyncUrl

Gets or sets the sync URL for Turso Cloud. This is typically in the format: libsql://[database-name]-[org-name].turso.io

Syntax

Property Value

Type: string

Url Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Gets or sets the database URL. Use “:memory:” for in-memory, “file:name.db” for local file, or a Turso cloud URL.

Syntax

Property Value

Type: string

Methods

BeginTransactionAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Begins a new database transaction.

Syntax

Returns

Type: System.Threading.Tasks.Task<CloudNimble.BlazorEssentials.TursoDb.TursoTransaction> A transaction that can be committed or rolled back.

Examples

CallJavaScriptAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Calls a JavaScript function in the Turso module.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task

CallJavaScriptAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Calls a JavaScript function in the Turso module and returns the result.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task<TResult>

ConnectAsync

Connects to the database with sync support. If TursoSyncDatabase.SyncOnConnect is true, performs an initial sync after connecting.

Syntax

Returns

Type: System.Threading.Tasks.Task

ConnectAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Connects to the database.

Syntax

Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous operation.

DisconnectAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Disconnects from the database.

Syntax

Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous operation.

DisposeAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase

Syntax

Returns

Type: System.Threading.Tasks.ValueTask

EnsureConnectedAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Ensures the database is connected, connecting if necessary.

Syntax

Returns

Type: System.Threading.Tasks.Task

Equals Inherited Virtual

Inherited from object

Syntax

Parameters

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

ExecuteAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Executes a SQL statement and returns the result.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task<CloudNimble.BlazorEssentials.TursoDb.TursoResult> The execution result.

ExecuteBatchAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Executes multiple SQL statements in a batch.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task<System.Collections.Generic.List<CloudNimble.BlazorEssentials.TursoDb.TursoResult>> The results of each statement.

GetHashCode Inherited Virtual

Inherited from object

Syntax

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

Returns

Type: System.Type

MemberwiseClone Inherited

Inherited from object

Syntax

Returns

Type: object

Prepare Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Creates a prepared statement for queries that return results.

Syntax

Parameters

Returns

Type: CloudNimble.BlazorEssentials.TursoDb.TursoPreparedStatement<TResult> A prepared statement that can be executed multiple times.

Type Parameters

  • TResult - The type of result returned by the query.

Prepare Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Creates a prepared statement for non-query commands.

Syntax

Parameters

Returns

Type: CloudNimble.BlazorEssentials.TursoDb.TursoPreparedStatement A prepared statement that can be executed multiple times.

PullAsync

Pulls changes from Turso Cloud to the local database. This downloads any changes made on other devices or the cloud.

Syntax

Returns

Type: System.Threading.Tasks.Task<CloudNimble.BlazorEssentials.TursoDb.TursoSyncResult> The sync result containing the number of frames synced.

PushAsync

Pushes local changes to Turso Cloud. This uploads any local changes to the cloud for other devices to sync.

Syntax

Returns

Type: System.Threading.Tasks.Task<CloudNimble.BlazorEssentials.TursoDb.TursoSyncResult> The sync result containing the number of frames synced.

QueryAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Executes a SQL query and returns all matching rows.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task<System.Collections.Generic.List<T>> A list of results.

Type Parameters

  • T - The type to deserialize results into.

QuerySingleAsync Inherited

Inherited from CloudNimble.BlazorEssentials.TursoDb.TursoDatabase
Executes a SQL query and returns the first matching row or null.

Syntax

Parameters

Returns

Type: System.Threading.Tasks.Task<T?> The first result or default.

Type Parameters

  • T - The type to deserialize the result into.

ReferenceEquals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

SyncAsync

Performs a bidirectional sync with Turso Cloud. This combines pull and push operations.

Syntax

Returns

Type: System.Threading.Tasks.Task<CloudNimble.BlazorEssentials.TursoDb.TursoSyncResult> The sync result containing the number of frames synced.

ToString Inherited Virtual

Inherited from object

Syntax

Returns

Type: string?

Events

SyncCompleted

Occurs when a sync operation completes successfully.

Syntax

SyncFailed

Occurs when a sync operation fails.

Syntax

SyncStarted

Occurs when a sync operation starts.

Syntax

  • System.IAsyncDisposable