EventLog.WriteEntry Metode

Referensi

Definisi

Ruang nama:: System.Diagnostics

Rakitan:: System.Diagnostics.EventLog.dll

Rakitan:: System.dll

Paket:: System.Diagnostics.EventLog v6.0.0

Paket:: System.Diagnostics.EventLog v7.0.0

Paket:: System.Diagnostics.EventLog v8.0.0

Paket:: System.Diagnostics.EventLog v9.0.0-preview.2.24128.5

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menulis entri di log peristiwa.

Overload

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa (menggunakan sumber peristiwa terdaftar yang ditentukan) dan menambahkan data biner ke pesan.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan. `category` dapat digunakan oleh Pemantau Peristiwa untuk memfilter peristiwa di log.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa, dan menambahkan data biner ke pesan.
WriteEntry(String, String, EventLogEntryType, Int32)	Menulis entri dengan teks pesan yang diberikan dan pengidentifikasi peristiwa yang ditentukan aplikasi ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa.
WriteEntry(String, EventLogEntryType)	Menulis kesalahan, peringatan, informasi, audit keberhasilan, atau entri audit kegagalan dengan teks pesan yang diberikan ke log peristiwa.
WriteEntry(String, EventLogEntryType, Int32)	Menulis entri dengan teks pesan yang diberikan dan pengidentifikasi peristiwa yang ditentukan aplikasi ke log peristiwa.
WriteEntry(String, String)	Menulis entri jenis informasi dengan teks pesan yang diberikan ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.
WriteEntry(String)	Menulis entri jenis informasi, dengan teks pesan yang diberikan, ke log peristiwa.
WriteEntry(String, String, EventLogEntryType)	Menulis kesalahan, peringatan, informasi, audit keberhasilan, atau entri audit kegagalan dengan teks pesan yang diberikan ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.

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

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa (menggunakan sumber peristiwa terdaftar yang ditentukan) dan menambahkan data biner ke pesan.

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())

Parameter

source: String

Sumber tempat aplikasi didaftarkan pada komputer yang ditentukan.

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

category: Int16

Subkataan khusus aplikasi yang terkait dengan pesan.

rawData: Byte[]

Array byte yang menyimpan data biner yang terkait dengan entri.

Pengecualian

ArgumentException

Nilainya source adalah string kosong ("").

-atau-

Nilai source adalah null.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

//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)

Keterangan

Gunakan metode ini untuk menulis data khusus peristiwa yang ditentukan aplikasi ke log peristiwa, menggunakan sumber yang sudah terdaftar sebagai sumber peristiwa untuk log yang sesuai. Pemantau Peristiwa tidak menginterpretasikan data ini; data mentah hanya menampilkan data mentah dalam format heksadesimal dan teks gabungan. Gunakan data khusus peristiwa dengan hemat; sertakan hanya jika Anda yakin itu akan berguna. Anda juga dapat menggunakan data khusus peristiwa untuk menyimpan informasi yang dapat diproses aplikasi secara independen dari Pemantau Peristiwa. Misalnya, Anda dapat menulis penampil khusus untuk peristiwa Anda, atau menulis program yang memindai logfile dan membuat laporan yang menyertakan informasi dari data khusus peristiwa.

Selain data biner, Anda dapat menentukan kategori yang ditentukan aplikasi dan pengidentifikasi peristiwa yang ditentukan aplikasi. Pemantau Peristiwa menggunakan kategori untuk memfilter peristiwa yang ditulis oleh sumber peristiwa. Pemantau Peristiwa dapat menampilkan kategori sebagai nilai numerik, atau dapat menggunakan kategori sebagai pengidentifikasi sumber daya untuk menampilkan string kategori yang dilokalkan.

Catatan

Parameter category harus menjadi nilai positif. Nilai kategori negatif muncul sebagai angka positif pelengkap dalam Pemantau Peristiwa. Misalnya, -10 akan muncul sebagai 65.526, -1 sebagai 65.535.

