클래스 AppConfiguration

앱 의 구성 옵션을 노출하는 클래스입니다.

상속

객체

AppConfiguration

네임스페이스: Realms.동기화

어셈블리: Realm.exe

구문

public class AppConfiguration

생성자

AppConfiguration(string)

지정된 appId 을(를) 사용하여 AppConfiguration 클래스의 새 인스턴스를 초기화합니다.

선언

public AppConfiguration(string appId)

매개변수

유형	이름	설명
문자열	appId	Atlas App Services 애플리케이션 ID입니다.

속성

appId

Realm 애플리케이션을 식별하는 고유한 애플리케이션 ID를 가져옵니다.

선언

public string AppId { get; }

속성 값

유형	설명
문자열	Atlas App Services 앱의 ID입니다.

BaseFilePath

이 애플리케이션의 모든 로컬 데이터가 저장될 루트 폴더를 가져오거나 설정합니다. 이 데이터에는 사용자 및 동기화된 Realm에 대한 메타데이터가 포함됩니다.

선언

public string BaseFilePath { get; set; }

속성 값

유형	설명
문자열	앱의 기본 경로입니다.

BaseUri

이 Realm 애플리케이션의 기본 URL을 가져오거나 설정합니다.

선언

public Uri BaseUri { get; set; }

속성 값

유형	설명
Uri	앱의 기본 URL입니다.

비고

어떤 이유로든 애플리케이션 이 서비스에서 호스팅되지 않는 경우에만 설정하다 하면 됩니다. cloud.mongodb.com. 이는 일반적으로 에지 서버 와 동기화할 때 발생합니다.

DefaultRequestTimeout

MongoDB Atlas에 대한 HTTP 요청에 대한 기본 요청 시간 제한을 가져오거나 설정합니다. 기본값은 1분입니다.

선언

public TimeSpan DefaultRequestTimeout { get; set; }

속성 값

유형	설명
Timespan	기본 HTTP 요청 시간 초과입니다.

HttpClientHandler

MongoDB Atlas에 대한 http 요청에 사용될 HttpMessageHandler 를 가져오거나 설정합니다.

선언

public HttpMessageHandler? HttpClientHandler { get; set; }

속성 값

유형	설명
HttpMessageHandler	인증서 및 프록시 설정 등을 구성하는 http 클라이언트 핸들러입니다.

비고

이를 사용하여 기본 http 클라이언트 핸들러를 재정의하고 프록시, 클라이언트 인증서, 쿠키와 같은 설정을 구성할 수 있습니다. 정상적인 상황에서는 MongoDB Atlas에 연결하는 데 필요하지 않지만 클라이언트 장치가 회사 방화벽 뒤에 있거나 더 복잡한 네트워킹 설정을 사용하는 경우 유용할 수 있습니다.

LocalAppName

로컬 앱의 이름을 가져오거나 설정합니다.

선언

[Obsolete("This property has no effect and will be removed in a future version.")]
public string? LocalAppName { get; set; }

속성 값

유형	설명
문자열	현재 클라이언트 애플리케이션을 식별하는 친숙한 이름입니다.

LocalAppVersion

로컬 앱의 버전을 가져오거나 설정합니다.

선언

[Obsolete("This property has no effect and will be removed in a future version.")]
public string? LocalAppVersion { get; set; }

속성 값

유형	설명
문자열	클라이언트 애플리케이션의 버전입니다.

다음도 참조하세요.

LocalAppName

메타데이터 암호화 키

이 기기의 사용자 메타데이터에 대한 암호화 키를 가져오거나 설정합니다.

선언

public byte[]? MetadataEncryptionKey { get; set; }

속성 값

유형	설명
바이트[]	사용자 메타데이터 암호화 키입니다.

비고

개별 Realm의 암호화 키는 변경되지 않습니다. Realm 을 열 때 EncryptionKey 에 이 값을 설정해야 합니다.

메타데이터 지속성 모드

이 기기의 사용자 메타데이터에 대한 지속성 모드를 가져오거나 설정합니다.

선언

public MetadataPersistenceMode? MetadataPersistenceMode { get; set; }

속성 값

유형	설명
메타데이터 지속성 모드?	사용자 메타데이터 지속성 모드입니다.

비고

기본값은 iOS 기기의 경우 암호화 되고 기타 모든 플랫폼의 경우 암호화 되지 않음 입니다. iOS에서는 시스템 키체인과 통합하여 앱이 처음 실행될 때 임의의 암호화 키를 생성하고 저장합니다. 다른 플랫폼에서는 Encrypted 가 지정된경우 메타데이터 암호화 키를 설정해야 합니다.

OnSyncWebSocketConnection

MongoDB Atlas에 대한 발신 WebSocket 연결을 구성하는 데 사용할 위임을 가져오거나 설정합니다.

선언

public Action<ClientWebSocketOptions>? OnSyncWebSocketConnection { get; set; }

속성 값

유형	설명
조치<ClientWebSocketOptions>	발신 WebSocket 연결을 구성하는 데 사용할 위임입니다.

비고

이를 사용하여 기본 ClientWebSocket 동작을 수정할 수 있습니다. 일반적으로 MongoDB Atlas에 연결할 때는 필요하지 않지만 클라이언트 장치가 회사 방화벽 뒤에 있거나 더 복잡한 네트워킹 설정을 사용하는 경우 유용할 수 있습니다. UseManagedWebSockets 를 true 로 설정해야 합니다.

SyncTimeoutOptions

이 앱에 대해 열린 동기화 연결에 대한 여러 유형의 연결 시간 초과에 대한 옵션을 가져오거나 설정합니다.

선언

public SyncTimeoutOptions SyncTimeoutOptions { get; set; }

속성 값

유형	설명
SyncTimeoutOptions	동기화된 Realm에 동기화 시간 초과 옵션이 적용됩니다.

UseAppCache

이 구성으로 만든 앱 인스턴스를 캐시할지 여부를 나타내는 값을 가져오거나 설정합니다.

선언

public bool UseAppCache { get; set; }

속성 값

유형	설명
부울	true 앱을 캐시해야 하는지 여부 그렇지 않으면 false 입니다. 기본값은 true 입니다.

비고

Create(AppConfiguration) 을 사용하여 앱을 만들 때 기본 동작은 애플리케이션 ID에 키가 지정된 캐시에서 앱 인스턴스를 가져오거나 추가하는 것입니다. 이렇게 하면 Create(AppConfiguration) 를 여러 번 호출할 때 특정 성능 이점이 있습니다.

UseManagedWebSockets

동기화 트래픽에 .NET WebSocket 클라이언트 또는 내장 Realm WebSocket 클라이언트를 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.

선언

public bool UseManagedWebSockets { get; set; }

속성 값

유형	설명
부울	true ClientWebSocket 을 사용합니다. 내장 Realm WebSocket 클라이언트를 사용하려면 false 을(를) 사용하세요.

비고

기본값은 false 이지만 향후 버전에서 변경될 예정입니다.

다음도 참조하세요.

OnSyncWebSocketConnection