Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

DnsOptions.Builder

class DnsOptions.Builder

DnsOptions 的建構工具。

摘要

公開函式
`DnsOptions!`	`build()` 根據這個建構工具中的值，建立並傳回最終的 `DnsOptions` 例項。
`DnsOptions.Builder!`	`enableStaleDns(enable: Boolean)` 設定是否要使用過時的 DNS 結果。
`DnsOptions.Builder!`	`persistHostCache(persistHostCache: Boolean)` 設定是否應將 DNS 快取保留在磁碟上。
`DnsOptions.Builder!`	`@DnsOptions.Experimental preestablishConnectionsToStaleDnsResults(enable: Boolean)` 設定 Cronet 是否應使用過時的快取 DNS 記錄，預先建立連線。
`DnsOptions.Builder!`	`@RequiresApi(api = VERSION_CODES.O) setPersistDelay(persistToDiskPeriod: Duration)` 與 `setPersistHostCachePeriodMillis` 相同，但使用 `java.time.Duration`。
`DnsOptions.Builder!`	`setPersistHostCachePeriodMillis(persistHostCachePeriodMillis: Long)` 設定 DNS 快取持續性後續寫入磁碟的間隔下限。
`DnsOptions.Builder!`	`@DnsOptions.Experimental setStaleDnsOptions( staleDnsOptionsBuilder: DnsOptions.StaleDnsOptions.Builder! )`
`DnsOptions.Builder!`	`setStaleDnsOptions(staleDnsOptions: DnsOptions.StaleDnsOptions!)` 設定過時 DNS 的詳細設定。
`DnsOptions.Builder!`	`useBuiltInDnsResolver(enable: Boolean)`

fun build(): DnsOptions!

根據這個建構工具中的值，建立並傳回最終的 DnsOptions 例項。

fun enableStaleDns(enable: Boolean): DnsOptions.Builder!

設定是否要使用過時的 DNS 結果。

傳回
`DnsOptions.Builder!`	用於鏈結的建構工具

fun persistHostCache(persistHostCache: Boolean): DnsOptions.Builder!

設定是否應將 DNS 快取保留在磁碟上。

只有在設定 setStoragePath 時才適用。

傳回
`DnsOptions.Builder!`	用於鏈結的建構工具

@DnsOptions.Experimental
fun preestablishConnectionsToStaleDnsResults(enable: Boolean): DnsOptions.Builder!

設定 Cronet 是否應使用過時的快取 DNS 記錄，預先建立連線。

啟用後，Cronet 會樂觀地預先建立與伺服器的連線，這些伺服器在過去某個時間點與主機名稱相符，且已快取，但快取項目已過期。在新的 DNS 查詢確認快取記錄為最新狀態前，系統不會再使用這類連線。

如要立即使用快取的 DNS 記錄，請使用 enableStaleDns 和 StaleDnsOptions 設定選項。

這個選項可能不適用於所有網路通訊協定。

傳回
`DnsOptions.Builder!`	用於鏈結的建構工具

@RequiresApi(api = VERSION_CODES.O)
fun setPersistDelay(persistToDiskPeriod: Duration): DnsOptions.Builder!

傳回
`DnsOptions.Builder!`	用於鏈結的建構工具

fun setPersistHostCachePeriodMillis(persistHostCachePeriodMillis: Long): DnsOptions.Builder!

設定 DNS 快取持續性後續寫入磁碟的間隔下限。

只有在 persistHostCache 設為 True 時，這項政策才會生效。

傳回
`DnsOptions.Builder!`	用於鏈結的建構工具

@DnsOptions.Experimental
fun setStaleDnsOptions(
    staleDnsOptionsBuilder: DnsOptions.StaleDnsOptions.Builder!
): DnsOptions.Builder!

另請參閱
`setStaleDnsOptions`

fun setStaleDnsOptions(staleDnsOptions: DnsOptions.StaleDnsOptions!): DnsOptions.Builder!

設定過時 DNS 的詳細設定。只有在設定 enableStaleDns 時才適用。

傳回
`DnsOptions.Builder!`	這個建構工具，用於鏈結。

fun useBuiltInDnsResolver(enable: Boolean): DnsOptions.Builder!