xGlobal.infologLine Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns the number of lines in the Infolog buffer.
public:
static int infologLine();public static int infologLine ();static member infologLine : unit -> intPublic Shared Function infologLine () As IntegerReturns
Remarks
This method has similar functionality to the xInfo.line method, but it improves performance and lowers network load when you are executing server-side code. When xInfo.line is run on the server, it makes a call to the client to retrieve the number of lines in the Infolog buffer. The xGlobal::infologLine method retrieves the line count of the server-side Infolog buffer, so that you do not have to call to the client. When the xGlobal::infologLine method is called on the client, it returns the count directly from the Infolog buffer on the client. This method is especially useful when you are writing server-side code that processes exceptions. The number of lines in the Infolog is typically stored before a try/catch block is entered. If an exception occurs, the number of lines that were previously stored is used to determine which messages were logged during the code in the try block. If no exceptions occur, the stored Infolog buffer line count is often unused. By using the xGlobal::infologLine method instead of the xInfo.line method to retrieve the Infolog lines, you avoid a round trip to the client.