TraceSource Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe TraceSource.
Sobrecargas
| Nome | Description |
|---|---|
| TraceSource(String) |
Inicializa uma nova instância da TraceSource classe usando o nome especificado para a origem. |
| TraceSource(String, SourceLevels) |
Inicializa uma nova instância da TraceSource classe, usando o nome especificado para a origem e o nível de origem padrão no qual o rastreamento deve ocorrer. |
TraceSource(String)
Inicializa uma nova instância da TraceSource classe usando o nome especificado para a origem.
public:
TraceSource(System::String ^ name);public TraceSource(string name);new System.Diagnostics.TraceSource : string -> System.Diagnostics.TraceSourcePublic Sub New (name As String)Parâmetros
- name
- String
O nome da origem (normalmente, o nome do aplicativo).
Exceções
name é null.
name é uma cadeia de caracteres vazia ("").
Exemplos
O exemplo de código a seguir mostra o uso do TraceSource construtor para criar um novo TraceSource objeto. Este exemplo de código faz parte de um exemplo maior fornecido para a TraceSource classe.
// Initialize the trace source.
static TraceSource ts = new TraceSource("TraceTest");
' Initialize the trace source.
Private Shared ts As New TraceSource("TraceTest")
Comentários
O nome de origem é usado para identificar rastreamentos. Ele é usado por um SourceFilter para determinar se um ouvinte de rastreamento deve produzir o rastreamento. A prática recomendada é usar o nome do aplicativo para o nome de origem.
Note
Não é necessário criar uma nova TraceSource instância para cada solicitação de rastreamento. Crie uma TraceSource instância e use-a para todas as solicitações de rastreamento para o aplicativo.
Aplica-se a
TraceSource(String, SourceLevels)
Inicializa uma nova instância da TraceSource classe, usando o nome especificado para a origem e o nível de origem padrão no qual o rastreamento deve ocorrer.
public:
TraceSource(System::String ^ name, System::Diagnostics::SourceLevels defaultLevel);public TraceSource(string name, System.Diagnostics.SourceLevels defaultLevel);new System.Diagnostics.TraceSource : string * System.Diagnostics.SourceLevels -> System.Diagnostics.TraceSourcePublic Sub New (name As String, defaultLevel As SourceLevels)Parâmetros
- name
- String
O nome da origem, normalmente o nome do aplicativo.
- defaultLevel
- SourceLevels
Uma combinação bit a bit dos valores de enumeração que especifica o nível de origem padrão no qual rastrear.
Exceções
name é null.
name é uma cadeia de caracteres vazia ("").
Comentários
O nome de origem é usado para identificar rastreamentos. Ele pode ser usado por um SourceSwitch para determinar se o rastreamento deve ocorrer e por um SourceFilter para determinar se o rastreamento deve ser produzido. O nível de origem padrão é usado por um EventTypeFilter para determinar se o rastreamento deve ocorrer com base no nível de origem da mensagem a ser rastreada.
Note
Não é necessário criar uma nova TraceSource instância para cada solicitação de rastreamento. Crie uma TraceSource instância e use-a para todas as solicitações de rastreamento para o aplicativo.