EventLog.WriteEntry Метод

Определение

Пространство имен:: System.Diagnostics

Сборка:: System.Diagnostics.EventLog.dll

Сборка:: System.dll

Пакет:: System.Diagnostics.EventLog v11.0.0-preview.2.26159.112

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает запись в журнал событий.

Перегрузки

Имя	Описание
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий (с использованием указанного зарегистрированного источника событий) и добавляет двоичные данные в сообщение.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий, используя указанный зарегистрированный источник событий. Средство `category` просмотра событий может использовать для фильтрации событий в журнале.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий, и добавляет двоичные данные в сообщение.
WriteEntry(String, String, EventLogEntryType, Int32)	Записывает запись с заданным текстом сообщения и идентификатором события, определяемым приложением, в журнал событий с помощью указанного зарегистрированного источника событий.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий.
WriteEntry(String, EventLogEntryType)	Записывает ошибку, предупреждение, информацию, аудит успешности или запись аудита сбоя с заданным текстом сообщения в журнал событий.
WriteEntry(String, EventLogEntryType, Int32)	Записывает запись с заданным текстом сообщения и идентификатором события, определяемым приложением, в журнал событий.
WriteEntry(String, String)	Записывает запись типа информации с заданным текстом сообщения в журнал событий, используя указанный зарегистрированный источник событий.
WriteEntry(String)	Записывает запись типа информации с заданным текстом сообщения в журнал событий.
WriteEntry(String, String, EventLogEntryType)	Записывает ошибку, предупреждение, сведения, аудит успешности или запись аудита сбоя с заданным текстом сообщения в журнал событий с использованием указанного зарегистрированного источника событий.

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

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

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

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

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

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

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

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

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

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

Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий (с использованием указанного зарегистрированного источника событий) и добавляет двоичные данные в сообщение.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Параметры

source: String

Источник, по которому приложение зарегистрировано на указанном компьютере.

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

category: Int16

Подкатегория для конкретного приложения, связанного с сообщением.

rawData: Byte[]

Массив байтов, содержащий двоичные данные, связанные с записью.

Исключения

ArgumentException

Значение source является пустой строкой ("").

–или–

Значение source равно null.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

Win32Exception

Операционная система сообщила об ошибке при записи записи записи события в журнал событий. Код ошибки Windows недоступен.

Примеры

//Create a byte array for binary data to associate with the entry.
byte[] myByte = new byte[10];
//Populate the byte array with simulated data.
for (int i = 0; i < 10; i++)
{
    myByte[i] = (byte)(i % 2);
}
// Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ");
EventLog.WriteEntry("SecondSource", "Writing warning to event log.",
                     EventLogEntryType.Error, myEventID, myCategory, myByte);

' Create a byte array for binary data to associate with the entry.
Dim myByte(9) As Byte
Dim i As Integer
' Populate the byte array with simulated data.
For i = 0 To 9
    myByte(i) = CByte(i Mod 2)
Next i
' Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ")
EventLog.WriteEntry("SecondSource", "Writing warning to event log.", _
                     EventLogEntryType.Error, myEventID, myCategory, myByte)

Используйте этот метод для записи данных, определенных приложением, в журнал событий, используя источник, уже зарегистрированный в качестве источника событий для соответствующего журнала. Средство просмотра событий не интерпретирует эти данные; он отображает необработанные данные только в объединенном шестнадцатеричном и текстовом формате. Использование разреженных данных для конкретных событий; включите его только в том случае, если вы уверены, что это будет полезно. Вы также можете использовать данные, относящиеся к событиям, для хранения информации, которую приложение может обрабатывать независимо от средства просмотра событий. Например, вы можете написать средство просмотра специально для событий или написать программу, которая сканирует файл журнала и создает отчеты, содержащие сведения из данных, относящихся к событиям.

Помимо двоичных данных можно указать определяемую приложением категорию и идентификатор события, определяемый приложением. Средство просмотра событий использует категорию для фильтрации событий, написанных источником событий. Средство просмотра событий может отображать категорию в виде числового значения или использовать ее в качестве идентификатора ресурса для отображения локализованной строки категории.

Замечание

