FeatureSwitchDefinitionAttribute クラス

定義

public ref class FeatureSwitchDefinitionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Property, Inherited=false)]
public sealed class FeatureSwitchDefinitionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property, Inherited=false)>]
type FeatureSwitchDefinitionAttribute = class
    inherit Attribute

Public NotInheritable Class FeatureSwitchDefinitionAttribute
Inherits Attribute

継承

Object

Attribute

FeatureSwitchDefinitionAttribute

属性

AttributeUsageAttribute

例

if (Feature.IsSupported)
    Feature.Implementation();

public class Feature
{
    [FeatureSwitchDefinition("Feature.IsSupported")]
    internal static bool IsSupported => AppContext.TryGetSwitch("Feature.IsSupported", out bool isEnabled) ? isEnabled : true;

    internal static Implementation() => ...;
}

アプリがプロジェクト ファイル内の次の機能設定でトリミングされると、 Feature.IsSupported は falseとして扱われ、 Feature.Implementation コードは削除されます。

<ItemGroup>
  <RuntimeHostConfigurationOption Include="Feature.IsSupported" Value="false" Trim="true" />
</ItemGroup>

注釈

IL リライターとコンパイラは、この属性を使用して、指定されたプロパティの戻り値を機能スイッチの値に置き換えることができます。

機能スイッチの値は、アプリケーション レベルでのみ指定でき、アプリケーション全体に影響します。 アプリケーションの一部である 1 つのライブラリで機能スイッチをオンにする必要があるが、これをアプリケーションの作成者に伝える方法がない状況に陥る可能性があります。

機能スイッチは、アプリケーション構成によって機能スイッチの値が異なる場合があり、すべてのコード パスが期待どおりに動作することを保証することは困難であるため、単体テストとコード共有が複雑になります。

そのため、機能スイッチなしで自然にトリミングが行われるように API を構成することをお勧めします。 機能スイッチの使用は、トリミングが必要な状況に備えて予約する必要がありますが、トリミングを自然に許可するように API を変更することは不可能です。