Partilhar via


<source> Elemento

Especifica uma fonte de rastreio que inicia mensagens de rastreio.

<configuração>
   <system.diagnostics>
     <Fontes>
       <Fonte>

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 do traço.
switchName Atributo opcional.

Especifica o nome de uma instância de comutador de traço na aplicação. Se o interruptor não for identificado num <switches> elemento, o valor especifica o nível do comutador.
switchType Atributo opcional.

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

Especifica o valor para um atributo específico da fonte do traço identificado pelo GetSupportedAttributes método para essa fonte do traço.

Elementos Subordinados

Elemento Description
<ouvintes> Contém ouvintes que recolhem, armazenam e encaminham mensagens.

Elementos Principais

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
system.diagnostics Especifica ouvintes de rastreio que recolhem, armazenam e encaminham mensagens e o nível onde um comutador de traço está definido.
sources Contém fontes de rastreio que iniciam mensagens de rastreio.

Observações

Este elemento pode ser usado no ficheiro de configuração da máquina (Machine.config) e no ficheiro de configuração da aplicação.

Example

O exemplo seguinte mostra como usar o <source> elemento para adicionar a fonte mySource do traço e definir o nível para o switch de fonte chamado sourceSwitch. É adicionado um ouvinte de rastreamento na consola que escreve a informação do 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>

Consulte também