Untuk menampilkan string kategori yang dilokalkan dalam Pemantau Peristiwa, Anda harus menggunakan sumber peristiwa yang dikonfigurasi dengan file sumber daya kategori, dan mengatur category ke pengidentifikasi sumber daya dalam file sumber daya kategori. Jika sumber kejadian tidak memiliki file sumber daya kategori yang dikonfigurasi, atau yang ditentukan category tidak mengindeks string dalam file sumber daya kategori, maka Pemantau Peristiwa menampilkan nilai kategori numerik untuk entri tersebut. Konfigurasikan file sumber daya kategori, bersama dengan jumlah string kategori dalam file sumber daya, menggunakan EventLogInstaller atau EventSourceCreationData kelas .

Pengidentifikasi peristiwa, bersama dengan sumber peristiwa, secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang mereka petakan. Penampil peristiwa menampilkan nilai string ini untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Terakhir, Anda dapat menentukan untuk peristiwa yang EventLogEntryType ditulis ke log peristiwa. ditunjukkan type oleh ikon dan teks di kolom Jenis di Pemantau Peristiwa untuk log. Parameter ini menunjukkan apakah jenis peristiwa adalah kesalahan, peringatan, informasi, audit keberhasilan, atau audit kegagalan.

Anda harus membuat dan mengonfigurasi sumber kejadian sebelum menulis entri pertama dengan sumbernya. Create sumber kejadian baru selama penginstalan aplikasi Anda. Ini memungkinkan waktu bagi sistem operasi untuk me-refresh daftar sumber peristiwa terdaftar dan konfigurasinya. Jika sistem operasi belum merefresh daftar sumber peristiwanya, dan Anda mencoba menulis peristiwa dengan sumber baru, operasi tulis akan gagal. Anda dapat mengonfigurasi sumber baru menggunakan EventLogInstaller, atau menggunakan CreateEventSource metode . Anda harus memiliki hak administratif pada komputer untuk membuat sumber kejadian baru.

Sumber harus dikonfigurasi baik untuk menulis entri yang dilokalkan atau untuk menulis string langsung. Metode WriteEntry menulis string yang diberikan langsung ke log peristiwa; metode ini tidak menggunakan file sumber daya pesan yang dapat dilokalkan. WriteEvent Gunakan metode untuk menulis peristiwa menggunakan file sumber daya pesan yang dilokalkan.

Jika aplikasi Anda menulis entri menggunakan pengidentifikasi sumber daya dan nilai string, Anda harus mendaftarkan dua sumber terpisah. Misalnya, konfigurasikan satu sumber dengan file sumber daya, lalu gunakan sumber tersebut WriteEvent dalam metode untuk menulis entri menggunakan pengidentifikasi sumber daya ke log peristiwa. Kemudian buat sumber yang berbeda tanpa file sumber daya, dan gunakan sumber tersebut WriteEntry dalam metode untuk menulis string langsung ke log peristiwa menggunakan sumber tersebut.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

String message tidak boleh berisi %n, di mana n adalah nilai bilangan bulat (misalnya, %1), karena penampil kejadian memperlakukannya sebagai string penyisipan. Karena alamat Protokol Internet versi 6 (IPv6) bisa berisi urutan karakter ini, Anda tidak dapat mencatat pesan peristiwa yang berisi alamat IPv6.

Lihat juga

Berlaku untuk

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

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan. category dapat digunakan oleh Pemantau Peristiwa untuk memfilter peristiwa di log.

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)

Parameter

source: String

Sumber tempat aplikasi didaftarkan pada komputer yang ditentukan.

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

category: Int16

Subkataan khusus aplikasi yang terkait dengan pesan.

Pengecualian

ArgumentException

Nilainya source adalah string kosong ("").

-atau-

Nilai source adalah null.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

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)

Keterangan

