Return-Path: X-Original-To: apmail-logging-commits-archive@minotaur.apache.org Delivered-To: apmail-logging-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id B0C9D9ADB for ; Tue, 14 Feb 2012 17:11:22 +0000 (UTC) Received: (qmail 76998 invoked by uid 500); 14 Feb 2012 17:11:22 -0000 Delivered-To: apmail-logging-commits-archive@logging.apache.org Received: (qmail 76974 invoked by uid 500); 14 Feb 2012 17:11:22 -0000 Mailing-List: contact commits-help@logging.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@logging.apache.org Delivered-To: mailing list commits@logging.apache.org Received: (qmail 76966 invoked by uid 99); 14 Feb 2012 17:11:22 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 14 Feb 2012 17:11:22 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 14 Feb 2012 17:11:18 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 2CD042388A6E; Tue, 14 Feb 2012 17:10:58 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1244132 [5/14] - in /logging/log4net/site: ./ css/ images/ images/logos/ release/ release/howto/ release/manual/ Date: Tue, 14 Feb 2012 17:10:56 -0000 To: commits@logging.apache.org From: bodewig@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120214171058.2CD042388A6E@eris.apache.org> Added: logging/log4net/site/release/example-apps.html URL: http://svn.apache.org/viewvc/logging/log4net/site/release/example-apps.html?rev=1244132&view=auto ============================================================================== --- logging/log4net/site/release/example-apps.html (added) +++ logging/log4net/site/release/example-apps.html Tue Feb 14 17:10:54 2012 @@ -0,0 +1,651 @@ + + + + + + + Apache log4net: Examples + + + + + + + + + + +
+ +
+
+
+ + + +

Apache log4net™ Examples

+ +

Overview

+

+ The following examples are only available in the log4net source download, not + on-line. To obtain the examples download the log4net source release. + +

+
+ +

Building Examples

+

Building An Example

+

+ A single example can be build by running nant from + the example directory. +

+

+ For example running nant in the + examples\net\1.0\Tutorials\ConsoleApp\cs directory + will build the C# version of the Microsoft® .NET 1.0 ConsoleApp example. +

+

+ nant can be run in any directory containing a + nant.build file. The typical behavior of the build file + is to build all projects under the current directory. +

+

+ For example running nant in the + examples\net\1.1 directory + will build all the examples for the .NET 1.1 platform. +

+
+ +

Building All Examples

+

+ To build all the examples either run nant in the + examples directory or you can specify the + compile-examples target to the main log4net nant build. +

+
+ +

Visual Studio .NET

+

+ There are Visual Studio .NET 2002 project files for the .NET 1.0 framework. + The solution files for C# and VB are in the examples\net\1.0 + folder. +

+

+ For the Managed C++ project there is a Visual Studio .NET 2003 project file + in the examples\net\1.1 folder. +

+
+
+ +

Examples

+ +

Tutorial - ConsoleApp

+

+ ConsoleApp shows how to write a simple console application that initializes + logging and logs various events. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + MONO 1.0: + C# +
    • +
  • + .NET 1.0: + C#, + VB +
    • +
  • + .NET 1.1: + C++, + JScript.NET +
    • +
  • + .NET Compact Framework 1.0: + C#, + VB +
    • +
  • + SSCLI 1.0: + JScript.NET +
    • +
+

+ To run this example execute ConsoleApp.exe from the build output directory. +

+
+ +

Tutorial - WebApp

+

+ ConsoleApp shows how to write a simple ASP.NET web application that initializes + logging and logs various events. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C#, + VB +
    • +
+

+ To run this example you need to have an ASP.NET container application to + host the web application, for example IIS. In IIS create a new virtual + directory pointing to the WebApp src directory. Configure IIS to recognize + this virtual directory as an application. Open up a web browser, navigate to + the virtual directory and to the WebForm1.aspx page within it. +

+
+ +

Remoting - RemotingClient

+

