Udostępnij przez

<gcAllowVeryLargeObjects> , element

  • Artykuł

Na platformach 64-bitowych umożliwia macierze większe niż 2 gigabajty (GB) całkowitego rozmiaru.

<Konfiguracji>
  <Środowiska wykonawczego>
    <gcAllowVeryLargeObjects>

Składnia

<gcAllowVeryLargeObjects enabled="true|false" />

Atrybuty

Atrybut Opis
enabled Atrybut wymagany.

Określa, czy tablice większe niż 2 GB całkowitego rozmiaru są włączone na platformach 64-bitowych.

włączony atrybut

Wartość Opis
false Tablice większe niż 2 GB całkowitego rozmiaru nie są włączone. Jest to opcja domyślna.
true Tablice większe niż 2 GB całkowitego rozmiaru są włączone na platformach 64-bitowych.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element Opis
configuration Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
runtime Zawiera informacje dotyczące opcji inicjowania środowiska uruchomieniowego.

Uwagi

Użycie tego elementu w pliku konfiguracji aplikacji umożliwia tablice o rozmiarze większym niż 2 GB, ale nie zmieniają innych limitów rozmiaru obiektu ani rozmiaru tablicy:

  • Maksymalna liczba elementów w tablicy to UInt32.MaxValue.

  • Maksymalny rozmiar w każdym pojedynczym wymiarze to 2 147 483 591 (0x7FFFFFC7) dla tablic bajtowych i tablic struktur jedno bajtowych oraz 2 146 435 071 (0X7FEFFFFF) dla tablic zawierających inne typy.

  • Maksymalny rozmiar ciągów i innych obiektów nienależących do tablicy jest niezmieniony.

Przestroga

Przed włączeniem tej funkcji upewnij się, że aplikacja nie zawiera niebezpiecznego kodu, który zakłada, że wszystkie tablice mają rozmiar mniejszy niż 2 GB. Na przykład niebezpieczny kod, który używa tablic jako buforów, może być podatny na przepełnienie buforu, jeśli zostanie zapisany przy założeniu, że tablice nie przekroczą 2 GB.

Przykład

Poniższy fragment koduapp.config pliku pokazuje, jak włączyć tę funkcję dla aplikacji .NET Framework.

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

Obsługiwane w programie

.NET Framework wersji 4.5 i nowszych

Zobacz też