Compartilhar via


<source> Elemento

Especifica uma fonte de rastreamento que inicia o rastreamento de mensagens.

<configuration>
  <system.diagnostics>
    <sources>
      <source>

Sintaxe

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Attribute Description
name Atributo opcional.

Especifica o nome da fonte de rastreamento.
switchName Atributo opcional.

Especifica o nome de uma instância de comutador de rastreamento no aplicativo. Se a opção não for identificada em um <switches> elemento, o valor especifica o nível da opção.
switchType Atributo opcional.

Especifica o tipo do comutador de rastreamento. Se presente, o tipo deve ser um nome de classe válido e não pode ser uma cadeia de caracteres vazia.
extraAttribute Atributo opcional.

Especifica o valor de um atributo específico da fonte de rastreamento identificado pelo GetSupportedAttributes método para essa fonte de rastreamento.

Elementos filho

Elemento Description
<Ouvintes> Contém ouvintes que coletam, armazenam e roteiam mensagens.

Elementos pai

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um comutador de rastreamento é definido.
sources Contém fontes de rastreamento que iniciam o rastreamento de mensagens.

Observações

Esse elemento pode ser usado no arquivo de configuração do computador (Machine.config) e no arquivo de configuração do aplicativo.

Example

O exemplo a seguir mostra como usar o <source> elemento para adicionar a fonte mySource de rastreamento e definir o nível do comutador de origem chamado sourceSwitch. Um ouvinte de rastreamento de console é adicionado que grava informações de rastreamento no console.

<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>

Consulte também