Gunakan metode ini untuk menulis entri dengan aplikasi yang ditentukan category ke log peristiwa, menggunakan sumber yang sudah terdaftar sebagai sumber peristiwa untuk log yang sesuai. Pemantau Peristiwa menggunakan kategori untuk memfilter peristiwa yang ditulis oleh sumber peristiwa. Pemantau Peristiwa dapat menampilkan kategori sebagai nilai numerik, atau dapat menggunakan kategori sebagai pengidentifikasi sumber daya untuk menampilkan string kategori yang dilokalkan.

Catatan

Parameter category harus berupa nilai positif. Nilai kategori negatif muncul sebagai angka positif pelengkap dalam Pemantau Peristiwa. Misalnya, -10 muncul sebagai 65.526, -1 sebagai 65.535.

Selain kategori , Anda dapat menentukan pengidentifikasi peristiwa untuk peristiwa yang ditulis ke log peristiwa. Pengidentifikasi peristiwa, bersama dengan sumber peristiwa, secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang dipetakan. Penampil peristiwa menampilkan nilai string ini untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Anda harus membuat dan mengonfigurasi sumber peristiwa sebelum menulis entri pertama dengan sumbernya. Create sumber peristiwa baru selama penginstalan aplikasi Anda. Ini memungkinkan waktu bagi sistem operasi untuk merefresh daftar sumber peristiwa terdaftar dan konfigurasinya. Jika sistem operasi belum merefresh daftar sumber peristiwanya, dan Anda mencoba menulis peristiwa dengan sumber baru, operasi tulis akan gagal. Anda dapat mengonfigurasi sumber baru menggunakan EventLogInstaller, atau menggunakan CreateEventSource metode . Anda harus memiliki hak administratif pada komputer untuk membuat sumber kejadian baru.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

String message tidak boleh berisi %n, di mana n adalah nilai bilangan bulat (misalnya, %1), karena penampil peristiwa memperlakukannya sebagai string penyisipan. Karena alamat Protokol Internet versi 6 (IPv6) dapat berisi urutan karakter ini, Anda tidak dapat mencatat pesan peristiwa yang berisi alamat IPv6.

Lihat juga

Berlaku untuk

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

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa, dan menambahkan data biner ke pesan.

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())

Parameter

message: String

String yang akan ditulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

category: Int16

Subkataan khusus aplikasi yang terkait dengan pesan.

rawData: Byte[]

Array byte yang menyimpan data biner yang terkait dengan entri.

Pengecualian

ArgumentException

Properti Source dari EventLog belum disetel.

-atau-

Metode ini mencoba mendaftarkan sumber kejadian baru, tetapi nama komputer di MachineName tidak valid.

-atau-

Sumber sudah terdaftar untuk log peristiwa yang berbeda.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log peristiwa tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

// 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)

Keterangan

Gunakan kelebihan beban ini untuk menulis data khusus peristiwa yang ditentukan aplikasi ke log peristiwa. Pemantau Peristiwa tidak menginterpretasikan data ini; data mentah hanya menampilkan data mentah dalam format heksadesimal dan teks gabungan. Gunakan data khusus peristiwa dengan hemat, termasuk hanya jika Anda yakin akan berguna bagi seseorang yang men-debug masalah. Anda juga dapat menggunakan data khusus peristiwa untuk menyimpan informasi yang dapat diproses aplikasi secara independen dari Pemantau Peristiwa. Misalnya, Anda dapat menulis penampil khusus untuk peristiwa Anda, atau menulis program yang memindai logfile dan membuat laporan yang menyertakan informasi dari data khusus peristiwa.

Catatan

Parameter category harus berupa nilai positif. Nilai kategori negatif muncul sebagai angka positif pelengkap dalam Pemantau Peristiwa. Misalnya, -10 muncul sebagai 65.526, -1 sebagai 65.535.