Параметр category должен быть положительным значением. Отрицательные значения категорий отображаются как дополнительное положительное число в средстве просмотра событий. Например, -10 будет отображаться как 65 526, -1 как 65 535.

Чтобы отобразить локализованные строки категорий в средстве просмотра событий, необходимо использовать источник событий, настроенный с помощью файла ресурса категории, и задать category идентификатор ресурса в файле ресурса категории. Если источник событий не содержит настроенный файл ресурса категории или указанный category не индексировать строку в файле ресурсов категории, средство просмотра событий отображает числовое значение категории для этой записи. Настройте файл ресурса категории, а также количество строк категорий в файле ресурса с помощью EventLogInstaller класса или EventSourceCreationData класса.

Идентификаторы событий вместе с источником событий однозначно идентифицируют событие. Каждое приложение может определять собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий отображают эти строковые значения, чтобы помочь пользователю понять, что пошло не так, и предложить какие действия следует предпринять.

Наконец, можно указать EventLogEntryType событие, записанное в журнал событий. Отображается type значком и текстом в столбце "Тип" в средстве просмотра событий для журнала. Этот параметр указывает, является ли тип события ошибкой, предупреждением, информацией, аудитом успешности или аудитом сбоя.

Перед записью первой записи с исходным кодом необходимо создать и настроить источник событий. Создайте новый источник событий во время установки приложения. Это позволяет операционной системе обновлять список зарегистрированных источников событий и их конфигурацию. Если операционная система не обновила свой список источников событий и попытается написать событие с новым источником, операция записи завершится ошибкой. Вы можете настроить новый источник с помощью EventLogInstallerметода или использовать CreateEventSource его. Для создания нового источника событий необходимо иметь права администратора на компьютере.

Источник должен быть настроен для записи локализованных записей или для записи прямых строк. Метод записывает указанную строку непосредственно в журнал событий. Он WriteEntry не использует файл ресурса локализуемого сообщения. WriteEvent Используйте метод для записи событий с помощью локализованного файла ресурса сообщения.

Если приложение записывает записи с помощью идентификаторов ресурсов и строковых значений, необходимо зарегистрировать два отдельных источника. Например, настройте один источник с файлами ресурсов, а затем используйте этот источник в методе WriteEvent для записи записей с помощью идентификаторов ресурсов в журнал событий. Затем создайте другой источник без файлов ресурсов и используйте этот источник в методе WriteEntry для записи строк непосредственно в журнал событий с помощью этого источника.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

Строка message не может содержать %n, где n является целым значением (например, %1), так как средство просмотра событий обрабатывает его как строку вставки. Так как ip-протокол версии 6 (IPv6) может содержать эту последовательность символов, невозможно записать сообщение о событии, содержащее IPv6-адрес.

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

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

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

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

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

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

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

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

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

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

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

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

Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий, используя указанный зарегистрированный источник событий. Средство category просмотра событий может использовать для фильтрации событий в журнале.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Параметры

source: String

Источник, по которому приложение зарегистрировано на указанном компьютере.

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

category: Int16

Подкатегория для конкретного приложения, связанного с сообщением.

Исключения

ArgumentException

Значение source является пустой строкой ("").

–или–

Значение source равно null.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

int myEventID = 20;
short myCategory = 10;
// Write an informational entry to the event log.
Console.WriteLine("Write from first source ");
EventLog.WriteEntry("FirstSource", "Writing warning to event log.",
                     EventLogEntryType.Information, myEventID, myCategory);

Dim myEventID As Integer = 10
Dim myCategory As Short = 20
' Write an informational entry to the event log.
Console.WriteLine("Write from first source ")
EventLog.WriteEntry("FirstSource", "Writing warning to event log.", _
                           EventLogEntryType.Information, myEventID, myCategory)

Используйте этот метод для записи записи с приложением, определенной category в журнал событий, используя источник, который уже зарегистрирован в качестве источника событий для соответствующего журнала. Средство просмотра событий использует категорию для фильтрации событий, написанных источником событий. Средство просмотра событий может отображать категорию в виде числового значения или использовать ее в качестве идентификатора ресурса для отображения локализованной строки категории.

Замечание

