När VB.NET 1.0 introducerades var en av de största förändringarna att alla Microsofts genererade källkod var inkluderad och tillgänglig för dig som programmerare i ditt projekt. De äldre Visual Basic-versionerna skapade okrypterbar p-kod som du inte kunde se och inte kunde ändra. Även om den genererade koden fanns i ditt program var det en dålig idé att ändra något av det. Om du inte visste vad du gjorde, var chansen stor att du skulle bryta ditt projekt genom att ändra Microsofts genererade kod.
I VB.NET 1.0 skyddades all denna genererade kod endast genom att vara innesluten i ett regionavsnitt i programmet, där det var ett klick bort från att vara synligt och utbytbart som en del av din källa koda. Från och med VB.NET 2005 (Framework 2.0) satte Microsoft den i en helt annan fil med delklasser, men Regiondirektivet är fortfarande tillgängligt, och du kan använda det för att organisera din egen kod.
Detta enkla program visar hur Region fungerar:
Du kunde sammanställa detta till en DLL för att skydda den eller använda den delvisa klassidén som Visual Studio använder eller bara skapa en separat klass fil, men det enklaste sättet att hålla den ur vägen och ändå göra den till en del av samma fil är att använda regionen direktiv. Det gör att koden ser ut så här:
Omge bara koden du vill försvinna med:
För felsökningsändamål kan du använda detta som ett sätt att föra delar av din kod närmare varandra så att du kan se dem på samma skärm:
Du kan inte använda en region eller ett slutregion i en funktion eller en subroutine. Med andra ord, detta exempel nedan intearbete:
Det är ok. Visual Studio kollapsar subroutiner utan ett regiondirektiv. Du kan häcka regioner. Med andra ord detta fungerar:
Om du lånar kod från internet, leta efter regioner i den innan du lägger till den i din kod. Hackare har varit kända för att bädda in dåliga saker i en region för att förhindra att det märks.