Creates a new logmessage and initializes it with the parameters given.

Overload List

Creates and intializes a new logmessage, settings its Module and Case properties to the values given in the call.

[Visual Basic] Overloads Public Sub Create(String,String)

[C#] public void Create(string,string);

[JScript] public function Create(String,String)

Creates and intializes a new logmessage, settings its Module, Case and LogLevel properties to the values given in the call.

[Visual Basic] Overloads Public Sub Create(String,String,ITLogLevel)

[C#] public void Create(string,string,ITLogLevel);

[JScript] public function Create(String,String,ITLogLevel)

Creates and intializes a new logmessage, settings its Module, Case, LogLevel and LogChannelName properties to the values given in the call.

[Visual Basic] Overloads Public Sub Create(String,String,ITLogLevel,String)

[C#] public void Create(string,string,ITLogLevel,string);

[JScript] public function Create(String,String,ITLogLevel,String)

Remarks

Input parameters

This is the general order of parameters (also in the ITLogMsg constructors and in ITLogLib.QuickLog and similar methods):

• Module
• Case
• LogLevel (optional; default value: LEVEL_INFO)
• LogChannelName (optional; default value: "StdLog")

 

Return value and handling of suppressed logmessages

• normal instance: If the logchannel is open and the Module and Case names pass the write-out filter condition defined for the logchannel in the configuration file, then a new instance of ITLogMsg representing a real logmessage object is returned.
• special "null" or dummy instance: In all other cases (logchannel not open or logmessage filtered out) you get a reference to an existing special ITLogMsg instance. With this instance you can still use all normal ITLogMsg operations, but it will not store the data and at the end no file output will occur.

 

Other ways to create logmessages

To use ITLogMsg.Create, you must -- of course -- have already created a (possibly empty) instance of class ITLogMsg.
Therefore it might be easier for you to use:

• The parameterized constructors of ITLogMsg.
  Note: These are not available in the "old" ITLogLib2/COM-DLL because of technical reasons.
• ITOutputLogChannel.CreateLogMsg

See Also

ITLogMsg Class  | ITLogMsg Members  | ITLogMsg constructors  | ITOutputLogChannel.CreateLogMsg

 

 

---

(c) 2002-2004 iTech Software GmbH, Berlin. Version 2.4, Wed 07 Jul 2004.