Elemen <gcAllowVeryLargeObjects>

  • Artikel

Pada platform 64-bit, aktifkan larik yang lebih besar dari 2 gigabyte (GB) dalam ukuran total.

<konfigurasi>
  <runtime>
    <gcAllowVeryLargeObjects>

Sintaks

<gcAllowVeryLargeObjects enabled="true|false" />

Atribut

Atribut Deskripsi
enabled Atribut yang diperlukan.

Menentukan apakah larik yang lebih besar dari 2 GB dalam ukuran total diaktifkan pada platform 64-bit.

atribut yang diaktifkan

Nilai Deskripsi
false Larik yang lebih besar dari 2 GB dalam ukuran total tidak diaktifkan. Ini adalah default.
true Larik yang lebih besar dari 2 GB dalam ukuran total diaktifkan pada platform 64-bit.

Elemen anak

Tidak ada.

Elemen induk

Elemen Deskripsi
configuration Elemen akar di setiap file konfigurasi yang digunakan oleh runtime bahasa umum dan aplikasi .NET Framework.
runtime Berisi informasi tentang opsi inisialisasi runtime bahasa umum.

Keterangan

Menggunakan elemen ini dalam file konfigurasi aplikasi Anda memungkinkan larik berukuran lebih besar dari 2 GB, tetapi tidak mengubah batasan lain pada ukuran objek atau ukuran larik:

  • Jumlah maksimum elemen dalam larik adalah UInt32.MaxValue.

  • Ukuran maksimum dalam setiap dimensi tunggal adalah 2.147.483.591 (0x7FFFFFC7) untuk larik byte dan larik struktur byte tunggal, dan 2.146.435.071 (0X7FEFFFFF) untuk larik yang berisi jenis lain.

  • Ukuran maksimum untuk string dan objek non-larik lainnya tidak berubah.

Perhatian

Sebelum mengaktifkan fitur ini, pastikan aplikasi Anda tidak menyertakan kode tak terkelola yang mengasumsikan bahwa semua larik berukuran lebih kecil dari 2 GB. Misalnya, kode tak terkelola yang menggunakan larik sebagai buffer mungkin rentan terhadap kelebihan buffer jika ditulis dengan asumsi bahwa larik tidak akan melebihi 2 GB.

Contoh

Cuplikan file app.config berikut menunjukkan cara mengaktifkan fitur ini untuk aplikasi .NET Framework.

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

Didukung di

.NET Framework 4.5 dan versi yang lebih baru

Lihat juga