클래스 FrozenObjectsExtensions

RealmObjectBase를 기반으로 하는 확장 메서드 세트입니다.

상속

객체

FrozenObjectsExtensions

네임스페이스: Realms

어셈블리: Realm.exe

구문

public static class FrozenObjectsExtensions

방법

동결<TValue>(IDictionary<string, TValue>)

이 딕셔너리의 동결된 스냅샷을 생성합니다. 동결된 사본은 모든 스레드에서 읽을 수 있습니다. 사전이 managed, a RealmException 이 발생합니다.

사전을 동결하면 자체 라이프사이클이 있는 동결된 Realm도 생성되지만, 원래 세트를 생성한 라이브 Realm이 완전히 닫힌 경우(예: (모든 스레드의 모든 인스턴스가 닫힙니다), 동결된 Realm과 사전도 닫힙니다.

동결된 사전은 정상적으로 읽고 반복할 수 있지만 어떤 방식으로든 변경하거나 알림을 구독하려고 하면 RealmFrozenException 이 발생합니다.

참고: 버전이 다른 많은 수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 MaxNumberOfActiveVersions 를 설정할 수 있습니다.

선언

public static IDictionary<string, TValue> Freeze<TValue>(this IDictionary<string, TValue> dictionary)

매개변수

유형	이름	설명
IDictionary<string, TValue>	사전	동결된 사본을 생성하려는 사전입니다.

반환

유형	설명
IDictionary<string, TValue>	이 사전의 동결된 사본입니다.

유형 매개변수

이름	설명
TValue	딕셔너리에 저장된 값의 유형입니다.

동결<T>(IList<T>)

이 목록의 동결된 스냅샷을 생성합니다. 동결된 사본은 모든 스레드에서 읽고 반복할 수 있습니다. 목록이 managed되지 않으면 RealmException 이 발생합니다.

목록을 동결하면 자체 수명 주기가 있는 동결된 Realm도 생성되지만, 원래 목록을 생성한 라이브 Realm이 완전히 닫힌 경우(예: (모든 스레드의 모든 인스턴스가 닫힙니다), 동결된 Realm과 목록도 닫힙니다.

동결 목록은 정상적으로 읽고 반복할 수 있지만 어떤 방식으로든 변경하거나 알림을 구독하려고 하면 RealmFrozenException 이 발생합니다.

참고: 버전이 다른 많은 수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 MaxNumberOfActiveVersions 를 설정할 수 있습니다.

선언

public static IList<T> Freeze<T>(this IList<T> list)

매개변수

유형	이름	설명
IList<T>	목록	동결된 사본을 생성하려는 목록입니다.

반환

유형	설명
IList<T>	이 목록의 동결된 사본입니다.

유형 매개변수

이름	설명
t	목록에 있는 요소의 유형입니다.

동결<T>(ISet<T>)

이 세트의 동결된 스냅샷을 생성합니다. 동결된 사본은 모든 스레드에서 읽을 수 있습니다. If the set is not managed, a RealmException will be thrown.

세트를 동결하면 자체 라이프사이클이 있는 동결된 Realm도 생성되지만, 원래 세트를 생성한 라이브 Realm이 완전히 닫힌 경우(예: (모든 스레드의 모든 인스턴스가 닫힙니다), 동결된 Realm과 세트도 닫힙니다.

동결 세트는 정상적으로 읽고 반복할 수 있지만 어떤 방식으로든 변경하거나 알림을 구독하려고 하면 RealmFrozenException 이 발생합니다.

참고: 버전이 다른 많은 수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 MaxNumberOfActiveVersions 를 설정할 수 있습니다.

선언

public static ISet<T> Freeze<T>(this ISet<T> set)

매개변수

유형	이름	설명
ISet<T>	세트	동결된 사본을 생성하려는 세트입니다.

반환

유형	설명
ISet<T>	이 세트의 동결된 사본입니다.

유형 매개변수

이름	설명
t	세트에 있는 요소의 유형입니다.

동결<T>(IQueryable<T>)

이 쿼리의 동결된 스냅샷을 생성합니다. 동결된 사본은 모든 스레드에서 읽고 쿼리할 수 있습니다. 쿼리가 managed 되지 않는 경우(예: All<T>() 호출의 결과가 아닌 경우) RealmException 이 발생합니다.

쿼리를 동결하면 자체 라이프사이클이 있는 동결된 Realm도 생성되지만, 원래 쿼리를 생성한 라이브 Realm이 완전히 닫힌 경우(예: (모든 스레드의 모든 인스턴스가 닫힙니다), 동결된 Realm과 쿼리도 닫힙니다.

동결된 쿼리는 정상적으로 읽고 반복할 수 있지만 어떤 방식으로든 변경하거나 알림을 구독하려고 하면 RealmFrozenException 이 발생합니다.

참고: 버전이 다른 많은 수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 MaxNumberOfActiveVersions 를 설정할 수 있습니다.

선언

public static IQueryable<T> Freeze<T>(this IQueryable<T> query) where T : IRealmObjectBase

매개변수

유형	이름	설명
IQueryable<T>	쿼리	동결된 사본을 생성하려는 쿼리입니다.

반환

유형	설명
IQueryable<T>	이 쿼리의 동결된 사본입니다.

유형 매개변수

이름	설명
t	쿼리에 있는 요소의 유형입니다.

동결<T>(T)

이 객체의 동결된 스냅샷을 반환합니다. 동결된 사본은 예외를 발생시키지 않고 모든 스레드에서 읽고 쿼리할 수 있습니다.

RealmObjectBase를 동결하면 자체 라이프사이클이 있는 동결된 Realm도 생성되지만, 원래 객체를 생성한 라이브 Realm이 완전히 닫힌 경우(즉, (모든 스레드의 모든 인스턴스가 닫힙니다), 동결된 Realm과 객체도 닫힙니다.

동결된 객체는 정상적으로 쿼리할 수 있지만 어떤 방식으로든 변경하거나 알림을 구독하려고 하면 RealmFrozenException 이 발생합니다.

참고: 버전이 다른 많은 수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 MaxNumberOfActiveVersions 를 설정할 수 있습니다.

선언

public static T Freeze<T>(this T realmObj) where T : IRealmObjectBase

매개변수

유형	이름	설명
t	realmObj	동결 버전을 생성하려는 IRealmObject, IEmbeddedObject 또는 IAsymmetricObject 인스턴스입니다.

반환

유형	설명
t	전달된 객체 또는 이미 동결된 경우 객체 자체의 새로운 동결 인스턴스입니다.

유형 매개변수

이름	설명
t	IRealmObject/IEmbeddedObject/IAsymmetricObject 의 유형입니다.