Ustawianie atrybutów zestawu w kodzie

  • Artykuł

Atrybuty zestawu to wartości, które zawierają informacje o zestawie. Zazwyczaj są one ustawiane w pliku AssemblyInfo.cs . Atrybuty są podzielone na następujące zestawy informacji:

  • Atrybuty tożsamości zestawu
  • Atrybuty informacyjne
  • Atrybuty manifestu zestawu
  • Atrybuty silnej nazwy

Ten artykuł ma zakres dodawania atrybutów zestawu z kodu. Aby uzyskać informacje na temat dodawania atrybutów zestawu do projektów (nie w kodzie), zobacz Ustawianie atrybutów zestawu w pliku projektu.

Atrybuty tożsamości zestawu

Trzy atrybuty, wraz z silną nazwą (jeśli ma zastosowanie), określają tożsamość zestawu: nazwę, wersję i kulturę. Te atrybuty tworzą pełną nazwę zestawu i są wymagane podczas odwoływania się do zestawu w kodzie. Możesz użyć atrybutów, aby ustawić wersję i kulturę zestawu. Kompilator lub konsolidator zestawów (Al.exe) ustawia wartość nazwy podczas tworzenia zestawu na podstawie pliku zawierającego manifest zestawu.

W poniższej tabeli opisano atrybuty wersji i kultury.

Atrybut tożsamości zestawu opis
AssemblyCultureAttribute Wyliczone pole wskazujące kulturę obsługiwaną przez zestaw. Zestaw może również określać niezależność kultury, co oznacza, że zawiera zasoby dla kultury domyślnej. Uwaga: środowisko uruchomieniowe traktuje każdy zestaw, który nie ma atrybutu kultury ustawionego na wartość null jako zestaw satelitarny. Takie zestawy podlegają regułom wiązania zestawów satelitarnych. Aby uzyskać więcej informacji, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy.
AssemblyFlagsAttribute Wartość, która ustawia atrybuty zestawu, takie jak to, czy zestaw może być uruchamiany obok siebie.
AssemblyVersionAttribute Wartość liczbowa w formacie głównym.drobne.kompilacja.revision (na przykład 2.4.0.0). Środowisko uruchomieniowe języka wspólnego używa tej wartości do wykonywania operacji wiązania w zestawach o silnych nazwach. Uwaga: jeśli AssemblyInformationalVersionAttribute atrybut nie jest stosowany do zestawu, numer wersji określony przez AssemblyVersionAttribute atrybut jest używany przez Application.ProductVersionwłaściwości , Application.UserAppDataPathi Application.UserAppDataRegistry .

Poniższy przykład kodu pokazuje, jak zastosować atrybuty wersji i kultury do zestawu.

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

Atrybuty informacyjne

Możesz użyć atrybutów informacyjnych, aby podać dodatkowe informacje o firmie lub produkcie dla zestawu. W poniższej tabeli opisano atrybuty informacyjne, które można zastosować do zestawu.

Atrybut informacyjny opis
AssemblyCompanyAttribute Wartość ciągu określająca nazwę firmy.
AssemblyCopyrightAttribute Wartość ciągu określająca informacje o prawach autorskich.
AssemblyFileVersionAttribute Wartość ciągu określająca numer wersji pliku Win32. Zwykle jest to ustawienie domyślne wersji zestawu.
AssemblyInformationalVersionAttribute Wartość ciągu określająca informacje o wersji, które nie są używane przez środowisko uruchomieniowe języka wspólnego, takie jak pełny numer wersji produktu. Uwaga: jeśli ten atrybut jest stosowany do zestawu, określony ciąg można uzyskać w czasie wykonywania przy użyciu Application.ProductVersion właściwości . Ciąg jest również używany w ścieżce i kluczu rejestru udostępnianym Application.UserAppDataPath przez właściwości i Application.UserAppDataRegistry .
AssemblyProductAttribute Wartość ciągu określająca informacje o produkcie.
AssemblyTrademarkAttribute Wartość ciągu określająca informacje o znakach towarowych.

Te atrybuty mogą pojawić się na stronie Właściwości systemu Windows zestawu lub można je zastąpić przy użyciu /win32res opcji kompilatora, aby określić plik zasobu Win32.

Atrybuty manifestu zestawu

Atrybuty manifestu zestawu umożliwiają podanie informacji w manifeście zestawu, w tym tytuł, opis, alias domyślny i konfiguracja. W poniższej tabeli opisano atrybuty manifestu zestawu.

Atrybut manifestu zestawu opis
AssemblyConfigurationAttribute Wartość ciągu wskazująca konfigurację zestawu, na przykład Retail lub Debug. Środowisko uruchomieniowe nie używa tej wartości.
AssemblyDefaultAliasAttribute Wartość ciągu określająca alias domyślny, który ma być używany przez odwoływanie się do zestawów. Ta wartość zapewnia przyjazną nazwę, gdy nazwa samego zestawu nie jest przyjazna (na przykład wartość GUID). Ta wartość może być również używana jako krótka forma pełnej nazwy zestawu.
AssemblyDescriptionAttribute Wartość ciągu określająca krótki opis, który podsumowuje charakter i cel zestawu.
AssemblyTitleAttribute Wartość ciągu określająca przyjazną nazwę zestawu. Na przykład zestaw o nazwie comdlg może mieć tytuł Microsoft Common Dialog Control.

Atrybuty silnej nazwy

Możesz użyć atrybutów silnej nazwy, aby ustawić silną nazwę zestawu. W poniższej tabeli opisano atrybuty silnej nazwy.

Atrybut silnej nazwy opis
AssemblyDelaySignAttribute Wartość logiczna wskazująca, że jest używane podpisywanie opóźnione.
AssemblyKeyFileAttribute Wartość ciągu wskazująca nazwę pliku, który zawiera klucz publiczny (jeśli używasz podpisywania opóźnienia) lub zarówno klucze publiczne, jak i prywatne przekazane jako parametr konstruktora tego atrybutu. Należy pamiętać, że nazwa pliku jest względna względem ścieżki pliku wyjściowego ( .exe lub .dll), a nie ścieżki pliku źródłowego.
AssemblyKeyNameAttribute Wskazuje kontener kluczy, który zawiera parę kluczy przekazaną jako parametr do konstruktora tego atrybutu.

Poniższy przykład kodu przedstawia atrybuty do zastosowania podczas używania podpisywania opóźnienia w celu utworzenia zestawu o silnej nazwie z plikiem klucza publicznego o nazwie myKey.snk.

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Zobacz też