WebThreadInformation Classe
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.
Fornece informações sobre o estado de um thread em um processo do ASP.NET.
public ref class WebThreadInformation sealed
public sealed class WebThreadInformation
type WebThreadInformation = class
Public NotInheritable Class WebThreadInformation
- Herança
-
WebThreadInformation
Exemplos
O exemplo de código a seguir tem duas partes. O primeiro é um trecho de um arquivo de configuração que permite que ASP.NET usem um evento personalizado que usa o WebThreadInformation tipo. O segundo mostra como implementar o evento personalizado que usa o WebThreadInformation tipo.
Verifique se o evento personalizado é gerado no momento adequado, ou seja, quando o evento de integridade do sistema equivalente que ele substitui for gerado.
<healthMonitoring
heartBeatInterval="0" enabled="true">
<profiles>
<add name="Custom"
minInstances="1"
maxLimit="Infinite"
minInterval="00:00:00" />
</profiles>
<eventMappings>
<add
name="SampleWebThreadInformation"
type="SamplesAspNet.SampleWebThreadInformation,webthreadinformation, Version=1.0.1782.29648, Culture=neutral, PublicKeyToken=b3283a2de7dd3f27, processorArchitecture=MSIL" />
</eventMappings>
<rules>
<add name="Custom Web Thread Info Event"
eventName="SampleWebThreadInformation"
provider="EventLogProvider"
profile="Custom" />
</rules>
</healthMonitoring>
using System;
using System.Text;
using System.Web;
using System.Web.Management;
namespace SamplesAspNet
{
// Implements a custom WebErrorstEvent that uses the
// WebThreadInformation.
public class SampleWebThreadInformation :
WebErrorEvent
{
private StringBuilder eventInfo;
// Instantiate events identified
// only by their event code.
public SampleWebThreadInformation(
string msg, object eventSource,
int eventCode, Exception e)
:
base(msg, eventSource, eventCode, e)
{
// Perform custom initialization.
eventInfo = new StringBuilder();
eventInfo.Append(string.Format(
"Event created at: {0}",
EventTime.ToString()));
}
// Raises the event.
public override void Raise()
{
// Perform custom processing.
eventInfo.Append(string.Format(
"Event raised at: {0}",
EventTime.ToString()));
// Raise the event.
base.Raise();
}
// Get the impersonation mode.
public string GetThreadImpersonation()
{
return (string.Format(
"Is impersonating: {0}",
ThreadInformation.IsImpersonating.ToString()));
}
// Get the stack trace.
public string GetThreadStackTrace()
{
return (string.Format(
"Stack trace: {0}",
ThreadInformation.StackTrace));
}
// Get the account name.
public string GetThreadAccountName()
{
return (string.Format(
"Request user host address: {0}",
ThreadInformation.ThreadAccountName));
}
// Get the task Id.
public string GetThreadId()
{
// Get the request principal.
return (string.Format(
"Thread Id: {0}",
ThreadInformation.ThreadID.ToString()));
}
// Formats Web request event information.
public override void FormatCustomEventDetails(
WebEventFormatter formatter)
{
// Add custom data.
formatter.AppendLine("");
formatter.AppendLine(
"Custom Thread Information:");
formatter.IndentationLevel += 1;
// Display the thread information obtained
formatter.AppendLine(GetThreadImpersonation());
formatter.AppendLine(GetThreadStackTrace());
formatter.AppendLine(GetThreadAccountName());
formatter.AppendLine(GetThreadId());
formatter.IndentationLevel -= 1;
formatter.AppendLine(eventInfo.ToString());
}
}
}
Imports System.Text
Imports System.Web
Imports System.Web.Management
' Implements a custom WebErrorstEvent that uses the
' WebThreadInformation.
Public Class SampleWebThreadInformation
Inherits WebErrorEvent
Private eventInfo As StringBuilder
' Instantiate events identified
' only by their event code.
Public Sub New(ByVal msg As String, _
ByVal eventSource As Object, _
ByVal eventCode As Integer, ByVal e As Exception)
MyBase.New(msg, eventSource, eventCode, e)
' Perform custom initialization.
eventInfo = New StringBuilder()
eventInfo.Append(String.Format("Event created at: {0}", EventTime.ToString()))
End Sub
' Raises the event.
Public Overrides Sub Raise()
' Perform custom processing.
eventInfo.Append(String.Format( _
"Event raised at: {0}", EventTime.ToString()))
' Raise the event.
MyBase.Raise()
End Sub
' Get the impersonation mode.
Public Function GetThreadImpersonation() As String
Return String.Format( _
"Is impersonating: {0}", _
ThreadInformation.IsImpersonating.ToString())
End Function 'GetThreadImpersonation
' Get the stack trace.
Public Function GetThreadStackTrace() As String
Return String.Format( _
"Stack trace: {0}", _
ThreadInformation.StackTrace)
End Function 'GetThreadStackTrace
' Get the account name.
Public Function GetThreadAccountName() As String
Return String.Format( _
"Request user host address: {0}", _
ThreadInformation.ThreadAccountName)
End Function 'GetThreadAccountName
' Get the task Id.
Public Function GetThreadId() As String
' Get the request principal.
Return String.Format( _
"Thread Id: {0}", _
ThreadInformation.ThreadID.ToString())
End Function 'GetThreadId
' Formats Web request event information.
Public Overrides Sub FormatCustomEventDetails( _
ByVal formatter As WebEventFormatter)
' Add custom data.
formatter.AppendLine("")
formatter.AppendLine( _
"Custom Thread Information:")
formatter.IndentationLevel += 1
' Display the thread information obtained
formatter.AppendLine(GetThreadImpersonation())
formatter.AppendLine(GetThreadStackTrace())
formatter.AppendLine(GetThreadAccountName())
formatter.AppendLine(GetThreadId())
formatter.IndentationLevel -= 1
formatter.AppendLine(eventInfo.ToString())
End Sub
End Class
Comentários
ASP.NET monitoramento de integridade permite que a equipe de produção e operações gerencie aplicativos Web implantados. O System.Web.Management namespace contém os tipos de evento de integridade responsáveis por empacotar dados de status de integridade do aplicativo e os tipos de provedor responsáveis por processar esses dados. Ele também contém tipos de suporte que ajudam durante o gerenciamento de eventos de integridade.
As instâncias da WebThreadInformation classe contêm informações obtidas usando o WebErrorEvent tipo ou o WebRequestErrorEvent tipo.
Seu aplicativo precisa das permissões apropriadas para acessar as informações protegidas fornecidas por esse tipo.
Observação
Na maioria dos casos, você poderá usar os tipos de monitoramento de integridade ASP.NET conforme implementado e controlará o sistema de monitoramento de integridade especificando valores na healthMonitoring
seção de configuração. Você também pode derivar dos tipos de monitoramento de integridade para criar seus próprios eventos e provedores personalizados. Para obter um exemplo de criação de uma classe de evento personalizada, consulte o exemplo fornecido neste tópico.
Propriedades
IsImpersonating |
Obtém o modo de representação do thread atual. |
StackTrace |
Obtém o rastreamento de pilha gerenciado pelo thread atual. |
ThreadAccountName |
Obtém o nome da conta do thread. |
ThreadID |
Obtém o identificador atual de thread. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
FormatToString(WebEventFormatter) |
Formata informações relacionadas ao thread. |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |