EventSourceCreationData.LogName Egenskap

Definition

Hämtar eller anger namnet på händelseloggen som källan skriver poster till.

public:
 property System::String ^ LogName { System::String ^ get(); void set(System::String ^ value); };
public string LogName { get; set; }
member this.LogName : string with get, set
Public Property LogName As String

Egenskapsvärde

Namnet på händelseloggen. Det kan vara program, system eller ett anpassat loggnamn. Standardvärdet är "Program".

Exempel

I följande kodexempel anges konfigurationsegenskaperna för en händelsekälla från kommandoradsargument. Indataargumenten anger händelsekällans namn, händelseloggnamn, datornamn och resursfil för händelsemeddelande. Det här exemplet är en del av ett större exempel som tillhandahålls EventSourceCreationData för klassen.

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

Kommentarer

Använd egenskapen LogName för att identifiera händelseloggen som programmet skriver poster till med hjälp av den nya källan. Händelseloggen kan vara en ny logg eller en befintlig logg. Program och tjänster bör skriva till programloggen eller en anpassad logg. Enhetsdrivrutiner bör skriva till systemloggen. Om du inte uttryckligen LogName anger egenskapen, är händelseloggen som standard programloggen.

Anteckning

Säkerhetsloggen är skrivskyddad.

Om du vill rikta in en befintlig logg för den nya källan anger du LogName egenskapen till det befintliga händelseloggnamnet. Om du vill skapa en ny händelselogg för källan måste du ange egenskapen LogName . Namn på händelseloggar måste bestå av utskrivbara tecken och får inte innehålla tecknen '*', '?' eller '\'. De första 8 tecknen i händelseloggnamnet måste skilja sig från de första 8 tecknen i befintliga namn på händelseloggar på den angivna datorn.

Operativsystemet lagrar händelseloggar som filer. När du använder EventLogInstaller eller CreateEventSource metoden för att skapa en ny händelselogg lagras den associerade filen i katalogen %SystemRoot%\System32\Config på den angivna datorn. Filnamnet anges genom att de första 8 tecknen i LogName egenskapen läggs till med filnamnstillägget ".evt".

Gäller för

Se även