EventLog.Exists Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacote:

System.Diagnostics.EventLog v8.0.0

Determina se o log especificado existe.

Sobrecargas

Exists(String)	Determina se o log existe no computador local.
Exists(String, String)	Determina se o log existe no computador especificado.

Exists(String)

Origem:

EventLog.cs

Determina se o log existe no computador local.

public:
 static bool Exists(System::String ^ logName);

public static bool Exists (string logName);

static member Exists : string -> bool

Public Shared Function Exists (logName As String) As Boolean

Parâmetros

logName

String

O nome do log a ser pesquisado. Os valores possíveis incluem: aplicativos, segurança, sistema, outros logs específicos do aplicativo (como aqueles associados ao Active Directory) ou qualquer log personalizado no computador.

Retornos

Boolean

true se o log existir no computador local; caso contrário, false.

Exceções

ArgumentException

O logName é null ou o valor está vazio.

Exemplos

      String^ myLog = "myNewLog";
      if ( EventLog::Exists( myLog ) )
      {
         Console::WriteLine( "Log '{0}' exists.", myLog );
      }
      else
      {
         Console::WriteLine( "Log '{0}' does not exist.", myLog );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }

}

string myLog = "myNewLog";
if (EventLog.Exists(myLog))
{
   Console.WriteLine("Log '"+myLog+"' exists.");
}
else
{
   Console.WriteLine("Log '"+myLog+"' does not exist.");
}

Dim myLog As String = "myNewLog"
If EventLog.Exists(myLog) Then
   Console.WriteLine("Log '" + myLog + "' exists.")
Else
   Console.WriteLine("Log '" + myLog + "' does not exist.")
End If

Comentários

Use esse método para determinar se existe um log no computador local. Se você quiser determinar se existe uma origem no computador local, use SourceExists.

Como esse método acessa o registro, você deve ter as permissões de registro apropriadas no computador local; caso contrário, a consulta retornará false.

Como você não pode dar a um novo log o nome de um log existente no mesmo computador, use esse método antes de criar um novo log para determinar se o especificado logName já existe no computador local. O logName parâmetro não diferencia maiúsculas de minúsculas.

Exists é um static método , portanto, ele pode ser chamado na própria classe. Não é necessário criar uma instância do EventLog para chamar Exists.

Confira também

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log

Exists(String, String)

Origem:

EventLog.cs

Determina se o log existe no computador especificado.

public:
 static bool Exists(System::String ^ logName, System::String ^ machineName);

public static bool Exists (string logName, string machineName);

static member Exists : string * string -> bool

Public Shared Function Exists (logName As String, machineName As String) As Boolean

Parâmetros

logName

String

O log pelo qual pesquisar. Os valores possíveis incluem: aplicativos, segurança, sistema, outros logs específicos do aplicativo (como aqueles associados ao Active Directory) ou qualquer log personalizado no computador.

machineName

String

O nome do computador no qual pesquisar pelo log ou "." para o computador local.

Retornos

Boolean

true se o log existir no computador especificado; caso contrário, false.

Exceções

ArgumentException

O parâmetro machineName está em um formato inválido. Verifique se que você usou a sintaxe apropriada para o computador no qual você está pesquisando.

- ou -

O logName é null ou o valor está vazio.

Comentários

Use esse método para determinar se existe um log em um computador remoto. Se você quiser determinar se existe uma origem em um computador remoto, use SourceExists.

Como esse método acessa o registro, você deve ter as permissões de registro apropriadas no computador especificado; caso contrário, a consulta retornará false.

Como você não pode dar a um novo log o nome de um log existente no mesmo computador, use esse método antes de criar um novo log para determinar se um com o especificado logName já existe no servidor especificado pelo machineName parâmetro . Os logName parâmetros e machineName não diferenciam maiúsculas de minúsculas.

Exists é um static método , portanto, ele pode ser chamado na própria classe. Não é necessário criar uma nova instância do EventLog para chamar Exists.

Confira também

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log
• MachineName