你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ContainerProperties.DefaultTimeToLive 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从 Azure Cosmos 服务获取容器中项的默认生存时间（以秒为单位）。

public int? DefaultTimeToLive { get; set; }

member this.DefaultTimeToLive : Nullable<int> with get, set

Public Property DefaultTimeToLive As Nullable(Of Integer)

它是一个可选属性。有效值必须是非零正时间跨度或 null。默认情况下，DefaultTimeToLive 设置为 null，这意味着容器的生存时间已关闭。度量单位为秒。允许的最大值为2147483647。

下面的示例禁用容器的生存时间。

container.DefaultTimeToLive = null;

下面的示例在容器上启用生存时间。默认情况下，所有项永不过期。

container.DefaultTimeToLive = TimeSpan.FromDays(2);

下面的示例在容器上启用生存时间。默认情况下，该项将在自上次写入后 1000 秒后过期。

container.DefaultTimeToLive = TimeSpan.FromSeconds(1000);

DefaultTimeToLive将应用于容器中的所有项，作为默认生存时间策略。单个项可以通过设置生存时间来替代默认生存时间策略。

DefaultTimeToLive当为 null时，将为容器关闭生存时间。这意味着所有项永远不会过期。将忽略单个项的生存时间。

DefaultTimeToLive当为“-1”时，将为容器打开生存时间。默认情况下，所有项永远不会过期。可以通过设置单个项的生存时间，为其指定特定的生存时间值。项目的生存时间将得到遵守，过期的项目将在后台删除。

DefaultTimeToLive当为非零正整数时，将为容器打开生存时间。默认生存时间（以秒为单位）将应用于所有项。项将在指定值（以秒为单位）后 DefaultTimeToLive 过期，自上次写入时间以来。