<source> 要素

  • [アーティクル]

トレース メッセージを開始するトレース ソースを指定します。

configuration
  <system.diagnostics>
    <sources>
      ソース>

構文

<source>
  <listeners>...</listeners>  
</source>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
name 省略可能な属性です。

トレース ソースの名前を指定します。
switchName 省略可能な属性です。

アプリケーションのトレース スイッチ インスタンスの名前を指定します。 スイッチが <switches> 要素で識別されない場合は、スイッチのレベルを値で指定します。
switchType 省略可能な属性です。

トレース スイッチの種類を指定します。 存在する場合、型は有効なクラス名である必要があり、空の文字列にすることはできません。
extraAttribute 省略可能な属性です。

トレース ソースに対して GetSupportedAttributes メソッドによって識別される、トレース ソース固有の属性の値を指定します。

子要素

要素 説明
<listeners> メッセージを収集、格納、およびルーティングするリスナーを保持します。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.diagnostics メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。
sources トレース メッセージを開始するトレース ソースを保持します。

解説

この要素は、マシン構成ファイル (Machine.config) とアプリケーション構成ファイルで使用できます。

例

次の例では、<source> 要素を使用してトレース ソース mySource を追加し、sourceSwitch という名前のソース スイッチのレベルを設定する方法を示します。 トレース情報をコンソールに書き込むコンソール トレース リスナーが追加されます。

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch" switchType="System.Diagnostics.SourceSwitch"  >  
        <listeners>  
          <add name="console" type="System.Diagnostics.ConsoleTraceListener" >  
            <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" />  
          </add>  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
        <switches>  
           <add name="sourceSwitch" value="Warning" />  
        </switches>
  </system.diagnostics>
</configuration>

関連項目