36 lines
1.1 KiB
ReStructuredText
36 lines
1.1 KiB
ReStructuredText
Logging
|
|
=======
|
|
|
|
Discord.Net will log all of its events/exceptions using a built-in LogManager.
|
|
This LogManager can be accessed through DiscordClient.Log
|
|
|
|
Usage
|
|
-----
|
|
|
|
To handle Log Messages through Discord.Net's Logger, you must hook into the Log.Message<LogMessageEventArgs> Event.
|
|
|
|
The LogManager does not provide a string-based result for the message, you must put your own message format together using the data provided through LogMessageEventArgs
|
|
See the Example for a snippet of logging.
|
|
|
|
Logging Your Own Data
|
|
---------------------
|
|
|
|
The LogManager included in Discord.Net can also be used to log your own messages.
|
|
|
|
You can use DiscordClient.Log.Log(LogSeverity, Source, Message, Exception), or one of the shortcut helpers, to log data.
|
|
|
|
Example:
|
|
.. code-block:: c#
|
|
|
|
_client.MessageReceived += async (s, e) {
|
|
// Log a new Message with Severity Info, Sourced from 'MessageReceived', with the Message Contents.
|
|
_client.Log.Info("MessageReceived", e.Message.Text, null);
|
|
};
|
|
|
|
Example
|
|
-------
|
|
|
|
.. literalinclude:: /samples/logging.cs
|
|
:language: c#
|
|
:tab-width: 2
|