Параметр category должен быть положительным значением. Отрицательные значения категорий отображаются как дополнительное положительное число в средстве просмотра событий. Например, -10 отображается как 65 526, -1 как 65 535.

Помимо категории, можно указать идентификатор события для события, записываемого в журнал событий. Идентификаторы событий, а также источник событий, однозначно определяют событие. Каждое приложение может определять собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий отображают эти строковые значения, чтобы помочь пользователю понять, что пошло не так, и предложить какие действия следует предпринять.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

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

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

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

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

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

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

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

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

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

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

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Параметры

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

category: Int16

Подкатегория для конкретного приложения, связанного с сообщением.

rawData: Byte[]

Массив байтов, содержащий двоичные данные, связанные с записью.

Исключения

ArgumentException

Свойство Source не EventLog задано.

–или–

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

–или–

Источник уже зарегистрирован для другого журнала событий.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

// Create the source, if it does not already exist.
string myLogName = "myNewLog";
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", myLogName);
   Console.WriteLine("Created EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   return;
}
else
   {
       myLogName = EventLog.LogNameFromSourceName("MySource",".");
   }
   // Create an EventLog and assign source.
   EventLog myEventLog = new EventLog();
myEventLog.Source = "MySource";
myEventLog.Log = myLogName;

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
byte[] myRawData = new byte[4];
for(int i=0;i<4;i++)
{
   myRawData[i]=1;
}
// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
myEventLog.WriteEntry(myMessage,myEventLogEntryType,
   myApplicatinEventId, myApplicatinCategoryId, myRawData);

' Create the source, if it does not already exist.
dim myLogName as string = "myNewLog"
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", myLogName)
   Console.WriteLine("Creating EventSource")
else
   myLogName = EventLog.LogNameFromSourceName("MySource",".")
End If

' Create an EventLog and assign source.
Dim myEventLog As New EventLog()
myEventLog.Source = "MySource"
myEventLog.Log = myLogName

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicatinEventId As Integer = 1100
Dim myApplicatinCategoryId As Short = 1

' Set the 'data' for the event.
Dim myRawData(3) As Byte
Dim i As Integer
For i = 0 To 3
   myRawData(i) = 1
Next i
' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
myEventLog.WriteEntry(myMessage, myEventLogEntryType, myApplicatinEventId, _
                     myApplicatinCategoryId, myRawData)

Используйте эту перегрузку для записи данных, определенных приложением, в журнал событий. Средство просмотра событий не интерпретирует эти данные; он отображает необработанные данные только в объединенном шестнадцатеричном и текстовом формате. Используйте данные, относящиеся к событиям, в том числе только в том случае, если вы уверены, что это будет полезно для отладчика проблемы. Вы также можете использовать данные, относящиеся к событиям, для хранения информации, которую приложение может обрабатывать независимо от средства просмотра событий. Например, вы можете написать средство просмотра специально для событий или написать программу, которая сканирует файл журнала и создает отчеты, содержащие сведения из данных, относящихся к событиям.

Замечание

Параметр category должен быть положительным значением. Отрицательные значения категорий отображаются как дополнительное положительное число в средстве просмотра событий. Например, -10 отображается как 65 526, -1 как 65 535.

Идентификаторы событий, а также источник событий, однозначно определяют событие. Каждое приложение может определять собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий отображают эти строковые значения, чтобы помочь пользователю понять, что пошло не так, и предложить какие действия следует предпринять.

Чтобы записать записи в журнал, необходимо задать Source свойство компонента EventLog . Перед записью первой записи с исходным кодом необходимо создать и настроить источник событий.

Создайте новый источник событий во время установки приложения. Это позволяет операционной системе обновлять список зарегистрированных источников событий и их конфигурацию. Если операционная система не обновила свой список источников событий и попытается написать событие с новым источником, операция записи завершится ошибкой. Вы можете настроить новый источник с помощью EventLogInstallerметода или использовать CreateEventSource его. Для создания нового источника событий необходимо иметь права администратора на компьютере.

Если источник, указанный в Source свойстве этого EventLog экземпляра, не зарегистрирован на компьютере, в который записывается компонент, WriteEntry вызывает CreateEventSource и регистрирует источник.

Замечание

