EventSourceCreationData.Source Tulajdonság

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.EventLog.dll

Csomag:

System.Diagnostics.EventLog v11.0.0-preview.5.26302.115

Forrás:

EventSourceCreationData.cs

Lekéri vagy beállítja a nevet, hogy eseményforrásként regisztráljon az eseménynaplóban.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };

public string? Source { get; set; }

member this.Source : string with get, set

Public Property Source As String

Tulajdonság értéke

String

Az eseménynaplóban bejegyzésforrásként regisztrálandó név. Az alapértelmezett érték egy üres sztring ("").

Példák

Az alábbi példakód parancssori argumentumokból állítja be az eseményforrás konfigurációs tulajdonságait. A bemeneti argumentumok megadják az eseményforrás nevét, az eseménynapló nevét, a számítógép nevét és az eseményüzenet erőforrásfájlját. Ez a példa egy nagyobb, az EventSourceCreationData osztályhoz tartozó példa része.

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

Megjegyzések

A forrásnév gyakran az alkalmazás neve, vagy egy nagy alkalmazáson belüli összetevő neve. A EventLog.CreateEventSource(EventSourceCreationData) metódus a Source, LogNameés MachineName tulajdonságok használatával hoz létre beállításjegyzék-értékeket a célszámítógépen az új forráshoz és a hozzá tartozó eseménynaplóhoz. Az új forrásnév nem egyezhet meg a célszámítógépen meglévő forrásnévvel vagy meglévő eseménynapló-névvel.

A forrás beállításjegyzék-értékeinek létrehozása után az alkalmazás a forrás használatával bejegyzéseket írhat a konfigurált eseménynaplóba.

Minden forrás egyszerre csak egy eseménynaplóba tud írni; az alkalmazás azonban több forrásból is írhat több eseménynaplóba. Előfordulhat például, hogy az alkalmazás több, különböző eseménynaplókhoz vagy különböző erőforrásfájlokhoz konfigurált forrást igényel.

Lásd még

• Source
• SourceExists(String)