Pengidentifikasi peristiwa, bersama dengan sumber peristiwa, secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang dipetakan. Penampil peristiwa menampilkan nilai string ini untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Anda harus mengatur Source properti pada komponen Anda EventLog sebelum dapat menulis entri ke log. Anda harus membuat dan mengonfigurasi sumber peristiwa sebelum menulis entri pertama dengan sumbernya.

Create sumber peristiwa baru selama penginstalan aplikasi Anda. Ini memungkinkan waktu bagi sistem operasi untuk merefresh daftar sumber peristiwa terdaftar dan konfigurasinya. Jika sistem operasi belum merefresh daftar sumber peristiwanya, dan Anda mencoba menulis peristiwa dengan sumber baru, operasi tulis akan gagal. Anda dapat mengonfigurasi sumber baru menggunakan EventLogInstaller, atau menggunakan CreateEventSource metode . Anda harus memiliki hak administratif pada komputer untuk membuat sumber kejadian baru.

Jika sumber yang ditentukan dalam Source properti instans ini EventLog tidak terdaftar di komputer tempat komponen Anda menulis, WriteEntry memanggil CreateEventSource dan mendaftarkan sumbernya.

Catatan

Jika Anda tidak menentukan MachineName untuk instans Anda EventLog sebelum memanggil CreateEventSource atau WriteEntry, komputer lokal (".") diasumsikan.

Jika sistem perlu mendaftarkan Source melalui panggilan ke WriteEntry dan Log properti belum diatur pada instans Anda EventLog , log default ke log Aplikasi.

Catatan

Banyak pengecualian yang tercantum di atas dihasilkan oleh kesalahan yang dimunculkan selama proses mendaftarkan Source.

Catatan

Jika Anda menulis entri ke komputer jarak jauh, nilai pesan (string teks) mungkin bukan yang Anda harapkan jika komputer jarak jauh tidak menjalankan .NET Framework.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, String, EventLogEntryType, Int32)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan dan pengidentifikasi peristiwa yang ditentukan aplikasi ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.

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)

Parameter

source: String

Sumber tempat aplikasi didaftarkan pada komputer yang ditentukan.

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

Pengecualian

ArgumentException

Nilainya source adalah string kosong ("").

-atau-

Nilai source adalah null.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

// 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)

Keterangan

Gunakan metode ini untuk menulis entri dengan aplikasi yang ditentukan eventID ke log peristiwa, menggunakan sumber yang sudah terdaftar sebagai sumber peristiwa untuk log yang sesuai. , eventIDbersama dengan sumbernya, secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang mereka petakan. Penampil peristiwa menyajikan string ini kepada pengguna untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Catatan

Selain pengidentifikasi peristiwa, kelebihan beban WriteEntry ini memungkinkan Anda menentukan untuk peristiwa yang EventLogEntryType ditulis ke log peristiwa. ditunjukkan type oleh ikon dan teks di kolom Jenis di Pemantau Peristiwa untuk log. Parameter ini menunjukkan apakah jenis peristiwa adalah kesalahan, peringatan, informasi, audit keberhasilan, atau audit kegagalan.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType, Int32, Int16)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan, pengidentifikasi peristiwa yang ditentukan aplikasi, dan kategori yang ditentukan aplikasi ke log peristiwa.

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)

Parameter

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

category: Int16

Subkataan khusus aplikasi yang terkait dengan pesan.

Pengecualian

ArgumentException

Properti Source dari EventLog belum ditetapkan.

-atau-

Metode mencoba mendaftarkan sumber kejadian baru, tetapi nama komputer di MachineName tidak valid.

-atau-

Sumber sudah terdaftar untuk log peristiwa yang berbeda.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

// 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)

Keterangan

Gunakan metode ini untuk menulis entri dengan aplikasi yang ditentukan category ke log peristiwa. Pemantau Peristiwa menggunakan kategori untuk memfilter peristiwa yang ditulis oleh sumber peristiwa. Pemantau Peristiwa dapat menampilkan kategori sebagai nilai numerik, atau dapat menggunakan kategori sebagai pengidentifikasi sumber daya untuk menampilkan string kategori yang dilokalkan.

