EventLog.Source Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de bronnaam op die moet worden geregistreerd en gebruikt bij het schrijven naar het gebeurtenislogboek.
public:
property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, setPublic Property Source As StringWaarde van eigenschap
De naam die is geregistreerd bij het gebeurtenislogboek als bron van vermeldingen. De standaardwaarde is een lege tekenreeks ("").
- Kenmerken
Uitzonderingen
De bronnaam resulteert in een registersleutelpad dat langer is dan 254 tekens.
Voorbeelden
In het volgende voorbeeld wordt de bron MySource gemaakt als deze nog niet bestaat en schrijft een vermelding naar het gebeurtenislogboek MyNewLog.
using System;
using System.Diagnostics;
using System.Threading;
class MySample{
public static void Main(){
// Create the source, if it does not already exist.
if(!EventLog.SourceExists("MySource"))
{
// An event log source should not be created and immediately used.
// There is a latency time to enable the source, it should be created
// prior to executing the application that uses the source.
// Execute this sample a second time to use the new source.
EventLog.CreateEventSource("MySource", "MyNewLog");
Console.WriteLine("CreatingEventSource");
Console.WriteLine("Exiting, execute the application a second time to use the source.");
// The source is created. Exit the application to allow it to be registered.
return;
}
// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "MySource";
// Write an informational entry to the event log.
myLog.WriteEntry("Writing to event log.");
Console.WriteLine("Message written to event log.");
}
}
Option Explicit
Option Strict
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
' 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.")
Console.WriteLine("Message written to event log.")
End Sub
End Class
Opmerkingen
De gebeurtenisbron geeft aan wat de gebeurtenis registreert. Dit is vaak de naam van de toepassing, of de naam van een subcomponent van de toepassing, als de toepassing groot is. Toepassingen en services moeten naar het toepassingslogboek of een aangepast logboek schrijven. Apparaatstuurprogramma's moeten naar het systeemlogboek schrijven.
U hoeft alleen een gebeurtenisbron op te geven als u naar een gebeurtenislogboek schrijft. Voordat u een vermelding in een gebeurtenislogboek schrijft, moet u de gebeurtenisbron registreren bij het gebeurtenislogboek als een geldige bron van gebeurtenissen. Wanneer u een logboekvermelding schrijft, gebruikt het systeem de Source eigenschap om het juiste logboek te vinden waarin u de vermelding wilt plaatsen. Als u het gebeurtenislogboek leest, kunt u het Source, of een Log en MachineName.
Note
U hoeft niet op te geven MachineName of u verbinding maakt met een logboek op de lokale computer. Als u de MachineNameoptie niet opgeeft, wordt ervan uitgegaan dat de lokale computer (".") wordt gebruikt.
Gebruik WriteEvent en WriteEntry schrijf gebeurtenissen naar een gebeurtenislogboek. U moet een gebeurtenisbron opgeven om gebeurtenissen te schrijven; u moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.
Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.
U kunt een gebeurtenisbron maken voor een bestaand gebeurtenislogboek of een nieuw gebeurtenislogboek. Wanneer u een nieuwe bron voor een nieuw gebeurtenislogboek maakt, registreert het systeem de bron voor dat logboek, maar wordt het logboek pas gemaakt nadat de eerste vermelding ernaar is geschreven.
De bron moet uniek zijn op de lokale computer; een nieuwe bronnaam kan niet overeenkomen met een bestaande bronnaam of een bestaande naam van het gebeurtenislogboek. Elke bron kan slechts naar één gebeurtenislogboek tegelijk schrijven; Uw toepassing kan echter meerdere bronnen gebruiken om naar meerdere gebeurtenislogboeken te schrijven. Uw toepassing kan bijvoorbeeld meerdere bronnen vereisen die zijn geconfigureerd voor verschillende gebeurtenislogboeken of verschillende resourcebestanden.
Als u de Source waarde wijzigt, wordt de EventLog waarde waarop deze is geregistreerd gesloten en worden alle gebeurtenisingangen vrijgegeven.
De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.
Als u de configuratiedetails van een bestaande bron wilt wijzigen, moet u de bron verwijderen en deze vervolgens maken met de nieuwe configuratie. Als andere toepassingen of onderdelen de bestaande bron gebruiken, maakt u een nieuwe bron met de bijgewerkte configuratie in plaats van de bestaande bron te verwijderen.
Note
Als een bron al is toegewezen aan een logboek en u deze opnieuw toe wijzen aan een nieuw logboek, moet u de computer opnieuw opstarten om de wijzigingen van kracht te laten worden.