Writes the time and identifier to the log, leaving the line ready for further content through LogContinue and LogFinish

Namespace: ASCOM.Utilities.Interfaces
Assembly: ASCOM.Utilities (in ASCOM.Utilities.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
void LogStart(
	string Identifier,
	string Message
)
Visual Basic
Sub LogStart ( _
	Identifier As String, _
	Message As String _
)
Visual C++
void LogStart(
	String^ Identifier, 
	String^ Message
)

Parameters

Identifier
Type: System..::..String
Identifies the meaning of the the message e.g. name of modeule or method logging the message.
Message
Type: System..::..String
Message to log

Remarks

Use this to start a log line where you want to write further information on the line at a later time.

E.g. You might want to use this to record that an action has started and then append the word OK if all went well. You would then end up with just one line to record the whole transaction even though you didn't know that it would be successful when you started. If you just used LogMsg you would have ended up with two log lines, one showing the start of the transaction and the next the outcome.

Will create a LOGISSUE message in the log if called before a line started by LogStart has been closed with LogFinish. Posible reasons for this are exceptions causing the normal flow of code to be bypassed or logic errors.

See Also