<gcAllowVeryLargeObjects> element

  • 發行項

在 64 位元平台上，啟用總大小大於 2 GB 的陣列。

<configuration>
  <runtime>
    <gcAllowVeryLargeObjects>

Syntax

<gcAllowVeryLargeObjects enabled="true|false" />

屬性

屬性 描述
enabled 必要屬性。

指定是否在 64 位元平台上啟用大小總計大於 2 GB 的陣列。

已啟用的屬性

值 描述
false 未啟用大小總計大於 2 GB 的陣列。 此為預設值。
true 64 位元平台上會啟用大小總計大於 2 GB 的陣列。

子元素

無。

父元素

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
runtime 包含有關執行階段初始化選項的資訊。

備註

在應用程式組態檔中使用這個元素，可啟用大於 2 GB 的陣列，但不會變更物件大小或陣列大小的其他限制：

  • 陣列中的元素數量上限為 UInt32.MaxValue。

  • 針對位元組陣列和單一位元組結構的陣列，任何單一維度的大小上限為 2,147,483,591 (0x7FFFFFC7)，包含其他型別的陣列上限則為 2,146,435,071 (0X7FEFFFFF)。

  • 字串和其他非陣列物件的大小上限維持不變。

警告

啟用此功能之前，請確定您的應用程式沒有包含不安全的程式碼，假設所有陣列的大小都小於 2 GB。 例如，如果撰寫陣列時是假設不會超過 2 GB，那麼使用該陣列做為緩衝區的不安全程式碼，可能會容易受到緩衝區滿溢的影響。

範例

下列app.config檔案程式碼片段示範如何為.NET Framework應用程式啟用此功能。

<configuration>  
  <runtime>  
    <gcAllowVeryLargeObjects enabled="true" />  
  </runtime>  
</configuration>

支援於

.NET Framework 4.5 和更新版本

另請參閱