System.Runtime.CompilerServices.InternalsVisibleToAttribute třída

Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.

Atribut InternalsVisibleToAttribute určuje, že typy, které jsou obvykle viditelné pouze v rámci aktuálního sestavení, jsou viditelné pro zadané sestavení.

Obvykle jsou typy a členy s oboreminternal v jazyce C# nebo Friend obor v jazyce Visual Basic viditelné pouze v sestavení, ve kterém jsou definovány. Typy a členy s rozsahem protected internal (Protected Friend rozsah v jazyce Visual Basic) jsou viditelné pouze ve vlastním sestavení nebo pro typy, které jsou odvozené z jejich obsahující třídy. Typy a členy s oborem private protected (Private Protected obor v jazyce Visual Basic) jsou viditelné v obsahující třídě nebo v typech odvozených od jejich obsahující třídy v rámci aktuálního sestavení.

Atribut InternalsVisibleToAttribute zviditelňuje tyto typy a členy pro typy v zadaném sestavení, které se nazývá přátelské sestavení. To platí pouze pro členy internal (Friend v jazyce Visual Basic), protected internal (Protected Friend v jazyce Visual Basic), a private protected (Private Protected v jazyce Visual Basic), ale ne pro private.

Poznámka:

V případě private protected (Private Protected ve Visual Basicu) členů rozšiřuje atribut přístupnost pouze na typy odvozené od InternalsVisibleToAttribute.

Atribut se použije na úrovni sestavení. To znamená, že ho můžete zahrnout na začátku souboru zdrojového kódu nebo ho můžete zahrnout do souboru AssemblyInfo v projektu sady Visual Studio. Pomocí atributu můžete určit jedno přátelské sestavení, které má přístup k interním typům a členům aktuálního sestavení. Různé sestavy přátel můžete definovat dvěma způsoby. Mohou se zobrazit jako jednotlivé atributy na úrovni sestavení, jak je znázorněno v následujícím příkladu.

[assembly:InternalsVisibleTo("Friend1a")]
[assembly:InternalsVisibleTo("Friend1b")]

<assembly:InternalsVisibleTo("Friend1a")>
<assembly:InternalsVisibleTo("Friend1b")>

Mohou se také objevit s samostatnými InternalsVisibleToAttribute značkami, ale jedním assembly klíčovým slovem, jak ukazuje následující příklad.

[assembly:InternalsVisibleTo("Friend2a"), 
          InternalsVisibleTo("Friend2b")]

<Assembly:InternalsVisibleTo("Friend2a"), _
 Assembly:InternalsVisibleTo("Friend2b")>

Přátelská sestavení je identifikována konstruktorem InternalsVisibleToAttribute . Aktuální sestavení i přátelská sestavení musí být nepodepsané nebo obě sestavení musí být podepsána silným názvem.

Pokud jsou obě sestavení nepodepsaná, argument assemblyName se skládá z názvu přátelského sestavení, zadaného bez cesty k adresáři nebo přípony názvu souboru.

Pokud jsou obě sestavení podepsána silným názvem, musí argument InternalsVisibleToAttribute konstruktoru obsahovat název sestavení bez jeho cesty k adresáři nebo přípony názvu souboru spolu s úplným veřejným klíčem (a ne jeho token veřejného klíče). Úplný veřejný klíč sestavení se silným názvem získáte v části Získání celého veřejného klíče dále v tomto článku. Další informace o použití InternalsVisibleToAttribute pro silně pojmenované sestavení naleznete v konstruktoru InternalsVisibleToAttribute.

Do argumentu CultureInfonezahrnujte hodnoty pro , Versionnebo ProcessorArchitecture pole; kompilátory jazyka Visual Basic, C# a C++ zachází jako s chybou kompilátoru. Pokud použijete kompilátor, který to nepovažuje za chybu (například IL Assembler (ILAsm.exe)) a sestavení mají silná jména, je vyvolána výjimka při prvním přístupu určeného přátelského sestavení k sestavení, které obsahuje atribut MethodAccessException.

Další informace o použití tohoto atributu naleznete viz Přátelská sestavení a Přátelská sestavení C++.

Získání úplného veřejného klíče

Pomocí nástroje Strong Name (Sn.exe) můžete načíst úplný veřejný klíč ze souboru se silným názvem (.snk). Provedete to takto:

1. Extrahujte veřejný klíč ze souboru s názvem silného klíče do samostatného souboru.

   Sn -p <snk_file> <outfile>

2. Zobrazení úplného veřejného klíče do konzoly:

   Sn -tp <outfile>

3. Zkopírujte a vložte úplnou hodnotu veřejného klíče do zdrojového kódu.

Zkompilujte spřátelené sestavení pomocí jazyka C#

Pokud použijete kompilátor jazyka C# ke kompilaci přátelského sestavení, je nutné explicitně zadat název výstupního souboru (.exe nebo .dll) pomocí volby /out kompilátoru. To je povinné, protože kompilátor ještě negeneroval název sestavení, které sestavuje v době, kdy je vázán na externí odkazy. Možnost /out kompilátoru je volitelná pro kompilátor jazyka Visual Basic a odpovídající možnost -out nebo -o kompilátoru by se neměla použít při kompilaci přátelských sestavení pomocí kompilátoru jazyka F#.

Zkompilujte přátelské sestavení pomocí jazyka C++

V jazyce C++ je nutné použít atribut InternalsVisibleToAttribute v direktivě C++, aby byly interní členy povolené atributem as_friend dostupné přátelskému sestavení. Další informace naleznete v tématu Přátelská sestavení (C++).