<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>
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET