Udostępnij za pośrednictwem


/reference (opcje kompilatora C#)

/reference Opcji powoduje, że kompilator do importowania publicznych wpisz informacje w określonym pliku do bieżącego projektu, umożliwiając ułatwia wyszukiwanie metadanych z określonego zestawu plików.

/reference:[alias=]filename
/reference:filename

Argumenty

  • filename
    Nazwa pliku, który zawiera manifest zestawu.Aby zaimportować więcej niż jeden plik, należy dołączyć odrębne /reference opcja dla każdego pliku.

  • alias
    Ważne C# identyfikator, który będzie reprezentować głównego obszaru nazw, który będzie zawierać wszystkie obszary nazw w zestawie.

Uwagi

Aby importować z więcej niż jeden plik, należy dołączyć /reference opcja dla każdego pliku.

Pliki, które można importować musi zawierać manifestu; Plik wyjściowy musi skompilowany z jednym z /TARGET inne niż opcje /target:module.

/rjest krótkiej formy /reference.

Użyj /addmodule Importowanie metadanych z pliku wyjściowego, który nie zawierał manifest zestawu.

Jeśli odwołanie zestawu (Assembly A), która odwołuje się do innego zestawu (montaż B), trzeba będzie odwołanie zestawu b jeśli:

  • Typ używanego z zestawu a dziedziczy typ lub implementuje interfejs z zestawu B.

  • Wywołać pola, właściwości, zdarzenia lub metody, która ma typ zwracany lub typ parametru z zestawu B.

Użyj Loaded do określania katalogu, w którym znajduje się jeden lub więcej odwołań do zestawu./lib Temacie omówiono także katalogi, w których kompilator wyszukuje zestawów.

Aby kompilator rozpoznawał typu w zestawie, a nie w module musi być zmuszona do rozwiązania typu, co można zrobić, definiując wystąpienie tego typu.Istnieją inne sposoby rozpoznawania nazw typu w zestawie dla kompilatora: na przykład, jeśli użytkownik dziedziczą z typu w zestawie, wpisz nazwę następnie będą rozpoznawane przez kompilator.

Czasami jest konieczne odwołać się za dwie różne wersje tego samego składnika z w obrębie jednego zestawu.Aby to zrobić, użyj alias suboption, na /reference przełączyć się do każdego pliku do rozróżniania między dwoma plikami.Ten alias będzie służyć jako kwalifikator Nazwa składnika i będzie rozpoznawać składnika w jednym z plików.

Plik odpowiedzi (.rsp) csc, który odwołania powszechnie używane.NET Framework zestawów, domyślnie jest używany.Użyj /noconfig zostanie zignorowana Jeśli nie chcesz, aby kompilator, aby użyć csc.rsp.

[!UWAGA]

W programie Visual Studio, użyj Dodaj odwołanie okno dialogowe.Aby uzyskać więcej informacji, zobacz Porady: dodawanie i usuwanie odwołań za pomocą okna dialogowego Dodaj odwołanie.W Visual Studio 2010 i nowszych wersji, aby zagwarantować równoważne zachowanie między Dodawanie odwołania za pomocą /reference i za pomocą Dodaj odwołanie okno dialogowe Osadzić typy współdziałania z modelem właściwość musi być ustawiona na False dla zestawu, który jest dodawany.TRUE jest wartością domyślną tej właściwości.

Przykład

W tym przykładzie przedstawiono sposób użycia alias zewnętrzny funkcji.

Skompiluj plik źródłowy i Importowanie metadanych z grid.dll i grid20.dll,który zostały skompilowane wcześniej.Dwa pliki DLL zawierają różne wersje tego samego składnika i używać dwóch /reference z opcjami alias, aby skompilować plik źródłowy.Opcje wyglądać w następujący sposób:

/Reference:GridV1=Grid.dll i /reference:GridV2=grid20.dll

Konfiguruje to zewnętrzne aliasy "GridV1" i "GridV2", który używać programu z instrukcji extern:

extern alias GridV1;
extern alias GridV2;
// Using statements go here.

Po wykonaniu tej można odwołujesz się do kontroli siatki z grid.dll dodając do nazwy formantu z GridV1, jak to:

GridV1::Grid

Ponadto można odwołujesz się do kontroli siatki z grid20.dll dodając do nazwy formantu z GridV2 like to:

GridV2::Grid 

Zobacz też

Zadania

Porady: modyfikowanie właściwości projektu i ustawień konfiguracji

Inne zasoby

Opcje kompilatora C#