Da VB.NET 1.0 ble introdusert, var en av de største endringene at alle Microsofts genererte kildekode ble inkludert og tilgjengelig for deg som programmerer i prosjektet ditt. De eldre Visual Basic-versjonene opprettet ubeskrivelig p-kode som du ikke kunne se og ikke kunne endre. Selv om den genererte koden var i programmet ditt, var det en dårlig idé å endre noe av det. Hvis du ikke visste hva du gjorde, var sjansen stor for at du ville ødelegge prosjektet ditt ved å endre Microsofts genererte kode.
I VB.NET 1.0 ble all denne genererte koden bare beskyttet ved å være lukket i en region-del av programmet, der det var ett klikk unna å kunne vises og skiftes som en del av kilden kode. Fra og med VB.NET 2005 (Framework 2.0) la Microsoft den inn i en helt annen fil ved å bruke delklasser, men Regiondirektivet er fremdeles tilgjengelig, og du kan bruke det til å organisere din egen kode.
Dette enkle programmet viser hvordan Region fungerer:
Du kan kompilere dette til en DLL for å beskytte det eller bruke delklasseideen som Visual Studio bruker eller bare lage en egen klasse fil, men den enkleste måten å holde den ute av veien og fremdeles gjøre den til en del av den samme filen er å bruke regionen direktiv. Det får koden til å se slik ut:
Bare omgi koden du vil forsvinne med:
For feilsøkingsformål kan du bruke dette som en måte å bringe deler av koden nærmere sammen slik at du kan se dem på samme skjerm:
Du kan ikke bruke et område eller et sluttregion i en funksjon eller subroutine. Med andre ord, dette eksemplet nedenfor ikkearbeid:
Det er greit. Visual Studio faller sammen underprogrammer uten et regiondirektiv. Du kan hekke regioner. Dette med andre ord fungerer:
Hvis du låner kode fra internett, må du se etter regioner i den før du legger den til i koden. Det er kjent at hackere legger inn dårlige ting i en region for å forhindre at de blir lagt merke til.