remove obsoleted profile page; update features/logging, remove it from stub; update logging example
This commit is contained in:
@@ -1,11 +1,35 @@
|
|||||||
|stub| Logging
|
Logging
|
||||||
==============
|
=======
|
||||||
|
|
||||||
|stub-desc|
|
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
|
Example
|
||||||
-------
|
-------
|
||||||
|
|
||||||
.. literalinclude:: /samples/logging.cs
|
.. literalinclude:: /samples/logging.cs
|
||||||
:language: csharp6
|
:language: c#
|
||||||
:tab-width: 2
|
:tab-width: 2
|
||||||
|
|||||||
@@ -1,4 +0,0 @@
|
|||||||
|stub| Profile
|
|
||||||
===================
|
|
||||||
|
|
||||||
|stub-desc|
|
|
||||||
@@ -3,13 +3,14 @@ class Program
|
|||||||
private static DiscordBotClient _client;
|
private static DiscordBotClient _client;
|
||||||
static void Main(string[] args)
|
static void Main(string[] args)
|
||||||
{
|
{
|
||||||
var client = new DiscordClient(new DiscordClientConfig {
|
var client = new DiscordClient(x =>
|
||||||
//Warning: Debug mode should only be used for identifying problems. It _will_ slow your application down.
|
{
|
||||||
LogLevel = LogMessageSeverity.Debug
|
LogLevel = LogSeverity.Info
|
||||||
});
|
});
|
||||||
client.LogMessage += (s, e) => Console.WriteLine($"[{e.Severity}] {e.Source}: {e.Message}");
|
|
||||||
|
_client.Log.Message += (s, e) => Console.WriteLine($"[{e.Severity}] {e.Source}: {e.Message}");
|
||||||
client.Run(async () =>
|
|
||||||
|
client.ExecuteAndWait(async () =>
|
||||||
{
|
{
|
||||||
await client.Connect("discordtest@email.com", "Password123");
|
await client.Connect("discordtest@email.com", "Password123");
|
||||||
if (!client.Servers.Any())
|
if (!client.Servers.Any())
|
||||||
|
|||||||
Reference in New Issue
Block a user