클래스 RealmConfigurationBase

Realm의 동작에 영향을 주는 구성 설정을 지정하기 위한 기본 클래스입니다.
주요 역할은 절대, 상대 하위 디렉토리 또는 사용자가 제공하는 파일 이름에서 표준 경로를 생성하는 것입니다.

상속

객체

RealmConfigurationBase

InMemoryConfiguration

RealmConfiguration

SyncConfigurationBase

네임스페이스: Realms

어셈블리: Realm.exe

구문

public abstract class RealmConfigurationBase

속성

DatabasePath

이 구성으로 열린 Realm의 전체 경로를 가져옵니다. 별도의 이름을 전달하여 재정의할 수 있습니다.

선언

public string DatabasePath { get; }

속성 값

유형	설명
문자열	Realm의 절대 경로입니다.

DefaultRealmName

플랫폼별 문서 디렉토리와 결합할 파일 이름을 가져옵니다.

선언

public static string DefaultRealmName { get; }

속성 값

유형	설명
문자열	경로 없이 파일 이름만 나타내는 문자열입니다.

폴백 파이프 경로

Realm에서 사용하는 명명된 파이프를 배치할 수 있는 경로를 가져오거나 설정합니다.

선언

public string? FallbackPipePath { get; set; }

속성 값

유형	설명
문자열	명명된 파이프를 만들 수 있는 경로입니다.

비고

대부분의 경우 이 값은 null로 두어야 합니다. FAT32를 사용하는 Android의 외부 저장소와 같이 명명된 파이프를 만들 수 없는 파일 시스템에서 Realm이 열리는 경우 설정해야 합니다. 이 경우 점은 파이프가 생성될 수 있는 파일 시스템 위치를 파이프 합니다.

Is Dynamic

Realm을 동적 모드에서 열지 여부를 나타내는 값을 가져오거나 설정합니다. 동적 모드에서 열면 디스크의 파일에서 스키마를 읽습니다.

선언

public bool IsDynamic { get; set; }

속성 값

유형	설명
부울	true Realm이 동적 모드에서 열리는지 여부, 그렇지 않으면 false 입니다.

MaxNumberOfActiveVersions

예외가 발생하기 전에 허용되는 최대 활성 버전 수를 가져오거나 설정합니다.

선언

public ulong MaxNumberOfActiveVersions { get; set; }

속성 값

유형	설명
ulong

다음도 참조하세요.

동결()

스키마

이 구성으로 열린 Realm의 스키마를 가져오거나 설정합니다.

선언

public RealmSchema Schema { get; set; }

속성 값

유형	설명
Realm 스키마	Realm에서 지속될 수 있는 유형의 스키마입니다.

비고

일반적으로 null로 두면 기본적으로 모든 IRealmObject 및 IEmbeddedObject 인스턴스를 모든 Realm에 저장할 수 있습니다.
스키마를 명시적으로 지정하는 경우 Type[] 에서 RealmSchema 로의 암시적 변환 연산자를 사용하거나 RealmSchema.Builder API를 사용하여 구성할 수 있습니다.

예시

config.Schema = new Type[]
{
    typeof(CommonClass),
    typeof(RareClass)
};

// Alternatively
config.Schema = new RealmSchema.Builder
{
    new ObjectSchema.Builder("Person")
    {
        Property.Primitive("Name", RealmValueType.String, isPrimaryKey: true),
        Property.Primitive("Birthday", RealmValueType.Date, isNullable: true),
        Property.ObjectList("Addresses", objectType: "Address")
    },
    new ObjectSchema.Builder("Address")
    {
        Property.Primitive("City", RealmValueType.String),
        Property.Primitive("Street", RealmValueType.String),
    }
}

스키마 버전

스키마의 버전을 나타내는 숫자를 가져오거나 설정합니다. 동일한 객체와 속성을 가진 스키마라도 임의로 구분하는 데 사용할 수 있습니다.

선언

public ulong SchemaVersion { get; set; }

속성 값

유형	설명
ulong	0 기반 값은 처음에는 0으로 설정되므로 모든 사용자 설정 값이 커집니다.

ShouldCompactOnLaunch

실행 시 압축 콜백을 가져오거나 설정합니다.

선언

public RealmConfigurationBase.ShouldCompactDelegate? ShouldCompactOnLaunch { get; set; }

속성 값

유형	설명
RealmConfigurationBase.ShouldCompactDelegate	Realm 을 처음 열 때 사용자에게 반환되기 전에 압축해야 하는지 여부를 결정하기 위해 호출되는 RealmConfigurationBase.ShouldCompactDelegate 입니다.

방법

GetPathToRealm(문자열?)

Realm이 생성될 경로를 빌드하는 유틸리티로 파일 이름과 상대 경로를 일관되게 사용할 수 있습니다.

선언

public static string GetPathToRealm(string? optionalPath = null)

매개변수

유형	이름	설명
문자열	optionalPath	Realm의 경로는 현재 플랫폼, 상대 하위 디렉토리 또는 파일 이름에 대한 유효한 전체 경로여야 합니다.

반환

유형	설명
문자열	Realm 파일 이름을 포함한 전체 경로입니다.