Catatan

Parameter category harus menjadi nilai positif. Nilai kategori negatif muncul sebagai angka positif pelengkap dalam Pemantau Peristiwa. Misalnya, -10 muncul sebagai 65.526, -1 sebagai 65.535.

Catatan

Selain kategori , Anda dapat menentukan pengidentifikasi peristiwa untuk peristiwa yang ditulis ke log peristiwa. Pengidentifikasi peristiwa, bersama dengan sumber peristiwa, secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang mereka petakan. Penampil peristiwa menampilkan nilai string ini untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Anda harus mengatur Source properti pada komponen Anda EventLog sebelum dapat menulis entri ke log. Anda harus membuat dan mengonfigurasi sumber kejadian sebelum menulis entri pertama dengan sumbernya.

Create sumber kejadian baru selama penginstalan aplikasi Anda. Ini memungkinkan waktu bagi sistem operasi untuk me-refresh daftar sumber peristiwa terdaftar dan konfigurasinya. Jika sistem operasi belum merefresh daftar sumber peristiwanya, dan Anda mencoba menulis peristiwa dengan sumber baru, operasi tulis akan gagal. Anda dapat mengonfigurasi sumber baru menggunakan EventLogInstaller, atau menggunakan CreateEventSource metode . Anda harus memiliki hak administratif pada komputer untuk membuat sumber kejadian baru.

Jika sumber yang ditentukan dalam Source properti instans ini EventLog tidak terdaftar di komputer tempat komponen Anda menulis, memanggil CreateEventSource dan WriteEntry mendaftarkan sumbernya.

Catatan

Jika Anda tidak menentukan MachineName untuk instans Anda EventLog sebelum memanggil CreateEventSource atau WriteEntry, komputer lokal (".") diasumsikan.

Jika sistem perlu mendaftarkan Source melalui panggilan ke WriteEntry dan Log properti belum diatur pada instans Anda EventLog , log default ke log Aplikasi.

Catatan

Banyak pengecualian yang tercantum di atas dihasilkan oleh kesalahan yang dimunculkan selama proses mendaftarkan Source.

Catatan

Jika Anda menulis entri ke komputer jarak jauh, nilai pesan (string teks) mungkin bukan yang Anda harapkan jika komputer jarak jauh tidak menjalankan .NET Framework.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis kesalahan, peringatan, informasi, audit keberhasilan, atau entri audit kegagalan dengan teks pesan yang diberikan ke log peristiwa.

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)

Parameter

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

Pengecualian

ArgumentException

Properti Source dari EventLog belum ditetapkan.

-atau-

Metode mencoba mendaftarkan sumber kejadian baru, tetapi nama komputer di MachineName tidak valid.

-atau-

Sumber sudah terdaftar untuk log peristiwa yang berbeda.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

Contoh berikut menulis entri peringatan ke log peristiwa, "MyNewLog", di komputer lokal.

#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

Keterangan

Gunakan metode ini untuk menulis entri yang ditentukan EventLogEntryType ke log peristiwa. ditunjukkan type oleh ikon dan teks di kolom Jenis di Pemantau Peristiwa untuk log.

Catatan

Jika sumber yang ditentukan dalam Source properti instans ini EventLog tidak terdaftar di komputer tempat komponen Anda menulis, memanggil CreateEventSource dan WriteEntry mendaftarkan sumbernya.

Catatan

Jika Anda tidak menentukan MachineName untuk instans Anda EventLog sebelum memanggil CreateEventSource atau WriteEntry, komputer lokal (".") diasumsikan.

Jika sistem perlu mendaftarkan Source melalui panggilan ke WriteEntry dan Log properti belum diatur pada instans Anda EventLog , log default ke log Aplikasi.

