EventLogInstaller.CategoryCount 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定分類資源檔中的分類數目。
public:
property int CategoryCount { int get(); void set(int value); };[System.Runtime.InteropServices.ComVisible(false)]
public int CategoryCount { get; set; }[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CategoryCount : int with get, setPublic Property CategoryCount As Integer屬性值
分類資源檔中的分類數目。 預設值為零。
- 屬性
範例
下列程式代碼範例會設定新事件來源的安裝屬性。 程式代碼範例會設定本地化事件文字的事件來源名稱、事件記錄檔名稱和資源檔。
#using <System.dll>
#using <System.Configuration.Install.dll>
using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;
[RunInstaller(true)]
public ref class SampleEventLogInstaller : public Installer
{
private:
EventLogInstaller^ myEventLogInstaller;
public:
SampleEventLogInstaller()
{
// Create an instance of an EventLogInstaller.
myEventLogInstaller = gcnew EventLogInstaller;
// Set the source name of the event log.
myEventLogInstaller->Source = "ApplicationEventSource";
// Set the event log into which the source writes entries.
//myEventLogInstaller.Log = "MyCustomLog";
myEventLogInstaller->Log = "myNewLog";
// Set the resource file for the event log.
// The message strings are defined in EventLogMsgs.mc; the message
// identifiers used in the application must match those defined in the
// corresponding message resource file. The messages must be built
// into a Win32 resource library and copied to the target path on the
// system.
myEventLogInstaller->CategoryResourceFile =
Environment::SystemDirectory + "\\eventlogmsgs.dll";
myEventLogInstaller->CategoryCount = 3;
myEventLogInstaller->MessageResourceFile =
Environment::SystemDirectory + "\\eventlogmsgs.dll";
myEventLogInstaller->ParameterResourceFile =
Environment::SystemDirectory + "\\eventlogmsgs.dll";
// Add myEventLogInstaller to the installer collection.
Installers->Add( myEventLogInstaller );
}
};
int main()
{
Console::WriteLine( "Usage: InstallUtil.exe [<install>.exe | <install>.dll]" );
}
using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;
[RunInstaller(true)]
public class SampleEventLogInstaller : Installer
{
private EventLogInstaller myEventLogInstaller;
public SampleEventLogInstaller()
{
// Create an instance of an EventLogInstaller.
myEventLogInstaller = new EventLogInstaller();
// Set the source name of the event log.
myEventLogInstaller.Source = "ApplicationEventSource";
// Set the event log into which the source writes entries.
//myEventLogInstaller.Log = "MyCustomLog";
myEventLogInstaller.Log = "myNewLog";
// Set the resource file for the event log.
// The message strings are defined in EventLogMsgs.mc; the message
// identifiers used in the application must match those defined in the
// corresponding message resource file. The messages must be built
// into a Win32 resource library and copied to the target path on the
// system.
myEventLogInstaller.CategoryResourceFile =
Environment.SystemDirectory + "\\eventlogmsgs.dll";
myEventLogInstaller.CategoryCount = 3;
myEventLogInstaller.MessageResourceFile =
Environment.SystemDirectory + "\\eventlogmsgs.dll";
myEventLogInstaller.ParameterResourceFile =
Environment.SystemDirectory + "\\eventlogmsgs.dll";
// Add myEventLogInstaller to the installer collection.
Installers.Add(myEventLogInstaller);
}
public static void Main()
{
Console.WriteLine("Usage: InstallUtil.exe [<install>.exe | <install>.dll]");
}
}
Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel
<RunInstaller(True)> _
Public Class SampleEventLogInstaller
Inherits Installer
Private myEventLogInstaller As EventLogInstaller
Public Sub New()
' Create an instance of an EventLogInstaller.
myEventLogInstaller = New EventLogInstaller()
' Set the source name of the event log.
myEventLogInstaller.Source = "ApplicationEventSource"
' Set the event log into which the source writes entries.
myEventLogInstaller.Log = "MyCustomLog"
' Set the resource file for the event log.
' The message strings are defined in EventLogMsgs.mc; the message
' identifiers used in the application must match those defined in the
' corresponding message resource file. The messages must be built
' into a Win32 resource library and copied to the target path on the
' system.
myEventLogInstaller.CategoryResourceFile = _
Environment.SystemDirectory + "\eventlogmsgs.dll"
myEventLogInstaller.CategoryCount = 3
myEventLogInstaller.MessageResourceFile = _
Environment.SystemDirectory + "\eventlogmsgs.dll"
myEventLogInstaller.ParameterResourceFile = _
Environment.SystemDirectory + "\eventlogmsgs.dll"
' Add myEventLogInstaller to the installer collection.
Installers.Add(myEventLogInstaller)
End Sub
Public Shared Sub Main()
Console.WriteLine("Usage: InstallUtil.exe [<install>.exe | <install>.dll]")
End Sub
End Class
程式代碼範例會使用下列訊息文本檔，內建於資源庫 EventLogMsgs.dll。 訊息文本檔是建立訊息資源檔的來源。 訊息文字檔會定義類別、事件訊息和參數插入字串的資源識別碼和文字。
; // EventLogMsgs.mc
; // ********************************************************
; // Use the following commands to build this file:
; // mc -s EventLogMsgs.mc
; // rc EventLogMsgs.rc
; // link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res
; // ********************************************************
; // - Event categories -
; // Categories must be numbered consecutively starting at 1.
; // ********************************************************
MessageId=0x1
Severity=Success
SymbolicName=INSTALL_CATEGORY
Language=English
Installation
.
MessageId=0x2
Severity=Success
SymbolicName=QUERY_CATEGORY
Language=English
Database Query
.
MessageId=0x3
Severity=Success
SymbolicName=REFRESH_CATEGORY
Language=English
Data Refresh
.
; // - Event messages -
; // *********************************
MessageId = 1000
Severity = Success
Facility = Application
SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
Language=English
My application message text, in English, for message id 1000, called from %1.
.
MessageId = 1001
Severity = Warning
Facility = Application
SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
Language=English
My application message text, in English, for message id 1001, called from %1.
.
MessageId = 1002
Severity = Success
Facility = Application
SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
Language=English
My generic information message in English, for message id 1002.
.
MessageId = 1003
Severity = Warning
Facility = Application
SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
Language=English
My generic warning message in English, for message id 1003, called from %1.
.
MessageId = 1004
Severity = Success
Facility = Application
SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
Language=English
The update cycle is complete for %%5002.
.
MessageId = 1005
Severity = Warning
Facility = Application
SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
Language=English
The refresh operation did not complete because the connection to server %1 could not be established.
.
; // - Event log display name -
; // ********************************************************
MessageId = 5001
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
Language=English
Sample Event Log
.
; // - Event message parameters -
; // Language independent insertion strings
; // ********************************************************
MessageId = 5002
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
Language=English
SVC_UPDATE.EXE
.
備註
CategoryCount使用和 CategoryResourceFile 屬性來撰寫具有本地化類別字串的事件。 如果您撰寫事件時提供類別，事件檢視器 會顯示事件項目的類別。 事件記錄檔類別是應用程式定義的字串，可協助篩選事件，或提供有關事件的資訊。 例如，您的應用程式可以針對不同的元件或不同的作業定義不同的類別。
事件類別目錄是選擇性的;如果您的應用程式未使用類別，請勿設定 CategoryCount 和 CategoryResourceFile 屬性。
如需定義事件訊息和建置事件資源檔的詳細資訊，請參閱 Platform SDK 檔中的 訊息編譯 程式一文。
