Dela via


externt alias (C#-referens)

Du kan behöva referera till två versioner av sammansättningar som har samma fullständigt kvalificerade typnamn. Du kan till exempel behöva använda två eller flera versioner av en sammansättning i samma program. Genom att använda ett externt sammansättningsalias kan du omsluta namnrymderna från varje sammansättning i namnrymder på rotnivå som namnges av aliaset. Med den här metoden kan du använda båda versionerna i samma fil.

C#-språkreferensen dokumenterar den senaste versionen av C#-språket. Den innehåller även inledande dokumentation för funktioner i offentliga förhandsversioner för den kommande språkversionen.

Dokumentationen identifierar alla funktioner som först introducerades i de tre senaste versionerna av språket eller i aktuella offentliga förhandsversioner.

Tips/Råd

Information om när en funktion först introducerades i C# finns i artikeln om språkversionshistoriken för C#.

Anmärkning

Det externa nyckelordet används också som metodmodifierare och deklarerar en metod skriven i ohanterad kod.

Om du vill referera till två sammansättningar med samma fullständigt kvalificerade typnamn anger du ett alias i .csproj-filen och lägger till följande kod:

<Reference Include="grid.dll"> 
    <Aliases>GridV1</Aliases>
</Reference>
<Reference Include="grid20.dll">
    <Aliases>GridV2</Aliases>
</Reference>

Du kan läsa mer i artikeln om CSC-uppgiften i Visual Studio-dokumentationen.

Det här kommandot skapar de externa aliasen GridV1 och GridV2. Om du vill använda dessa alias inifrån ett program refererar du till dem med hjälp av nyckelordet extern . Till exempel:

extern alias GridV1; extern alias GridV2;

Varje extern aliasdeklaration introducerar ytterligare ett namnområde på rotnivå som paralleller (men inte ligger inom) det globala namnområdet. Du kan referera till typer från varje sammansättning utan tvetydighet genom att använda deras fullständigt kvalificerade namn, rotade i lämpligt namnområdesalias.

I föregående exempel GridV1::Grid är rutnätskontrollen från grid.dll, och GridV2::Grid är rutnätskontrollen från grid20.dll.

Använda Visual Studio

Om du använder Visual Studio kan du ange alias på ett liknande sätt.

Lägg till referenser till grid.dll och grid20.dll i projektet i Visual Studio. Öppna egenskapsfliken och ändra aliasen från global till GridV1GridV2 respektive.

Använd dessa alias på samma sätt som du beskrev tidigare.

extern alias GridV1;  
extern alias GridV2;  

Nu kan du skapa ett alias för ett namnområde eller en typ med hjälp av aliasdirektivet. Mer information finns i använda direktiv.

using Class1V1 = GridV1::Namespace.Class1;
using Class1V2 = GridV2::Namespace.Class1;

Språkspecifikation för C#

Mer information finns i C#-språkspecifikationen. Språkspecifikationen är den slutgiltiga källan för C#-syntax och -användning.

Se även