Catatan

Banyak pengecualian yang tercantum di atas dihasilkan oleh kesalahan yang dimunculkan selama proses mendaftarkan Source.

Catatan

Jika Anda menulis entri ke komputer jarak jauh, nilai pesan (string teks) mungkin bukan yang Anda harapkan jika komputer jarak jauh tidak menjalankan .NET Framework.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType, Int32)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri dengan teks pesan yang diberikan dan pengidentifikasi peristiwa yang ditentukan aplikasi ke log peristiwa.

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)

Parameter

message: String

String untuk menulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

eventID: Int32

Pengidentifikasi khusus aplikasi untuk peristiwa tersebut.

Pengecualian

ArgumentException

Properti Source dari EventLog belum ditetapkan.

-atau-

Metode mencoba mendaftarkan sumber kejadian baru, tetapi nama komputer di MachineName tidak valid.

-atau-

Sumber sudah terdaftar untuk log peristiwa yang berbeda.

-atau-

eventID kurang dari nol atau lebih besar dari UInt16.MaxValue.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log kejadian tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

// 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)

Keterangan

Gunakan metode ini untuk menulis entri dengan aplikasi yang ditentukan eventID ke log peristiwa. Bersama eventID dengan sumber secara unik mengidentifikasi peristiwa. Setiap aplikasi dapat menentukan peristiwa bernomornya sendiri dan string deskripsi yang mereka petakan. Penampil peristiwa menampilkan nilai string ini untuk membantu pengguna memahami apa yang salah dan menyarankan tindakan apa yang harus diambil.

Catatan

Selain pengidentifikasi peristiwa, Anda dapat menentukan untuk peristiwa yang EventLogEntryType ditulis ke log peristiwa. ditunjukkan type oleh ikon dan teks di kolom Jenis di Pemantau Peristiwa untuk log. Parameter ini menunjukkan apakah jenis peristiwa adalah kesalahan, peringatan, informasi, audit keberhasilan, atau audit kegagalan.

Jika sumber yang ditentukan dalam Source properti instans ini EventLog tidak terdaftar di komputer tempat komponen Anda menulis, memanggil CreateEventSource dan WriteEntry mendaftarkan sumbernya.

Catatan

Jika Anda tidak menentukan MachineName untuk instans Anda EventLog sebelum memanggil CreateEventSource atau WriteEntry, komputer lokal (".") diasumsikan.

Jika sistem perlu mendaftarkan Source melalui panggilan ke WriteEntry dan Log properti belum diatur pada instans Anda EventLog , log default ke log Aplikasi.

Catatan

Banyak pengecualian yang tercantum di atas dihasilkan oleh kesalahan yang dimunculkan selama proses mendaftarkan Source.

Catatan

Jika Anda menulis entri ke komputer jarak jauh, nilai pesan (string teks) mungkin bukan yang Anda harapkan jika komputer jarak jauh tidak menjalankan .NET Framework.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, String)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri jenis informasi dengan teks pesan yang diberikan ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.

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)

Parameter

source: String

Sumber tempat aplikasi didaftarkan pada komputer yang ditentukan.

message: String

String yang akan ditulis ke log peristiwa.

Pengecualian

ArgumentException

Nilainya source adalah string kosong ("").

-atau-

Nilai source adalah null.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log peristiwa tidak dapat dibuka.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

Contoh berikut membuat sumber MySource jika belum ada, dan menulis entri ke log MyNewLogperistiwa .

#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

Keterangan

Gunakan metode ini untuk menulis entri informasi ke log peristiwa, menggunakan sumber yang sudah terdaftar sebagai sumber kejadian untuk log yang sesuai. Jika Anda ingin menentukan yang lain EventLogEntryType, gunakan kelebihan beban yang berbeda dari WriteEntry.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis entri jenis informasi, dengan teks pesan yang diberikan, ke log peristiwa.

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