+ The RemotingClient application is a simple console application that configures + log4net with the RemotingAppender. This appender will attempt to deliver the + logging events to a remoting listener. This example should be run in conjunction + with the RemotingServer. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute RemotingClient.exe from the build output directory. +

+
+ +

Remoting - RemotingServer

+

+ The RemotingServer application is a simple console application that listens for + logging events from a remote RemotingAppender and then logs them through the + local log4net instance. This example should be run in conjunction + with the RemotingClient. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute RemotingServer.exe from the build output directory. + While this process is running execute the RemotingClient.exe program on + the same machine. The logging events from the client are transferred to the server. +

+
+ +

Repository - SimpleModule

+

+ The SimpleModule is a class library that is intended to be used as part of + the SimpleApp example, + This class library uses the log4net.Config.Repository + attribute to create a separate configuration space from other assemblies. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + MONO 1.0: + C# +
    • +
  • + .NET 1.0: + C#, + VB +
    • +
  • + .NET 1.1: + JScript.NET +
    • +
  • + SSCLI 1.0: + C# +
    • +
+

+ This library is intended to be used as part of the SimpleApp example. +

+
+ +

Repository - SharedModule

+

+ The SharedModule is a class library that is intended to be used as part of + the SimpleApp example, + This class library uses log4net but does not attempt to configure logging. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + MONO 1.0: + C# +
    • +
  • + .NET 1.0: + C#, + VB +
    • +
  • + .NET 1.1: + JScript.NET +
    • +
  • + SSCLI 1.0: + C# +
    • +
+

+ This library is intended to be used as part of the SimpleApp example. +

+
+ +

Repository - SimpleApp

+

+ The SimpleApp example uses the SimpleModule and SharedModule to demonstrate + the ways in which multiple assemblies within the same process may be + separately configured. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + MONO 1.0: + C# +
    • +
  • + .NET 1.0: + C#, + VB +
    • +
  • + .NET 1.1: + JScript.NET +
    • +
  • + SSCLI 1.0: + C# +
    • +
+

+ To run this example execute SimpleApp.exe from the build output directory. +

+
+ +

Extensibility - EventIDLogApp

+

+ The EventIDLogApp example demonstrates using the log4net.Ext.EventID extension. + The extension needs to be built separately from the + extensions\net\1.0\log4net.Ext.EventID directory. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute EventIDLogApp.exe from the build output directory. +

+
+ +

Extensibility - TraceLogApp

+

+ The TraceLogApp example demonstrates using the log4net.Ext.Trace extension. + The extension needs to be built separately from the + extensions\net\1.0\log4net.Ext.Trace directory. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute TraceLogApp.exe from the build output directory. +

+
+ +

SampleAppenders

+

+ This project includes the following example appenders. +

+
    +
  • + AsyncAppender +
    • +
  • + FastDbAppender +
    • +
  • + FireEventAppender +
    • +
  • + MessageBoxAppender +
    • +
  • + MessageObjectExpanderAppender +
    • +
  • + MsmqAppender +
    • +
  • + PatternFileAppender +
    • +
  • + SimpleSmtpAppender +
    • +
+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute SampleAppendersApp.exe from the build output directory. +

+
+ +

SampleLayouts

+

+ This project includes the following example layouts. +

+
    +
  • + ForwardingLayout +
    • +
  • + LineWrappingLayout +
    • +
+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+ To run this example execute SampleLayoutsApp.exe from the build output directory. +

+
+ +

Performance - NotLogging

+

+ The NotLogging example benchmarks the performance of log4net logging statements in + user code in various scenarios including when logging is disabled. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + MONO 1.0: + C# +
    • +
  • + .NET 1.0: + C#, + VB +
    • +
+

+

+
+ +

WmiAppender

+

+ The WmiAppender sample shows an example appender that fires events through + Windows Management Instrumentation. +

+

+ This example is available for the following platforms and languages. If a version + is not available for your chosen platform and language combination then select the + nearest platform for the appropriate language. +

+
    +
  • + .NET 1.0: + C# +
    • +
+

+

+
+ +
+ +
+ + +
+
+
+
+
+