<source> Elemento

Artigo
08/01/2011

Especifica uma origem de rastreamento que inicia as mensagens de rastreamento.

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

Atributos e elementos

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

Atributos

Atributo	Descrição
name	Atributo opcional. Especifica o nome da fonte de rastreamento.
switchName	Atributo opcional. Especifica o nome de uma instância de switch de rastreamento no aplicativo. Se o switch não é identificado em um <switches> elemento, o valor Especifica o nível para o switch.
switchType	Atributo opcional. Especifica o tipo do switch de rastreamento. Se estiver presente, o tipo deve ser um nome de classe válido e não pode ser uma seqüência vazia.
extraAttribute	Atributo opcional. Especifica o valor para um atributo de origem específico de rastreamento identificado pelo GetSupportedAttributes método para essa fonte de rastreamento.

Elementos filho

Elemento	Descrição
<listeners> Elemento para <trace>	Contém os ouvintes que coletam, armazenam e roteiam mensagens.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.
sources	Contém fontes de rastreamento que iniciam mensagens de rastreamento.

Comentários

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

Exemplo

O exemplo a seguir mostra como usar o <source> elemento para adicionar a fonte de rastreamento mySource e para definir o nível para o switch de origem chamado sourceSwitch. Um ouvinte de rastreamento do 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

Referência

Rastreamento e esquema configurações Debug

Conceitos

Fontes de rastreamento

Opções de rastreamento.

Compartilhar via