Switch.GetSupportedAttributes メソッド

.NET Framework クラス ライブラリ リファレンス

Switch.GetSupportedAttributes メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

スイッチによってサポートされるカスタム属性を取得します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overridable
 Function GetSupportedAttributes As String()

Visual Basic (使用法)

Dim returnValue As String()

returnValue = Me.GetSupportedAttributes

C#

protected internal virtual string[] GetSupportedAttributes
 ()

C++

protected public:
virtual array<String^>^ GetSupportedAttributes ()

J#

protected String[] GetSupportedAttributes ()

JScript

protected internal function
 GetSupportedAttributes () : String[]

戻り値
スイッチによってサポートされるカスタム属性の名前を含む文字列配列。カスタム属性がサポートされない場合は null 参照 (Visual Basic では Nothing)。

解説

GetSupportedAttributes メソッドの既定の実装では null 参照 (Visual Basic では Nothing) を返します。スイッチが構成ファイルに追加され、GetSupportedAttributes によって返された文字列配列に含まれていないカスタム属性が指定されると、スイッチが読み込まれるときに ConfigurationException がスローされます。

継承時の注意 Switch クラスまたは派生クラスから継承する場合は、GetSupportedAttributes メソッドをオーバーライドしてクラスのカスタム属性を提供できます。

使用例

カスタム スイッチの GetSupportedAttributes メソッドのオーバーライドを次のコード例に示します。

Visual Basic

Public Class MySourceSwitch
    Inherits SourceSwitch
    Private sourceAttribute As Integer
 = 0

    Public Sub New(ByVal
 n As String)
        MyBase.New(n)

    End Sub 'New

    Public Property CustomSourceSwitchAttribute()
 As Integer
        Get
            Dim de As DictionaryEntry
            For Each de In
 Me.Attributes
                If de.Key.ToString().ToLower() = "customsourceswitchattribute"
 Then
                    sourceAttribute = Fix(de.Value)
                End If
            Next de
            Return sourceAttribute
        End Get
        Set(ByVal value As
 Integer)
            sourceAttribute = Fix(Value)
        End Set
    End Property

    Protected Overrides Function
 GetSupportedAttributes() As String()
        Return New String()
 {"customsourceSwitchattribute"}

    End Function 'GetSupportedAttributes
End Class 'MySourceSwitch

C#

public class MySourceSwitch : SourceSwitch
{
    int sourceAttribute = 0;
    public MySourceSwitch(string n) : base(n)
 { }
    public int CustomSourceSwitchAttribute
    {
        get
        {
            foreach (DictionaryEntry de in
 this.Attributes)
                if (de.Key.ToString().ToLower() == "customsourceswitchattribute")
                    sourceAttribute = (int)de.Value;
            return sourceAttribute;
        }
        set { sourceAttribute = (int)value;
 }
    }

    protected override string[] GetSupportedAttributes()
    {
        return new string[]
 { "customsourceSwitchattribute" };
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Switch クラス
Switch メンバ
System.Diagnostics 名前空間