EventSourceCreationData.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 naam op die moet worden geregistreerd bij het gebeurtenislogboek als gebeurtenisbron.
public:
property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };public string Source { get; set; }member this.Source : string with get, setPublic Property Source As StringWaarde van eigenschap
De naam die moet worden geregistreerd bij het gebeurtenislogboek als bron van vermeldingen. De standaardwaarde is een lege tekenreeks ("").
Voorbeelden
In het volgende codevoorbeeld worden de configuratie-eigenschappen voor een gebeurtenisbron ingesteld op basis van opdrachtregelargumenten. De invoerargumenten geven de naam van de gebeurtenisbron, de naam van het gebeurtenislogboek, de computernaam en het resourcebestand van het gebeurtenisbericht op. Dit voorbeeld maakt deel uit van een groter voorbeeld voor de EventSourceCreationData klasse.
EventSourceCreationData mySourceData = new EventSourceCreationData("", "");
bool registerSource = true;
// Process input parameters.
if (args.Length > 0)
{
// Require at least the source name.
mySourceData.Source = args[0];
if (args.Length > 1)
{
mySourceData.LogName = args[1];
}
if (args.Length > 2)
{
mySourceData.MachineName = args[2];
}
if ((args.Length > 3) && (args[3].Length > 0))
{
mySourceData.MessageResourceFile = args[3];
}
}
else
{
// Display a syntax help message.
Console.WriteLine("Input:");
Console.WriteLine(" source [event log] [machine name] [resource file]");
registerSource = false;
}
// Set defaults for parameters missing input.
if (mySourceData.MachineName.Length == 0)
{
// Default to the local computer.
mySourceData.MachineName = ".";
}
if (mySourceData.LogName.Length == 0)
{
// Default to the Application log.
mySourceData.LogName = "Application";
}
Dim mySourceData As EventSourceCreationData = new EventSourceCreationData("", "")
Dim registerSource As Boolean = True
' Process input parameters.
If args.Length > 0
' Require at least the source name.
mySourceData.Source = args(0)
If args.Length > 1
mySourceData.LogName = args(1)
End If
If args.Length > 2
mySourceData.MachineName = args(2)
End If
If args.Length > 3 AndAlso args(3).Length > 0
mySourceData.MessageResourceFile = args(3)
End If
Else
' Display a syntax help message.
Console.WriteLine("Input:")
Console.WriteLine(" source [event log] [machine name] [resource file]")
registerSource = False
End If
' Set defaults for parameters missing input.
If mySourceData.MachineName.Length = 0
' Default to the local computer.
mySourceData.MachineName = "."
End If
If mySourceData.LogName.Length = 0
' Default to the Application log.
mySourceData.LogName = "Application"
End If
Opmerkingen
De bronnaam is vaak de naam van de toepassing of de naam van een onderdeel in een grote toepassing. De EventLog.CreateEventSource(EventSourceCreationData) methode gebruikt de Source, LogNameen MachineName eigenschappen voor het maken van registerwaarden op de doelcomputer voor de nieuwe bron en het bijbehorende gebeurtenislogboek. Een nieuwe bronnaam kan niet overeenkomen met een bestaande bronnaam of een bestaande naam van het gebeurtenislogboek op de doelcomputer.
Nadat de registerwaarden voor de bron zijn gemaakt, kan uw toepassing de bron gebruiken om vermeldingen naar het geconfigureerde gebeurtenislogboek te schrijven.
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.