Elemento <source>

Artigo
05/10/2023

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

<configuração>
  <system.diagnostics>
    <sources>
      <source>

Syntax

<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 origem de rastreamento.
`switchName`	Atributo opcional. Especifica o nome de uma instância de comutador de rastreamento no aplicativo. Se o comutador não for identificada em um elemento `<switches>`, o valor especifica o nível do comutador.
`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 método GetSupportedAttributes para essa fonte de rastreamento.

Elementos filho

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

Elementos pai

Elemento	Descrição
`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 uma opção de rastreamento é definida.
`sources`	Contém as origens de rastreamento que iniciam as mensagens de rastreamento.

Comentários

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

Exemplo

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

Compartilhar via