EventLog.LogNameFromSourceName(String, String) Método
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.
Obtém o nome do log no qual a origem especificada é registrada.
public:
static System::String ^ LogNameFromSourceName(System::String ^ source, System::String ^ machineName);
public static string LogNameFromSourceName (string source, string machineName);
static member LogNameFromSourceName : string * string -> string
Public Shared Function LogNameFromSourceName (source As String, machineName As String) As String
Parâmetros
- source
- String
O nome da origem do evento.
- machineName
- String
O nome do computador no qual procurar ou "." para o computador local.
Retornos
O nome do log associado à origem especificada no Registro.
Exemplos
O exemplo a seguir exclui uma origem do computador local. O exemplo determina o log de sua origem e, em seguida, exclui o log.
Observação
Mais de uma fonte pode gravar em um log de eventos. Antes de excluir um log personalizado, verifique se não há outras fontes gravando nesse log.
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
String^ logName;
if ( EventLog::SourceExists( "MySource" ) )
{
// Find the log associated with this source.
logName = EventLog::LogNameFromSourceName( "MySource", "." );
// Make sure the source is in the log we believe it to be in
if (logName != "MyLog")
return -1;
// Delete the source and the log.
EventLog::DeleteEventSource( "MySource" );
EventLog::Delete( logName );
Console::WriteLine( "{0} deleted.", logName );
}
else
{
// Create the event source to make next try successful.
EventLog::CreateEventSource("MySource", "MyLog");
}
}
using System;
using System.Diagnostics;
using System.Threading;
class MySample1
{
public static void Main()
{
string logName;
if (EventLog.SourceExists("MySource"))
{
// Find the log associated with this source.
logName = EventLog.LogNameFromSourceName("MySource", ".");
// Make sure the source is in the log we believe it to be in.
if (logName != "MyLog")
return;
// Delete the source and the log.
EventLog.DeleteEventSource("MySource");
EventLog.Delete(logName);
Console.WriteLine(logName + " deleted.");
}
else
{
// Create the event source to make next try successful.
EventLog.CreateEventSource("MySource", "MyLog");
}
}
}
Option Explicit On
Option Strict On
Imports System.Diagnostics
Imports System.Threading
Class MySample
Public Shared Sub Main()
Dim logName As String
If EventLog.SourceExists("MySource") Then
' Find the log associated with this source.
logName = EventLog.LogNameFromSourceName("MySource", ".")
' Make sure the source is in the log we believe it to be in
If (logName <> "MyLog") Then
Return
End If
' Delete the source and the log.
EventLog.DeleteEventSource("MySource")
EventLog.Delete(logName)
Console.WriteLine((logName & " deleted."))
Else
' Create the event source to make next try successful.
EventLog.CreateEventSource("MySource", "MyLog")
End If
End Sub
End Class
Comentários
A origem do evento indica o que registra o evento. Geralmente, é o nome do aplicativo ou o nome de um subcomponente do aplicativo, se o aplicativo for grande. Aplicativos e serviços devem gravar no log do aplicativo ou em um log personalizado. Os drivers de dispositivo devem gravar no log do sistema.
Quando você cria uma nova fonte, que só pode gravar em um log por vez, o sistema registra seu aplicativo com o log de eventos como uma fonte válida de entradas. A Source propriedade pode ser qualquer cadeia de caracteres, mas o nome não pode ser usado por outras fontes no computador. Uma tentativa de criar um valor duplicado Source gera uma exceção. No entanto, um único log de eventos pode ter várias fontes diferentes gravando nele.