Если вы не указываете экземпляр EventLog перед вызовом MachineName CreateEventSource или WriteEntryпредполагается, что локальный компьютер (".") не указан.

Если системе необходимо зарегистрировать Source вызов WriteEntry и Log свойство не было задано в экземпляре EventLog , журнал по умолчанию используется в журнале приложений.

Замечание

Многие исключения, перечисленные выше, создаются ошибками, возникающими во время регистрации Source.

Замечание

Если запись записывается на удаленный компьютер, значение сообщения (текстовой строки) может не быть ожидаемым, если удаленный компьютер не работает на платформе .NET Framework.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, String, EventLogEntryType, Int32)

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

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

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

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

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

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

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

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

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

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

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

Параметры

source: String

Источник, по которому приложение зарегистрировано на указанном компьютере.

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

Исключения

ArgumentException

Значение source является пустой строкой ("").

–или–

Значение source равно null.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

// 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("Creating EventSource");
   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;
}

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource",myMessage,
   myEventLogEntryType, myApplicationEventId);

' Create the source, if it does not already exist.
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", "myNewLog")
   Console.WriteLine("Creating EventSource")
End If

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicationEventId As Integer = 100

' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
EventLog.WriteEntry("MySource", myMessage, myEventLogEntryType, myApplicationEventId)

Используйте этот метод для записи записи с приложением, определенной eventID в журнал событий, используя источник, уже зарегистрированный в качестве источника событий для соответствующего журнала. Объект eventID, а также источник, однозначно идентифицирует событие. Каждое приложение может определять собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий представляют эти строки пользователю, чтобы помочь пользователю понять, что пошло не так, и предложить какие действия следует предпринять.

Замечание

Помимо идентификатора события эта перегрузка WriteEntry позволяет указать EventLogEntryType событие, записанное в журнал событий. Отображается type значком и текстом в столбце "Тип" в средстве просмотра событий для журнала. Этот параметр указывает, является ли тип события ошибкой, предупреждением, информацией, аудитом успешности или аудитом сбоя.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, EventLogEntryType, Int32, Int16)

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

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

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

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

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

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

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

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

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

Записывает запись с заданным текстом сообщения, идентификатором события, определяемым приложением, и определяемой приложением категорией в журнал событий.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Параметры

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

category: Int16

Подкатегория для конкретного приложения, связанного с сообщением.

Исключения

ArgumentException

Свойство Source не EventLog задано.

–или–

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

–или–

Источник уже зарегистрирован для другого журнала событий.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

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

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

Используйте этот метод для записи записи с приложением, определенной category в журнал событий. Средство просмотра событий использует категорию для фильтрации событий, написанных источником событий. Средство просмотра событий может отображать категорию в виде числового значения или использовать ее в качестве идентификатора ресурса для отображения локализованной строки категории.

Замечание

Параметр category должен быть положительным значением. Отрицательные значения категорий отображаются как дополнительное положительное число в средстве просмотра событий. Например, -10 отображается как 65 526, -1 как 65 535.

Замечание

Многие исключения, перечисленные выше, создаются ошибками, возникающими во время регистрации Source.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, EventLogEntryType)

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

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

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

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

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

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

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

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

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

Записывает ошибку, предупреждение, информацию, аудит успешности или запись аудита сбоя с заданным текстом сообщения в журнал событий.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType)

Параметры

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

Исключения

ArgumentException

Свойство Source не EventLog задано.

–или–

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

–или–

Источник уже зарегистрирован для другого журнала событий.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

Win32Exception

Примеры

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

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

class MySample1
{