public void WriteEntry (string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parameter

message: String

String yang akan ditulis ke log peristiwa.

Pengecualian

ArgumentException

Properti Source dari EventLog belum disetel.

-atau-

Metode ini mencoba mendaftarkan sumber kejadian baru, tetapi nama komputer di MachineName tidak valid.

-atau-

Sumber sudah terdaftar untuk log peristiwa yang berbeda.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log peristiwa tidak dapat dibuka.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

Contoh berikut membuat sumber MySource jika belum ada, dan menulis entri ke log MyNewLogperistiwa .

#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

Keterangan

Gunakan metode ini untuk menulis entri informasi ke log peristiwa yang terkait dengan instans ini EventLog . Jika Anda ingin menentukan yang lain EventLogEntryType, gunakan kelebihan beban yang berbeda dari WriteEntry.

Catatan

Jika sumber yang ditentukan dalam Source properti instans ini EventLog tidak terdaftar di komputer tempat komponen Anda menulis, WriteEntry memanggil CreateEventSource dan mendaftarkan sumbernya.

Catatan

Jika Anda tidak menentukan MachineName untuk instans Anda EventLog sebelum memanggil CreateEventSource atau WriteEntry, komputer lokal (".") diasumsikan.

Jika sistem perlu mendaftarkan Source melalui panggilan ke WriteEntry dan Log properti belum diatur pada instans Anda EventLog , log default ke log Aplikasi.

Catatan

Banyak pengecualian yang tercantum di atas dihasilkan oleh kesalahan yang dimunculkan selama proses mendaftarkan Source.

Catatan

Jika Anda menulis entri ke komputer jarak jauh, nilai pesan (string teks) mungkin bukan yang Anda harapkan jika komputer jarak jauh tidak menjalankan .NET Framework.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

WriteEntry(String, String, EventLogEntryType)

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Sumber:: EventLog.cs

Menulis kesalahan, peringatan, informasi, audit keberhasilan, atau entri audit kegagalan dengan teks pesan yang diberikan ke log peristiwa, menggunakan sumber peristiwa terdaftar yang ditentukan.

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)

Parameter

source: String

Sumber tempat aplikasi didaftarkan pada komputer yang ditentukan.

message: String

String yang akan ditulis ke log peristiwa.

type: EventLogEntryType

Salah EventLogEntryType satu nilai.

Pengecualian

ArgumentException

Nilainya source adalah string kosong ("").

-atau-

Nilai source adalah null.

-atau-

String pesan lebih panjang dari 31.839 byte (32.766 byte pada sistem operasi Windows sebelum Windows Vista).

-atau-

Nama sumber menghasilkan jalur kunci registri yang lebih panjang dari 254 karakter.

InvalidOperationException

Kunci registri untuk log peristiwa tidak dapat dibuka.

InvalidEnumArgumentException

type tidak valid EventLogEntryType.

Win32Exception

Sistem operasi melaporkan kesalahan saat menulis entri peristiwa ke log peristiwa. Kode galat Windows tidak tersedia.

Contoh

Contoh berikut menulis entri peringatan ke log peristiwa, "MyNewLog", di komputer lokal.

#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

Keterangan

Gunakan metode ini untuk menulis entri yang ditentukan EventLogEntryType ke log peristiwa, menggunakan sumber yang sudah terdaftar sebagai sumber kejadian untuk log yang sesuai. ditunjukkan type oleh ikon dan teks di kolom Jenis di Pemantau Peristiwa untuk log.

Catatan

message Jika parameter berisi karakter NUL, pesan dalam log peristiwa dihentikan pada karakter NUL.

Lihat juga

Berlaku untuk

Bagikan melalui

EventLog.WriteEntry Metode

Definisi

Overload

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, String, EventLogEntryType, Int32)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType, Int32, Int16)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, EventLogEntryType, Int32)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, String)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

WriteEntry(String, String, EventLogEntryType)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: