<elemento de origem>

Artigo
05/10/2023

Especifica uma origem de rastreio que inicia mensagens de rastreio.

<configuração>
  <system.diagnostics>
    <origens>
      <origem>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`name`	Atributo opcional. Especifica o nome da origem de rastreio.
`switchName`	Atributo opcional. Especifica o nome de uma instância de comutador de rastreio na aplicação. Se o comutador não for identificado num `<switches>` elemento, o valor especifica o nível do comutador.
`switchType`	Atributo opcional. Especifica o tipo do comutador de rastreio. Se estiver presente, o tipo tem de ser um nome de classe válido e não pode ser uma cadeia vazia.
`extraAttribute`	Atributo opcional. Especifica o valor de um atributo específico da origem de rastreio identificado pelo método para essa origem GetSupportedAttributes de rastreio.

Elementos Subordinados

Elemento	Descrição
<serviços de escuta>	Contém serviços de escuta que recolhem, armazenam e encaminham mensagens.

Elementos Principais

Elemento	Descrição
`configuration`	O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
`system.diagnostics`	Especifica serviços de escuta de rastreio que recolhem, armazenam e encaminham mensagens e o nível em que um comutador de rastreio está definido.
`sources`	Contém origens de rastreio que iniciam mensagens de rastreio.

Observações

Este elemento pode ser utilizado no ficheiro de configuração do computador (Machine.config) e no ficheiro de configuração da aplicação.

Exemplo

O exemplo seguinte mostra como utilizar o <source> elemento para adicionar a origem mySource de rastreio e definir o nível para o comutador de origem com o nome sourceSwitch. É adicionado um serviço de escuta de rastreio da consola que escreve informações de rastreio na consola.

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

Partilhar via