    public static void Main()
    {

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

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("MyNewLog")
        myLog.Source = "MyNewLogSource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning)
    End Sub
End Class

Используйте этот метод для записи записи указанной EventLogEntryType записи в журнал событий. Отображается type значком и текстом в столбце "Тип" в средстве просмотра событий для журнала.

Замечание

Многие исключения, перечисленные выше, создаются ошибками, возникающими во время регистрации Source.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, EventLogEntryType, Int32)

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

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

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

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

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

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

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

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

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

Записывает запись с заданным текстом сообщения и идентификатором события, определяемым приложением, в журнал событий.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

Параметры

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

eventID: Int32

Идентификатор конкретного приложения для события.

Исключения

ArgumentException

Свойство Source не EventLog задано.

–или–

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

–или–

Источник уже зарегистрирован для другого журнала событий.

–или–

eventID меньше нуля или больше UInt16.MaxValue.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

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

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

Используйте этот метод для записи записи с приложением, определенной eventID в журнал событий. Вместе eventID с источником однозначно идентифицирует событие. Каждое приложение может определять собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий отображают эти строковые значения, чтобы помочь пользователю понять, что пошло не так, и предложить какие действия следует предпринять.

Замечание

Помимо идентификатора события, можно указать EventLogEntryType событие, записываемое в журнал событий. Отображается type значком и текстом в столбце "Тип" в средстве просмотра событий для журнала. Этот параметр указывает, является ли тип события ошибкой, предупреждением, информацией, аудитом успешности или аудитом сбоя.

Замечание

Многие исключения, перечисленные выше, создаются ошибками, возникающими во время регистрации Source.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, String)

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

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

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

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

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

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

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

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

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

Записывает запись типа информации с заданным текстом сообщения в журнал событий, используя указанный зарегистрированный источник событий.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);

public static void WriteEntry(string source, string message);

static member WriteEntry : string * string -> unit

Public Shared Sub WriteEntry (source As String, message As String)

Параметры

source: String

Источник, по которому приложение зарегистрировано на указанном компьютере.

message: String

Строка для записи в журнал событий.

Исключения

ArgumentException

Значение source является пустой строкой ("").

–или–

Значение source равно null.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

Win32Exception

Примеры

В следующем примере создается источник 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;
        }

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource", "Writing to event log.");
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "myNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing to event log.")
    End Sub
End Class

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

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String)

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

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

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

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

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

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

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

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

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

Записывает запись типа информации с заданным текстом сообщения в журнал событий.

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Параметры

message: String

Строка для записи в журнал событий.

Исключения

ArgumentException

Свойство Source не EventLog задано.

–или–

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

–или–

Источник уже зарегистрирован для другого журнала событий.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

Win32Exception

Примеры

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("CreatedEventSource");
            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.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' 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")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Используйте этот метод для записи сведений в журнал событий, связанный с этим EventLog экземпляром. Если вы хотите указать любой другой EventLogEntryType, используйте другую перегрузку WriteEntry.

Замечание

Многие из перечисленных выше исключений создаются ошибками, возникающими во время регистрации Source.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

WriteEntry(String, String, EventLogEntryType)

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

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

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

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

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

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

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

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

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

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

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

Параметры

source: String

Источник, по которому приложение зарегистрировано на указанном компьютере.

message: String

Строка для записи в журнал событий.

type: EventLogEntryType

Одно из значений EventLogEntryType .

Исключения

ArgumentException

Значение source является пустой строкой ("").

–или–

Значение source равно null.

–или–

Строка сообщения превышает 31 839 байт (32 766 байт в операционных системах Windows до Windows Vista).

–или–

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

InvalidOperationException

Не удалось открыть раздел реестра для журнала событий.

InvalidEnumArgumentException

type не является допустимым EventLogEntryType.

Win32Exception

Примеры

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

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

class MySample2
{

    public static void Main()
    {

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource",
            "Writing warning to event log.",
            EventLogEntryType.Warning);
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing warning to event log.", _
            EventLogEntryType.Warning)
    End Sub
End Class

Используйте этот метод для записи записи указанного EventLogEntryType в журнал событий, используя источник, уже зарегистрированный в качестве источника событий для соответствующего журнала. Отображается type значком и текстом в столбце "Тип" в средстве просмотра событий для журнала.

Замечание

message Если параметр содержит символ NUL, сообщение в журнале событий завершается символом NUL.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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

EventLog.WriteEntry Метод

Определение

Перегрузки

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, String, EventLogEntryType, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, EventLogEntryType, Int32, Int16)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, EventLogEntryType)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, EventLogEntryType, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, String)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String)

Параметры

Исключения

Примеры

Комментарии

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

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

WriteEntry(String, String, EventLogEntryType)

Параметры

Исключения

Примеры

Комментарии

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

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

Обратная связь