EventLog.WriteEntry Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zapíše položku do protokolu událostí.
Přetížení
| Name | Description |
|---|---|
| WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) |
Zapíše položku s daným textem zprávy, identifikátorem události definovaným aplikací a kategorií definovanou aplikací do protokolu událostí (pomocí zadaného registrovaného zdroje událostí) a připojí do zprávy binární data. |
| WriteEntry(String, String, EventLogEntryType, Int32, Int16) |
Zapíše položku s daným textem zprávy, identifikátorem události definovanou aplikací a kategorií definovanou aplikací do protokolu událostí pomocí zadaného registrovaného zdroje událostí. Prohlížeč |
| WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) |
Zapíše položku s daným textem zprávy, identifikátorem události definovaným aplikací a kategorií definovanou aplikací do protokolu událostí a připojí do zprávy binární data. |
| WriteEntry(String, String, EventLogEntryType, Int32) |
Zapíše položku s daným textem zprávy a identifikátorem události definovanou aplikací do protokolu událostí pomocí zadaného registrovaného zdroje událostí. |
| WriteEntry(String, EventLogEntryType, Int32, Int16) |
Zapíše položku s daným textem zprávy, identifikátorem události definovanou aplikací a kategorií definovanou aplikací do protokolu událostí. |
| WriteEntry(String, EventLogEntryType) |
Zapíše do protokolu událostí chybu, upozornění, informace, audit úspěšného auditu nebo položku auditu selhání s daným textem zprávy. |
| WriteEntry(String, EventLogEntryType, Int32) |
Zapíše položku s daným textem zprávy a identifikátorem události definovanou aplikací do protokolu událostí. |
| WriteEntry(String, String) |
Zapíše položku typu informací s daným textem zprávy do protokolu událostí pomocí zadaného registrovaného zdroje událostí. |
| WriteEntry(String) |
Zapíše položku typu informací s daným textem zprávy do protokolu událostí. |
| WriteEntry(String, String, EventLogEntryType) |
Zapíše do protokolu událostí chybu, upozornění, informace, audit úspěšného auditu nebo položku auditu selhání s daným textem zprávy pomocí zadaného registrovaného zdroje událostí. |
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy, identifikátorem události definovaným aplikací a kategorií definovanou aplikací do protokolu událostí (pomocí zadaného registrovaného zdroje událostí) a připojí do zprávy binární data.
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())
Parametry
- source
- String
Zdroj, podle kterého je aplikace zaregistrována v zadaném počítači.
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
- category
- Int16
Podkategorie specifická pro aplikaci přidružená ke zprávě.
- rawData
- Byte[]
Pole bajtů, které obsahuje binární data přidružená k položce.
Výjimky
Hodnota source je prázdný řetězec ("").
nebo
Hodnota source je null.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
type není platný EventLogEntryType.
Klíč registru pro protokol událostí nelze otevřít.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
//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)
Poznámky
Tuto metodu použijte k zápisu dat specifických pro událost definovaná aplikací do protokolu událostí pomocí zdroje, který je již zaregistrovaný jako zdroj události pro příslušný protokol. Prohlížeč událostí tato data neinterpretuje; zobrazuje nezpracovaná data pouze v kombinovaném šestnáctkovém a textovém formátu. Používejte data specifická pro události střídmě; zahrnout pouze v případě, že jste si jisti, že bude užitečné. Data specifická pro události můžete také použít k ukládání informací, které může aplikace zpracovávat nezávisle na prohlížeči událostí. Můžete například napsat prohlížeč speciálně pro vaše události nebo napsat program, který prohledá soubor protokolu a vytvoří sestavy, které obsahují informace z dat specifických pro události.
Kromě binárních dat můžete zadat kategorii definovanou aplikací a identifikátor události definovaný aplikací. Prohlížeč událostí používá kategorii k filtrování událostí napsaných zdrojem událostí. Prohlížeč událostí může kategorii zobrazit jako číselnou hodnotu nebo může kategorii použít jako identifikátor prostředku k zobrazení lokalizovaného řetězce kategorie.
Poznámka:
Parametr category by měl být kladná hodnota. Záporné hodnoty kategorií se v Prohlížeči událostí zobrazují jako doplňkové kladné číslo. Například -10 se zobrazí jako 65 526, -1 jako 65 535.
Chcete-li zobrazit lokalizované řetězce kategorií v Prohlížeči událostí, musíte použít zdroj událostí nakonfigurovaný se souborem prostředků kategorie a nastavit category identifikátor prostředku v souboru prostředků kategorie. Pokud zdroj událostí nemá nakonfigurovaný soubor prostředku kategorie nebo zadaný category soubor neindexuje řetězec v souboru prostředků kategorie, prohlížeč událostí zobrazí číselnou hodnotu kategorie pro danou položku. Nakonfigurujte soubor prostředku kategorie spolu s počtem řetězců kategorií v souboru prostředků pomocí EventLogInstaller třídy nebo EventSourceCreationData třídy.
Identifikátory událostí společně se zdrojem událostí jednoznačně identifikují událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Prohlížeče událostí zobrazují tyto řetězcové hodnoty, aby uživateli pomohly pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Nakonec můžete zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí. Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Viz také
Platí pro
WriteEntry(String, String, EventLogEntryType, Int32, Int16)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy, identifikátorem události definovanou aplikací a kategorií definovanou aplikací do protokolu událostí pomocí zadaného registrovaného zdroje událostí. Prohlížeč category událostí ho může použít k filtrování událostí v protokolu.
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)
Parametry
- source
- String
Zdroj, podle kterého je aplikace zaregistrována v zadaném počítači.
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
- category
- Int16
Podkategorie specifická pro aplikaci přidružená ke zprávě.
Výjimky
Hodnota source je prázdný řetězec ("").
nebo
Hodnota source je null.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
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)
Poznámky
Tato metoda slouží k zápisu položky s aplikací definovanou category do protokolu událostí pomocí zdroje, který je již registrován jako zdroj události pro příslušný protokol. Prohlížeč událostí používá kategorii k filtrování událostí napsaných zdrojem událostí. Prohlížeč událostí může kategorii zobrazit jako číselnou hodnotu nebo může kategorii použít jako identifikátor prostředku k zobrazení lokalizovaného řetězce kategorie.
Poznámka:
Parametr category by měl být kladná hodnota. Záporné hodnoty kategorií se v Prohlížeči událostí zobrazují jako doplňkové kladné číslo. Například -10 se zobrazí jako 65 526, -1 jako 65 535.
Chcete-li zobrazit lokalizované řetězce kategorií v Prohlížeči událostí, musíte použít zdroj událostí nakonfigurovaný se souborem prostředků kategorie a nastavit category identifikátor prostředku v souboru prostředků kategorie. Pokud zdroj událostí nemá nakonfigurovaný soubor prostředku kategorie nebo zadaný category soubor neindexuje řetězec v souboru prostředků kategorie, prohlížeč událostí zobrazí číselnou hodnotu kategorie pro danou položku. Nakonfigurujte soubor prostředku kategorie spolu s počtem řetězců kategorií v souboru prostředků pomocí EventLogInstaller třídy nebo EventSourceCreationData třídy.
Kromě kategorie můžete zadat identifikátor události, který se zapisuje do protokolu událostí. Identifikátory událostí společně se zdrojem událostí jednoznačně identifikují událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Prohlížeče událostí zobrazují tyto řetězcové hodnoty, aby uživateli pomohly pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Nakonec můžete zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí. Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Viz také
Platí pro
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy, identifikátorem události definovaným aplikací a kategorií definovanou aplikací do protokolu událostí a připojí do zprávy binární data.
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())
Parametry
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
- category
- Int16
Podkategorie specifická pro aplikaci přidružená ke zprávě.
- rawData
- Byte[]
Pole bajtů, které obsahuje binární data přidružená k položce.
Výjimky
Vlastnost SourceEventLog nebyla nastavena.
nebo
Metoda se pokusila zaregistrovat nový zdroj událostí, ale název MachineName počítače není platný.
nebo
Zdroj je již zaregistrovaný pro jiný protokol událostí.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
// 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)
Poznámky
Toto přetížení použijte k zápisu dat specifických pro událost definovaná aplikací do protokolu událostí. Prohlížeč událostí tato data neinterpretuje; zobrazuje nezpracovaná data pouze v kombinovaném šestnáctkovém a textovém formátu. Data specifická pro události používejte střídmě, a to jenom v případě, že jste si jistí, že bude užitečné, když někdo problém ladí. Data specifická pro události můžete také použít k ukládání informací, které může aplikace zpracovávat nezávisle na prohlížeči událostí. Můžete například napsat prohlížeč speciálně pro vaše události nebo napsat program, který prohledá soubor protokolu a vytvoří sestavy, které obsahují informace z dat specifických pro události.
Kromě binárních dat můžete zadat kategorii definovanou aplikací a identifikátor události definovaný aplikací. Prohlížeč událostí používá kategorii k filtrování událostí napsaných zdrojem událostí. Prohlížeč událostí může kategorii zobrazit jako číselnou hodnotu nebo může kategorii použít jako identifikátor prostředku k zobrazení lokalizovaného řetězce kategorie.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Poznámka:
Parametr category by měl být kladná hodnota. Záporné hodnoty kategorií se v Prohlížeči událostí zobrazují jako doplňkové kladné číslo. Například -10 se zobrazí jako 65 526, -1 jako 65 535.
Chcete-li zobrazit lokalizované řetězce kategorií v Prohlížeči událostí, musíte použít zdroj událostí nakonfigurovaný se souborem prostředků kategorie a nastavit category identifikátor prostředku v souboru prostředků kategorie. Pokud zdroj událostí nemá nakonfigurovaný soubor prostředku kategorie nebo zadaný category soubor neindexuje řetězec v souboru prostředků kategorie, prohlížeč událostí zobrazí číselnou hodnotu kategorie pro danou položku. Nakonfigurujte soubor prostředku kategorie spolu s počtem řetězců kategorií v souboru prostředků pomocí EventLogInstaller třídy nebo EventSourceCreationData třídy.
Identifikátory událostí společně se zdrojem událostí jednoznačně identifikují událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Prohlížeče událostí zobrazují tyto řetězcové hodnoty, aby uživateli pomohly pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Nakonec můžete zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem Source položek do protokolu je nutné nastavit vlastnost ve své EventLog komponentě. Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.
Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Pokud zdroj zadaný ve Source vlastnosti této EventLog instance není registrován v počítači, do kterého vaše komponenta zapisuje, WriteEntry volá CreateEventSource a registruje zdroj.
Poznámka:
Pokud před voláním CreateEventSource nezadáte MachineName pro instanci EventLog nebo WriteEntryse předpokládá místní počítač (".").
Pokud systém potřebuje zaregistrovat Source volání prostřednictvím volání WriteEntry a Log vlastnost nebyla nastavena ve vaší EventLog instanci, protokol se ve výchozím nastavení nastaví do protokolu aplikace.
Poznámka:
Mnoho výjimek uvedených výše jsou generovány chybami vyvolaných během procesu registrace Source.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
Pokud zapíšete položku do vzdáleného počítače, hodnota zprávy (textový řetězec) nemusí být to, co očekáváte, pokud vzdálený počítač nespouštět rozhraní .NET Framework.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, String, EventLogEntryType, Int32)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy a identifikátorem události definovanou aplikací do protokolu událostí pomocí zadaného registrovaného zdroje událostí.
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)
Parametry
- source
- String
Zdroj, podle kterého je aplikace zaregistrována v zadaném počítači.
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
Výjimky
Hodnota source je prázdný řetězec ("").
nebo
Hodnota source je null.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
// 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)
Poznámky
Tato metoda slouží k zápisu položky s aplikací definovanou eventID do protokolu událostí pomocí zdroje, který je již registrován jako zdroj události pro příslušný protokol. Spolu eventIDse zdrojem jednoznačně identifikujte událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Čtenáři událostí prezentují tyto řetězce uživateli, aby uživateli pomohli pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Kromě identifikátoru události toto přetížení WriteEntry umožňuje zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí. Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, EventLogEntryType, Int32, Int16)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy, identifikátorem události definovanou aplikací a kategorií definovanou aplikací do protokolu událostí.
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)
Parametry
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
- category
- Int16
Podkategorie specifická pro aplikaci přidružená ke zprávě.
Výjimky
Vlastnost SourceEventLog nebyla nastavena.
nebo
Metoda se pokusila zaregistrovat nový zdroj událostí, ale název MachineName počítače není platný.
nebo
Zdroj je již zaregistrovaný pro jiný protokol událostí.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
// 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)
Poznámky
Tato metoda slouží k zápisu položky s aplikací definovanou category do protokolu událostí. Prohlížeč událostí používá kategorii k filtrování událostí napsaných zdrojem událostí. Prohlížeč událostí může kategorii zobrazit jako číselnou hodnotu nebo může kategorii použít jako identifikátor prostředku k zobrazení lokalizovaného řetězce kategorie.
Poznámka:
Parametr category by měl být kladná hodnota. Záporné hodnoty kategorií se v Prohlížeči událostí zobrazují jako doplňkové kladné číslo. Například -10 se zobrazí jako 65 526, -1 jako 65 535.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Chcete-li zobrazit lokalizované řetězce kategorií v Prohlížeči událostí, musíte použít zdroj událostí nakonfigurovaný se souborem prostředků kategorie a nastavit category identifikátor prostředku v souboru prostředků kategorie. Pokud zdroj událostí nemá nakonfigurovaný soubor prostředku kategorie nebo zadaný category soubor neindexuje řetězec v souboru prostředků kategorie, prohlížeč událostí zobrazí číselnou hodnotu kategorie pro danou položku. Nakonfigurujte soubor prostředku kategorie spolu s počtem řetězců kategorií v souboru prostředků pomocí EventLogInstaller třídy nebo EventSourceCreationData třídy.
Kromě kategorie můžete zadat identifikátor události, který se zapisuje do protokolu událostí. Identifikátory událostí společně se zdrojem událostí jednoznačně identifikují událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Prohlížeče událostí zobrazují tyto řetězcové hodnoty, aby uživateli pomohly pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Nakonec můžete zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem Source položek do protokolu je nutné nastavit vlastnost ve své EventLog komponentě. Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.
Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Pokud zdroj zadaný ve Source vlastnosti této EventLog instance není registrován v počítači, do kterého vaše komponenta zapisuje, WriteEntry volá CreateEventSource a registruje zdroj.
Poznámka:
Pokud před voláním CreateEventSource nezadáte MachineName pro instanci EventLog nebo WriteEntryse předpokládá místní počítač (".").
Pokud systém potřebuje zaregistrovat Source volání prostřednictvím volání WriteEntry a Log vlastnost nebyla nastavena ve vaší EventLog instanci, protokol se ve výchozím nastavení nastaví do protokolu aplikace.
Poznámka:
Mnoho výjimek uvedených výše jsou generovány chybami vyvolaných během procesu registrace Source.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
Pokud zapíšete položku do vzdáleného počítače, hodnota zprávy (textový řetězec) nemusí být to, co očekáváte, pokud vzdálený počítač nespouštět rozhraní .NET Framework.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, EventLogEntryType)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše do protokolu událostí chybu, upozornění, informace, audit úspěšného auditu nebo položku auditu selhání s daným textem zprávy.
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)
Parametry
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
Výjimky
Vlastnost SourceEventLog nebyla nastavena.
nebo
Metoda se pokusila zaregistrovat nový zdroj událostí, ale název MachineName počítače není platný.
nebo
Zdroj je již zaregistrovaný pro jiný protokol událostí.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
type není platný EventLogEntryType.
Klíč registru pro protokol událostí nelze otevřít.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
Následující příklad zapíše položku upozornění do protokolu událostí "MyNewLog" v místním počítači.
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
Poznámky
Tato metoda slouží k zápisu položky zadané EventLogEntryType do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Před zápisem Source položek do protokolu je nutné nastavit vlastnost ve své EventLog komponentě. Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.
Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Pokud zdroj zadaný ve Source vlastnosti této EventLog instance není registrován v počítači, do kterého vaše komponenta zapisuje, WriteEntry volá CreateEventSource a registruje zdroj.
Poznámka:
Pokud před voláním CreateEventSource nezadáte MachineName pro instanci EventLog nebo WriteEntryse předpokládá místní počítač (".").
Pokud systém potřebuje zaregistrovat Source volání prostřednictvím volání WriteEntry a Log vlastnost nebyla nastavena ve vaší EventLog instanci, protokol se ve výchozím nastavení nastaví do protokolu aplikace.
Poznámka:
Mnoho výjimek uvedených výše jsou generovány chybami vyvolaných během procesu registrace Source.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
Pokud zapíšete položku do vzdáleného počítače, hodnota zprávy (textový řetězec) nemusí být to, co očekáváte, pokud vzdálený počítač nespouštět rozhraní .NET Framework.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, EventLogEntryType, Int32)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku s daným textem zprávy a identifikátorem události definovanou aplikací do protokolu událostí.
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)
Parametry
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
- eventID
- Int32
Identifikátor konkrétní aplikace pro událost.
Výjimky
Vlastnost SourceEventLog nebyla nastavena.
nebo
Metoda se pokusila zaregistrovat nový zdroj událostí, ale název MachineName počítače není platný.
nebo
Zdroj je již zaregistrovaný pro jiný protokol událostí.
nebo
eventID je menší než nula nebo větší než UInt16.MaxValue.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
// 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)
Poznámky
Tato metoda slouží k zápisu položky s aplikací definovanou eventID do protokolu událostí. Společně eventID se zdrojem jednoznačně identifikujte událost. Každá aplikace může definovat vlastní číslovaný události a popisovací řetězce, na které se mapují. Prohlížeče událostí zobrazují tyto řetězcové hodnoty, aby uživateli pomohly pochopit, co se nepovedlo, a navrhnout, jaké akce se mají provést.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Kromě identifikátoru události můžete zadat EventLogEntryType událost, která se zapisuje do protokolu událostí. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol. Tento parametr označuje, jestli je typ události chyba, upozornění, informace, audit úspěchu nebo audit selhání.
Před zápisem Source položek do protokolu je nutné nastavit vlastnost ve své EventLog komponentě. Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.
Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Pokud zdroj zadaný ve Source vlastnosti této EventLog instance není registrován v počítači, do kterého vaše komponenta zapisuje, WriteEntry volá CreateEventSource a registruje zdroj.
Poznámka:
Pokud před voláním CreateEventSource nezadáte MachineName pro instanci EventLog nebo WriteEntryse předpokládá místní počítač (".").
Pokud systém potřebuje zaregistrovat Source volání prostřednictvím volání WriteEntry a Log vlastnost nebyla nastavena ve vaší EventLog instanci, protokol se ve výchozím nastavení nastaví do protokolu aplikace.
Poznámka:
Mnoho výjimek uvedených výše jsou generovány chybami vyvolaných během procesu registrace Source.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
Pokud zapíšete položku do vzdáleného počítače, hodnota zprávy (textový řetězec) nemusí být to, co očekáváte, pokud vzdálený počítač nespouštět rozhraní .NET Framework.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, String)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku typu informací s daným textem zprávy do protokolu událostí pomocí zadaného registrovaného zdroje událostí.
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)
Parametry
- source
- String
Zdroj, podle kterého je aplikace zaregistrována v zadaném počítači.
- message
- String
Řetězec pro zápis do protokolu událostí.
Výjimky
Hodnota source je prázdný řetězec ("").
nebo
Hodnota source je null.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
Následující příklad vytvoří zdroj MySource , pokud ještě neexistuje, a zapíše položku do protokolu MyNewLogudálostí .
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
Poznámky
Tato metoda slouží k zápisu informací do protokolu událostí pomocí zdroje, který je již registrován jako zdroj události pro příslušný protokol. Chcete-li zadat jiné EventLogEntryType, použijte jiné přetížení WriteEntry.
Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí. Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Viz také
Platí pro
WriteEntry(String)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše položku typu informací s daným textem zprávy do protokolu událostí.
public:
void WriteEntry(System::String ^ message);
public void WriteEntry(string message);
member this.WriteEntry : string -> unit
Public Sub WriteEntry (message As String)
Parametry
- message
- String
Řetězec pro zápis do protokolu událostí.
Výjimky
Vlastnost SourceEventLog nebyla nastavena.
nebo
Metoda se pokusila zaregistrovat nový zdroj událostí, ale název MachineName počítače není platný.
nebo
Zdroj je již zaregistrovaný pro jiný protokol událostí.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
Následující příklad vytvoří zdroj MySource , pokud ještě neexistuje, a zapíše položku do protokolu MyNewLogudálostí .
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
Poznámky
Tuto metodu použijte k zápisu položky informací do protokolu událostí přidruženého k této EventLog instanci. Chcete-li zadat jiné EventLogEntryType, použijte jiné přetížení WriteEntry.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Před zápisem Source položek do protokolu je nutné nastavit vlastnost ve své EventLog komponentě. Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.
Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Pokud zdroj zadaný ve Source vlastnosti této EventLog instance není registrován v počítači, do kterého vaše komponenta zapisuje, WriteEntry volá CreateEventSource a registruje zdroj.
Poznámka:
Pokud před voláním CreateEventSource nezadáte MachineName pro instanci EventLog nebo WriteEntryse předpokládá místní počítač (".").
Pokud systém potřebuje zaregistrovat Source volání prostřednictvím volání WriteEntry a Log vlastnost nebyla nastavena ve vaší EventLog instanci, protokol se ve výchozím nastavení nastaví do protokolu aplikace.
Poznámka:
Mnohé z výše uvedených výjimek jsou generovány chybami vyvolaných během procesu registrace Source.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
Pokud zapíšete položku do vzdáleného počítače, hodnota zprávy (textový řetězec) nemusí být to, co očekáváte, pokud vzdálený počítač nespouštět rozhraní .NET Framework.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.
Viz také
Platí pro
WriteEntry(String, String, EventLogEntryType)
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
- Zdroj:
- EventLog.cs
Zapíše do protokolu událostí chybu, upozornění, informace, audit úspěšného auditu nebo položku auditu selhání s daným textem zprávy pomocí zadaného registrovaného zdroje událostí.
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)
Parametry
- source
- String
Zdroj, podle kterého je aplikace zaregistrována v zadaném počítači.
- message
- String
Řetězec pro zápis do protokolu událostí.
- type
- EventLogEntryType
Jedna z EventLogEntryType hodnot.
Výjimky
Hodnota source je prázdný řetězec ("").
nebo
Hodnota source je null.
nebo
Řetězec zprávy je delší než 31 839 bajtů (32 766 bajtů v operačních systémech Windows před Windows Vista).
nebo
Výsledkem názvu zdroje je cesta klíče registru delší než 254 znaků.
Klíč registru pro protokol událostí nelze otevřít.
type není platný EventLogEntryType.
Operační systém oznámil chybu při zápisu položky události do protokolu událostí. Kód chyby Systému Windows není k dispozici.
Příklady
Následující příklad zapíše položku upozornění do protokolu událostí "MyNewLog" v místním počítači.
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
Poznámky
Tuto metodu použijte k zápisu položky zadané EventLogEntryType do protokolu událostí pomocí zdroje, který je již registrován jako zdroj události pro příslušný protokol. Označuje type se ikonou a textem ve sloupci Typ v Prohlížeči událostí pro protokol.
Poznámka:
Řetězec message nemůže obsahovat %n, kde n je celočíselná hodnota (například %1), protože prohlížeč událostí ji považuje za řetězec vložení. Vzhledem k tomu, že ip adresa 6 (IPv6) může obsahovat tuto posloupnost znaků, nelze protokolovat zprávu události, která obsahuje adresu IPv6.
Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí. Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.
Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Metoda WriteEntry zapíše daný řetězec přímo do protokolu událostí; nepoužívá lokalizovatelný soubor prostředků zprávy. Metoda slouží k zápisu WriteEvent událostí pomocí lokalizovaného souboru prostředků zprávy.
Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Pak vytvořte jiný zdroj bez souborů prostředků a použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.
Poznámka:
message Pokud parametr obsahuje znak NUL, zpráva v protokolu událostí se ukončí na znaku NUL.