クラス FrozenObjectsExtentions
RealmObjectBase 上の拡張メソッドのセット。
Namespace: Realms
組み立て: Realm.dll
構文
public static class FrozenObjectsExtensions
メソッド
| このページを編集 ソースを表示<TValue>string
この辞書の固定スナップショットを作成します。 固定されたコピーは、どのスレッドからでも読み取ることができます。 辞書が管理されていない場合は、 RealmExceptionがスローされます。
辞書を固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のセットを生成したライブ Realm が完全に閉じている場合(つまり 全スレッドにわたるすべての インスタンスが閉じられます)。固定された Realm と辞書も閉じられます。 凍結された辞書は通常どおり読み取り、反復処理できますが、何らかの方法でミューテーションを試みたり、通知をサブスクライブしようとすると、 RealmFrozenExceptionがスローされます。 注: 異なるバージョンを持つ多数の固定オブジェクトを有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 MaxNumberOfActiveVersionsを設定します。宣言
public static IDictionary<string, TValue> Freeze<TValue>(this IDictionary<string, TValue> dictionary)
パラメーター
タイプ | 名前 | 説明 |
---|---|---|
IDictionary < string , TValue> | dictionary | 固定されたコピーを作成する辞書。 |
戻り値
タイプ | 説明 |
---|---|
IDictionary < string , TValue> | この辞書の固定コピー。 |
型パラメータ
名前 | 説明 |
---|---|
TValue | 辞書に保存されている値の型。 |
<T>フリーズ<T>
このリストの固定スナップショットを作成します。 固定されたコピーは、任意のスレッドから読み取って反復処理できます。 リストが管理されていない場合は、 RealmExceptionがスローされます。
リストを固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のリストを生成したライブ Realm が完全に閉じている場合(つまり 全スレッドにわたるすべての インスタンスが閉じられます)。固定された Realm とリストも閉じられます。 凍結されたリストは通常どおり読み取り、反復処理できますが、何らかの方法で変更しようとしたり、通知をサブスクライブしようとすると、 RealmFrozenExceptionがスローされます。 注: 異なるバージョンを持つ多数の固定オブジェクトを有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 MaxNumberOfActiveVersionsを設定します。宣言
public static IList<T> Freeze<T>(this IList<T> list)
パラメーター
タイプ | 名前 | 説明 |
---|---|---|
IList <T> | list | 固定コピーを作成するリスト。 |
戻り値
タイプ | 説明 |
---|---|
IList <T> | このリストの固定コピー。 |
型パラメータ
名前 | 説明 |
---|---|
t | リスト内の要素のタイプ。 |
Freeze<T>(ISet<T>)
このセットの固定スナップショットを作成します。 固定されたコピーは、どのスレッドからでも読み取ることができます。 セットが管理されていない場合は、 RealmExceptionがスローされます。
セットを固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のセットを生成したライブ Realm が完全に閉じている場合(つまり 全スレッドにわたるすべての インスタンスが閉じられます)。固定された Realm と セットも閉じられます。 凍結されたセットは通常どおり読み取り、反復処理できますが、何らかの方法で変更しようとしたり、通知をサブスクライブしようとしたりすると、 RealmFrozenExceptionがスローされます。 注: 異なるバージョンを持つ多数の固定オブジェクトを有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 MaxNumberOfActiveVersionsを設定します。宣言
public static ISet<T> Freeze<T>(this ISet<T> set)
パラメーター
タイプ | 名前 | 説明 |
---|---|---|
ISet<T> | セット | 固定コピーを作成するセット。 |
戻り値
タイプ | 説明 |
---|---|
ISet<T> | このセットの固定コピー。 |
型パラメータ
名前 | 説明 |
---|---|
t | セット内の要素の型。 |
Fize%<T><T>
このクエリの固定スナップショットを作成します。 固定されたコピーは、任意のスレッドから読み取ってクエリを実行できます。 クエリが管理されていない場合(つまり、 ハードウェア <T>メトリクス を収集できるようにし ます 。
クエリをフリーズすると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のクエリを生成したライブ Realm が完全に閉じている場合(つまり 全スレッドにわたるすべての インスタンスが閉じられます)。固定された Realm とクエリも閉じられます。 凍結されたクエリは通常どおり読み取り、反復処理できますが、何らかの方法でミューテーションを試みたり、通知をサブスクライブしようとすると、 RealmFrozenExceptionがスローされます。 注: 異なるバージョンを持つ多数の固定オブジェクトを有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 MaxNumberOfActiveVersionsを設定します。宣言
public static IQueryable<T> Freeze<T>(this IQueryable<T> query) where T : IRealmObjectBase
パラメーター
タイプ | 名前 | 説明 |
---|---|---|
IQueryable <T> | クエリ | 固定コピーを作成するクエリ。 |
戻り値
タイプ | 説明 |
---|---|
IQueryable <T> | このクエリの固定コピー。 |
型パラメータ
名前 | 説明 |
---|---|
t | クエリ内の要素の型。 |
freeze=T=(T)<T>
このオブジェクトの固定スナップショットを返します。 固定されたコピーは、例外をスローすることなく、任意のスレッドから読み取りとクエリを実行できます。
RealmObjectBase を固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のオブジェクトを生成したライブ Realm が完全に閉じている場合(つまり 全スレッドにわたるすべての インスタンスが閉じられます)。固定された Realm と オブジェクトも閉じられます。 凍結されたオブジェクトは通常どおりクエリできますが、それを何らかの方法で変更しようとしたり、通知をサブスクライブしようとするとRealmFrozenExceptionがスローされます。 注: 異なるバージョンを持つ多数の固定オブジェクトを有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 MaxNumberOfActiveVersionsを設定します。宣言
public static T Freeze<T>(this T realmObj) where T : IRealmObjectBase
パラメーター
タイプ | 名前 | 説明 |
---|---|---|
t | realmObj | 固定バージョンを作成するIRealmObject 、 IEMededObject 、またはIAmetricObjectインスタンス。 |
戻り値
タイプ | 説明 |
---|---|
t | オブジェクトで渡された の新しい固定インスタンス、またはオブジェクトがすでに固定されている場合はそれ自体。 |
型パラメータ
名前 | 説明 |
---|---|
t |