Прочитать на английском

Поделиться через


EventLog.SourceExists Метод

Определение

Выполняет поиск заданного источника событий в реестре компьютера.

Перегрузки

SourceExists(String)

Определяет, зарегистрирован ли источник событий на локальном компьютере.

SourceExists(String, String)

Определяет, зарегистрирован ли источник событий на указанном компьютере.

SourceExists(String)

Исходный код:
EventLog.cs
Исходный код:
EventLog.cs
Исходный код:
EventLog.cs

Определяет, зарегистрирован ли источник событий на локальном компьютере.

public static bool SourceExists (string source);

Параметры

source
String

Имя источника событий.

Возвращаемое значение

Значение true, если источник событий зарегистрирован на локальном компьютере; в противном случае — false.

Исключения

source не найден, но поиск некоторых или всех журналов событий не был произведен.

Примеры

В следующем примере создается источник MySource , если он еще не существует, и записывается запись в журнал MyNewLogсобытий .

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");

        Console.WriteLine("Message written to event log.");
    }
}

Комментарии

Используйте этот метод, чтобы определить, существует ли источник событий на локальном компьютере. Если вы хотите определить, существует ли журнал на локальном компьютере, используйте .Exists

Так как этот метод обращается к реестру, необходимо иметь соответствующие разрешения реестра на локальном компьютере. SecurityException В противном случае будет создано исключение .

Примечание

Для поиска источника событий в Windows Vista и более поздних версиях или Windows Server 2003 необходимо иметь права администратора.

Это требование заключается в том, что все журналы событий, включая безопасность, должны выполняться поиск, чтобы определить, является ли источник событий уникальным. Начиная с Windows Vista, у пользователей нет разрешения на доступ к журналу безопасности; поэтому возникает SecurityException исключение .

Начиная с Windows Vista контроль учетных записей (UAC) определяет привилегии пользователя. Члену встроенной группы "Администраторы" присваивается два маркера доступа на время выполнения: маркер доступа обычного пользователя и маркер доступа администратора. По умолчанию назначена роль обычного пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от обычного пользователя до администратора. Это можно сделать при запуске приложения, , щелкнув значок приложения правой кнопкой мыши и указав, что приложение должно запускаться от имени администратора.

Примечание

Служба, которая выполняется под учетной записью LocalSystem , не имеет привилегий, необходимых для выполнения этого метода. Решение заключается в том, чтобы проверка, существует ли источник события в ServiceInstaller, и, если он не существует, создать источник в установщике.

Так как вы не можете присвоить новому источнику имя существующего источника на том же компьютере, используйте этот метод перед попыткой вызова CreateEventSource , чтобы убедиться, что источник с именем, указанным параметром, еще не существует на локальном source компьютере. В параметре source регистр не учитывается.

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SourceExists(String, String)

Исходный код:
EventLog.cs
Исходный код:
EventLog.cs
Исходный код:
EventLog.cs

Определяет, зарегистрирован ли источник событий на указанном компьютере.

public static bool SourceExists (string source, string machineName);

Параметры

source
String

Имя источника событий.

machineName
String

Имя компьютера, на котором выполняется поиск, или значение ".", если используется локальный компьютер.

Возвращаемое значение

Значение true, если источник событий зарегистрирован на заданном компьютере; в противном случае — значение false

Исключения

Значение параметра machineName не является допустимым именем компьютера.

source не найден, но поиск некоторых или всех журналов событий не был произведен.

Примеры

В следующем примере создается источник MySource на компьютере MyServerи записывается запись в журнал MyNewLogсобытий .

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource", "MyServer"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog", "MyServer");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");

        Console.WriteLine("Message written to event log.");
    }
}

Комментарии

Используйте этот метод, чтобы определить, существует ли источник событий на компьютере, указанном параметром machineName . Если вы хотите определить, существует ли журнал на указанном компьютере, используйте .Exists

Так как этот метод обращается к реестру, необходимо иметь соответствующие разрешения реестра на данном сервере. SecurityException В противном случае будет создано исключение .

Примечание

Для поиска источника событий в Windows Vista и более поздних версиях или Windows Server 2003 необходимо иметь права администратора.

Это требование заключается в том, что все журналы событий, включая безопасность, должны выполняться поиск, чтобы определить, является ли источник событий уникальным. Начиная с Windows Vista, у пользователей нет разрешения на доступ к журналу безопасности; поэтому возникает SecurityException исключение .

Начиная с Windows Vista контроль учетных записей (UAC) определяет привилегии пользователя. Члену встроенной группы "Администраторы" присваивается два маркера доступа на время выполнения: маркер доступа обычного пользователя и маркер доступа администратора. По умолчанию назначена роль обычного пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от обычного пользователя до администратора. Это можно сделать при запуске приложения, , щелкнув значок приложения правой кнопкой мыши и указав, что приложение должно запускаться от имени администратора.

Примечание

Служба, которая выполняется под учетной записью LocalSystem , не имеет привилегий, необходимых для выполнения этого метода. Решение заключается в том, чтобы проверка, существует ли источник события в ServiceInstaller, и, если он не существует, создать источник в установщике.

Так как вы не можете присвоить новому источнику имя существующего источника на том же компьютере, используйте этот метод перед попыткой вызова CreateEventSource , чтобы убедиться, что источник с именем, указанным параметром source , еще не существует на компьютере. Параметры source и machineName не чувствительны к регистру.

SourceExists static— это метод, поэтому его можно вызвать в самом классе. Нет необходимости создавать экземпляр для EventLog вызова SourceExists.

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9