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


EventLog.WriteEntry Метод

Определение

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

Перегрузки

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

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

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[]

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

Исключения

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

//Create a byte array for binary data to associate with the entry.
array<Byte>^myByte = gcnew array<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.
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 обозначается значком и текстом в столбце Тип в Просмотр событий журнала. Этот параметр указывает, является ли тип события ошибкой, предупреждением, информацией, аудитом успешности или аудитом сбоя.

Перед записью первой записи с помощью источника необходимо создать и настроить источник событий. Create новый источник событий во время установки приложения. Это позволяет операционной системе обновить список зарегистрированных источников событий и их конфигурацию. Если операционная система не обновила свой список источников событий и вы попытаелись записать событие с новым источником, операция записи завершится ошибкой. Вы можете настроить новый источник с помощью 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

Вносит в журнал событий запись с заданным текстом сообщения и идентификатором события и категорией (которые определяется приложением), используя указанный зарегистрированный источник событий. С помощью 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

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

Исключения

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

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 );
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.

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

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

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

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

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

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

Примечание

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

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

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

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

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

Исходный код:
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[]

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

Исключения

Не задано свойство Source класса EventLog.

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

// Create the source, if it does not already exist.
String^ myLogName = "myNewLog";
if (  !EventLog::SourceExists( "MySource" ) )
{
   EventLog::CreateEventSource( "MySource", myLogName );
   Console::WriteLine( "Creating EventSource" );
}
else
   myLogName = EventLog::LogNameFromSourceName( "MySource", "." );

// Create an EventLog and assign source.
EventLog^ myEventLog = gcnew 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.
array<Byte>^ myRawData = gcnew array<Byte>(4);
for ( int i = 0; i < 4; i++ )
{
   myRawData[ i ] = 1;
}
Console::WriteLine( "Writing to EventLog.. " );
myEventLog->WriteEntry( myMessage, myEventLogEntryType, myApplicatinEventId, myApplicatinCategoryId, myRawData );
// 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)

Комментарии

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

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

Примечание

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

Примечание

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

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

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

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

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

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

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

Примечание

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

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

Примечание

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

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

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

Примечание

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

Примечание

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

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

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

WriteEntry(String, String, EventLogEntryType, Int32)

Исходный код:
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

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

Исключения

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

// Create the source, if it does not already exist.
if (  !EventLog::SourceExists( "MySource" ) )
{
   EventLog::CreateEventSource( "MySource", "myNewLog" );
   Console::WriteLine( "Creating EventSource" );
}

// 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(!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с источником однозначно идентифицируют событие. Каждое приложение может определить собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий представляют эти строки пользователю, чтобы помочь ему понять, что пошло не так, и предложить действия, которые следует предпринять.

Примечание

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

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

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

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

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

Примечание

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

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

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

WriteEntry(String, EventLogEntryType, Int32, Int16)

Исходный код:
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

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

Исключения

Не задано свойство Source класса EventLog.

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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.
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.

Примечание

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

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

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

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

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

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

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

Примечание

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

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

Примечание

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

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

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

Примечание

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

Примечание

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

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

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

WriteEntry(String, EventLogEntryType)

Исходный код:
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.

Исключения

Не задано свойство Source класса EventLog.

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

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

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog("MyNewLog");
   myLog->Source = "MyNewLogSource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing warning to event log.", EventLogEntryType::Warning );
}
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 обозначается значком и текстом в столбце Тип в Просмотр событий журнала.

Примечание

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

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

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

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

Примечание

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

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

Примечание

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

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

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

Примечание

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

Примечание

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

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

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

WriteEntry(String, EventLogEntryType, Int32)

Исходный код:
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

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

Исключения

Не задано свойство Source класса EventLog.

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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.
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 вместе с источником однозначно идентифицирует событие. Каждое приложение может определить собственные нумерованные события и строки описания, с которыми они сопоставляются. Средства просмотра событий отображают эти строковые значения, чтобы помочь пользователю понять, что пошло не так, и предложить действия, которые следует предпринять.

Примечание

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

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

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

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

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

Примечание

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

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

Примечание

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

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

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

Примечание

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

Примечание

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

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

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

WriteEntry(String, String)

Исходный код:
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

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

Исключения

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

-или-

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

-или-

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

-или-

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

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

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

Примеры

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

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "myNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing to event log." );
}
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.

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

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

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

Примечание

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

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

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

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

WriteEntry(String)

Исходный код:
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

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

Исключения

Не задано свойство Source класса EventLog.

-или-

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

-или-

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

-или-

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

-или-

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

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

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

Примеры

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

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int 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" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}
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.

Примечание

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

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

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

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

Примечание

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

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

Примечание

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

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

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

Примечание

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

Примечание

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

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

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

WriteEntry(String, String, EventLogEntryType)

Исходный код:
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.

Исключения

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

-или-

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

-или-

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

-или-

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

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

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

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

Примеры

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

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing warning to event log.", EventLogEntryType::Warning );
}
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 не может содержать %n, где n — целочисленное значение (например, %1), так как средство просмотра событий рассматривает ее как строку вставки. Так как ip-адрес версии 6 (IPv6) может содержать эту последовательность символов, невозможно записать в журнал сообщение о событии, содержащее IPv6-адрес.

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

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

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

Примечание

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

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

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