| <html><head><meta http-equiv="X-UA-Compatible" content="IE=edge" /><link rel="shortcut icon" href="../icons/favicon.ico" /><style type="text/css">.OH_CodeSnippetContainerTabLeftActive, .OH_CodeSnippetContainerTabLeft,.OH_CodeSnippetContainerTabLeftDisabled { }.OH_CodeSnippetContainerTabRightActive, .OH_CodeSnippetContainerTabRight,.OH_CodeSnippetContainerTabRightDisabled { }.OH_footer { }</style><link rel="stylesheet" type="text/css" href="../styles/branding.css" /><link rel="stylesheet" type="text/css" href="../styles/branding-en-US.css" /><script type="text/javascript" src="../scripts/branding.js"> </script><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>EventLogAppender Class</title><meta name="Language" content="en-us" /><meta name="System.Keywords" content="EventLogAppender class" /><meta name="System.Keywords" content="log4net.Appender.EventLogAppender class" /><meta name="System.Keywords" content="EventLogAppender class, about EventLogAppender class" /><meta name="Microsoft.Help.F1" content="log4net.Appender.EventLogAppender" /><meta name="Microsoft.Help.Id" content="T:log4net.Appender.EventLogAppender" /><meta name="Description" content="Writes events to the system event log." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="true" /><meta name="container" content="log4net.Appender" /><meta name="file" content="T_log4net_Appender_EventLogAppender" /><meta name="guid" content="T_log4net_Appender_EventLogAppender" /><link type="text/css" rel="stylesheet" href="../styles/highlight.css" /><script type="text/javascript" src="../scripts/highlight.js"> </script></head><body onload="OnLoad('cs')"><input type="hidden" id="userDataCache" class="userDataStyle" /><div class="OH_outerDiv"><div class="OH_outerContent"><table class="TitleTable"><tr><td class="OH_tdTitleColumn">EventLogAppender Class</td><td class="OH_tdRunningTitleColumn">Apache log4net™ SDK Documentation</td></tr></table><div id="mainSection"><div id="mainBody"><span class="introStyle"></span><div class="summary"> |
| Writes events to the system event log. |
| </div><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Inheritance Hierarchy</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">System<span id="LST8120C0C5_0"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_0?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>Object</a><br /> <a href="T_log4net_Appender_AppenderSkeleton.htm">log4net.Appender<span id="LST8120C0C5_1"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_1?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>AppenderSkeleton</a><br /> <span class="selflink">log4net.Appender<span id="LST8120C0C5_2"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_2?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>EventLogAppender</span><br /><p> </p><strong>Namespace:</strong> <a href="N_log4net_Appender.htm">log4net.Appender</a><br /><strong>Assembly:</strong> log4net (in log4net.dll) Version: 2.0.6.0-.NET 4.0<div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Syntax</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><div class="OH_CodeSnippetContainer"><div class="OH_CodeSnippetContainerTabs"><div class="OH_CodeSnippetContainerTabLeft" id="ID0EDCA_tabimgleft"> </div><div id="ID0EDCA_tab1" class="OH_CodeSnippetContainerTabFirst"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','cs','1','4');return false;">C#</a></div><div id="ID0EDCA_tab2" class="OH_CodeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','vb','2','4');return false;">VB</a></div><div id="ID0EDCA_tab3" class="OH_CodeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','cpp','3','4');return false;">C++</a></div><div id="ID0EDCA_tab4" class="OH_CodeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','fs','4','4');return false;">F#</a></div><div class="OH_CodeSnippetContainerTabRight" id="ID0EDCA_tabimgright"> </div></div><div class="OH_CodeSnippetContainerCodeCollection"><div class="OH_CodeSnippetToolBar"><div class="OH_CodeSnippetToolBarText"><a id="ID0EDCA_copyCode" href="#" onclick="javascript:CopyToClipboard('ID0EDCA');return false;" title="Copy">Copy</a></div></div><div id="ID0EDCA_code_Div1" class="OH_CodeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="keyword">public</span> <span class="keyword">class</span> <span class="identifier">EventLogAppender</span> : <span class="identifier">AppenderSkeleton</span></pre></div><div id="ID0EDCA_code_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">Public</span> <span class="keyword">Class</span> <span class="identifier">EventLogAppender</span> |
| <span class="keyword">Inherits</span> <span class="identifier">AppenderSkeleton</span></pre></div><div id="ID0EDCA_code_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">public</span> <span class="keyword">ref class</span> <span class="identifier">EventLogAppender</span> : <span class="keyword">public</span> <span class="identifier">AppenderSkeleton</span></pre></div><div id="ID0EDCA_code_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">type</span> <span class="identifier">EventLogAppender</span> = |
| <span class="keyword">class</span> |
| <span class="keyword">inherit</span> <span class="identifier">AppenderSkeleton</span> |
| <span class="keyword">end</span></pre></div></div></div><script type="text/javascript">AddLanguageTabSet("ID0EDCA");</script><p>The <span class="selflink">EventLogAppender</span> type exposes the following members.</p><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Constructors</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><table id="memberList" class="members"><tr><th class="ps_iconColumn"> |
| |
| </th><th>Name</th><th>Description</th></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_EventLogAppender__ctor.htm">EventLogAppender<span id="LST8120C0C5_3"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_3?cs=()|vb=|cpp=()|nu=()|fs=()");</script></a></td><td><div class="summary"> |
| Initializes a new instance of the <span class="selflink">EventLogAppender</span> class. |
| </div></td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_EventLogAppender__ctor_1.htm">EventLogAppender(ILayout)</a></td><td> <strong>Obsolete. </strong><div class="summary"> |
| Initializes a new instance of the <span class="selflink">EventLogAppender</span> class |
| with the specified <a href="T_log4net_Layout_ILayout.htm">ILayout</a>. |
| </div></td></tr></table><a href="#mainBody">Top</a><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Properties</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><table id="memberList" class="members"><tr><th class="ps_iconColumn"> |
| |
| </th><th>Name</th><th>Description</th></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_ApplicationName.htm">ApplicationName</a></td><td><div class="summary"> |
| Property used to set the Application name. This appears in the |
| event logs when logging. |
| </div></td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_Category.htm">Category</a></td><td><div class="summary"> |
| Gets or sets the <span class="code">Category</span> to use unless one is explicitly specified via the <span class="code">LoggingEvent</span>'s properties. |
| </div></td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_AppenderSkeleton_ErrorHandler.htm">ErrorHandler</a></td><td><div class="summary"> |
| Gets or sets the <a href="T_log4net_Core_IErrorHandler.htm">IErrorHandler</a> for this appender. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_EventId.htm">EventId</a></td><td><div class="summary"> |
| Gets or sets the <span class="code">EventId</span> to use unless one is explicitly specified via the <span class="code">LoggingEvent</span>'s properties. |
| </div></td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_AppenderSkeleton_FilterHead.htm">FilterHead</a></td><td><div class="summary"> |
| The filter chain. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_AppenderSkeleton_Layout.htm">Layout</a></td><td><div class="summary"> |
| Gets or sets the <a href="T_log4net_Layout_ILayout.htm">ILayout</a> for this appender. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_LogName.htm">LogName</a></td><td><div class="summary"> |
| The name of the log where messages will be stored. |
| </div></td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_MachineName.htm">MachineName</a></td><td><div class="summary"> |
| This property is used to return the name of the computer to use |
| when accessing the event logs. Currently, this is the current |
| computer, denoted by a dot "." |
| </div></td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_AppenderSkeleton_Name.htm">Name</a></td><td><div class="summary"> |
| Gets or sets the name of this appender. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;declared;notNetfw;"><td><img src="../icons/protproperty.gif" alt="Protected property" title="Protected property" /></td><td><a href="P_log4net_Appender_EventLogAppender_RequiresLayout.htm">RequiresLayout</a></td><td><div class="summary"> |
| This appender requires a <a href="N_log4net_Layout.htm">log4net.Layout</a> to be set. |
| </div> (Overrides <a href="P_log4net_Appender_AppenderSkeleton_RequiresLayout.htm">AppenderSkeleton<span id="LST8120C0C5_4"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_4?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>RequiresLayout</a>.)</td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_EventLogAppender_SecurityContext.htm">SecurityContext</a></td><td><div class="summary"> |
| Gets or sets the <a href="P_log4net_Appender_EventLogAppender_SecurityContext.htm">SecurityContext</a> used to write to the EventLog. |
| </div></td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubproperty.gif" alt="Public property" title="Public property" /></td><td><a href="P_log4net_Appender_AppenderSkeleton_Threshold.htm">Threshold</a></td><td><div class="summary"> |
| Gets or sets the threshold <a href="T_log4net_Core_Level.htm">Level</a> of this appender. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr></table><a href="#mainBody">Top</a><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Methods</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><table id="memberList" class="members"><tr><th class="ps_iconColumn"> |
| |
| </th><th>Name</th><th>Description</th></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_EventLogAppender_ActivateOptions.htm">ActivateOptions</a></td><td><div class="summary"> |
| Initialize the appender based on the options set |
| </div> (Overrides <a href="M_log4net_Appender_AppenderSkeleton_ActivateOptions.htm">AppenderSkeleton<span id="LST8120C0C5_5"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_5?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>ActivateOptions<span id="LST8120C0C5_6"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_6?cs=()|vb=|cpp=()|nu=()|fs=()");</script></a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_AddFilter.htm">AddFilter</a></td><td><div class="summary"> |
| Adds a filter to the end of the filter chain. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;declared;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_EventLogAppender_AddMapping.htm">AddMapping</a></td><td><div class="summary"> |
| Add a mapping of level to <a href="http://msdn2.microsoft.com/en-us/library/chx09fy8" target="_blank">EventLogEntryType</a> - done by the config file |
| </div></td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_Append_1.htm">Append(<span id="LST8120C0C5_7"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_7?cpp=array<");</script>LoggingEvent<span id="LST8120C0C5_8"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_8?cpp=>|cs=[]|vb=()|nu=[]|fs=[]");</script>)</a></td><td><div class="summary"> |
| Append a bulk array of logging events. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;declared;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_EventLogAppender_Append.htm">Append(LoggingEvent)</a></td><td><div class="summary"> |
| This method is called by the <span class="nolink">DoAppend(LoggingEvent)</span> |
| method. |
| </div> (Overrides <a href="M_log4net_Appender_AppenderSkeleton_Append.htm">AppenderSkeleton<span id="LST8120C0C5_9"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_9?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>Append(LoggingEvent)</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_ClearFilters.htm">ClearFilters</a></td><td><div class="summary"> |
| Clears the filter list for this appender. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_Close.htm">Close</a></td><td><div class="summary"> |
| Closes the appender and release resources. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_DoAppend.htm">DoAppend(LoggingEvent)</a></td><td><div class="summary"> |
| Performs threshold checks and invokes filters before |
| delegating actual logging to the subclasses specific |
| <span class="nolink">[M:Append(LoggingEvent)]</span> method. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_DoAppend_1.htm">DoAppend(<span id="LST8120C0C5_10"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_10?cpp=array<");</script>LoggingEvent<span id="LST8120C0C5_11"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_11?cpp=>|cs=[]|vb=()|nu=[]|fs=[]");</script>)</a></td><td><div class="summary"> |
| Performs threshold checks and invokes filters before |
| delegating actual logging to the subclasses specific |
| <span class="nolink">[M:Append(LoggingEvent[])]</span> method. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="http://msdn2.microsoft.com/en-us/library/bsc2ak47" target="_blank">Equals</a></td><td><div class="summary"> |
| Determines whether the specified <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a> is equal to the current <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>. |
| </div> (Inherited from <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_FilterEvent.htm">FilterEvent</a></td><td><div class="summary"> |
| Test if the logging event should we output by this appender |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_Finalize.htm">Finalize</a></td><td><div class="summary"> |
| Finalizes this appender by calling the implementation's |
| <a href="M_log4net_Appender_AppenderSkeleton_Close.htm">Close<span id="LST8120C0C5_12"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST8120C0C5_12?cs=()|vb=|cpp=()|nu=()|fs=()");</script></a> method. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_Flush.htm">Flush</a></td><td><div class="summary"> |
| Flushes any buffered log data. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;declared;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_EventLogAppender_GetEntryType.htm">GetEntryType</a></td><td><div class="summary"> |
| Get the equivalent <a href="http://msdn2.microsoft.com/en-us/library/chx09fy8" target="_blank">EventLogEntryType</a> for a <a href="T_log4net_Core_Level.htm">Level</a><span class="parameter">level</span></div></td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="http://msdn2.microsoft.com/en-us/library/zdee4b3y" target="_blank">GetHashCode</a></td><td><div class="summary"> |
| Serves as a hash function for a particular type. |
| </div> (Inherited from <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="http://msdn2.microsoft.com/en-us/library/dfwy45w9" target="_blank">GetType</a></td><td><div class="summary"> |
| Gets the <a href="http://msdn2.microsoft.com/en-us/library/42892f65" target="_blank">Type</a> of the current instance. |
| </div> (Inherited from <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_IsAsSevereAsThreshold.htm">IsAsSevereAsThreshold</a></td><td><div class="summary"> |
| Checks if the message level is below this appender's threshold. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="http://msdn2.microsoft.com/en-us/library/57ctke0a" target="_blank">MemberwiseClone</a></td><td><div class="summary"> |
| Creates a shallow copy of the current <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>. |
| </div> (Inherited from <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_OnClose.htm">OnClose</a></td><td><div class="summary"> |
| Is called when the appender is closed. Derived classes should override |
| this method if resources need to be released. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_PreAppendCheck.htm">PreAppendCheck</a></td><td><div class="summary"> |
| Called before <span class="nolink">[M:Append(LoggingEvent)]</span> as a precondition. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_RenderLoggingEvent.htm">RenderLoggingEvent(LoggingEvent)</a></td><td><div class="summary"> |
| Renders the <a href="T_log4net_Core_LoggingEvent.htm">LoggingEvent</a> to a string. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="protected;inherited;notNetfw;"><td><img src="../icons/protmethod.gif" alt="Protected method" title="Protected method" /></td><td><a href="M_log4net_Appender_AppenderSkeleton_RenderLoggingEvent_1.htm">RenderLoggingEvent(TextWriter, LoggingEvent)</a></td><td><div class="summary"> |
| Renders the <a href="T_log4net_Core_LoggingEvent.htm">LoggingEvent</a> to a string. |
| </div> (Inherited from <a href="T_log4net_Appender_AppenderSkeleton.htm">AppenderSkeleton</a>.)</td></tr><tr data="public;inherited;notNetfw;"><td><img src="../icons/pubmethod.gif" alt="Public method" title="Public method" /></td><td><a href="http://msdn2.microsoft.com/en-us/library/7bxwbwt2" target="_blank">ToString</a></td><td><div class="summary"> |
| Returns a <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">String</a> that represents the current <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>. |
| </div> (Inherited from <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">Object</a>.)</td></tr></table><a href="#mainBody">Top</a><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Remarks</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><p> |
| The appender will fail if you try to write using an event source that doesn't exist unless it is running with local administrator privileges. |
| See also http://logging.apache.org/log4net/release/faq.html#trouble-EventLog |
| </p><p> |
| The <span class="code">EventID</span> of the event log entry can be |
| set using the <span class="code">EventID</span> property (<a href="P_log4net_Core_LoggingEvent_Properties.htm">Properties</a>) |
| on the <a href="T_log4net_Core_LoggingEvent.htm">LoggingEvent</a>. |
| </p><p> |
| The <span class="code">Category</span> of the event log entry can be |
| set using the <span class="code">Category</span> property (<a href="P_log4net_Core_LoggingEvent_Properties.htm">Properties</a>) |
| on the <a href="T_log4net_Core_LoggingEvent.htm">LoggingEvent</a>. |
| </p><p> |
| There is a limit of 32K characters for an event log message |
| </p><p> |
| When configuring the EventLogAppender a mapping can be |
| specified to map a logging level to an event log entry type. For example: |
| </p><div class="OH_CodeSnippetContainer"><div class="OH_CodeSnippetContainerCodeCollection"><div class="OH_CodeSnippetToolBar"><div class="OH_CodeSnippetToolBarText"><a id="ID0EABFBA_copyCode" href="#" onclick="javascript:CopyToClipboard('ID0EABFBA');return false;" title="Copy">Copy</a></div></div><div id="ID0EABFBA_code_Div1" class="OH_CodeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">mapping</span><span class="highlight-xml-bracket">></span> |
| <span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">level</span> <span class="highlight-xml-attribute-name">value</span><span class="highlight-xml-attribute-equal">=</span><span class="highlight-xml-attribute-value">"ERROR"</span> <span class="highlight-xml-bracket">/></span> |
| <span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">eventLogEntryType</span> <span class="highlight-xml-attribute-name">value</span><span class="highlight-xml-attribute-equal">=</span><span class="highlight-xml-attribute-value">"Error"</span> <span class="highlight-xml-bracket">/></span> |
| <span class="highlight-xml-bracket"></</span><span class="highlight-xml-tag">mapping</span><span class="highlight-xml-bracket">></span> |
| <span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">mapping</span><span class="highlight-xml-bracket">></span> |
| <span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">level</span> <span class="highlight-xml-attribute-name">value</span><span class="highlight-xml-attribute-equal">=</span><span class="highlight-xml-attribute-value">"DEBUG"</span> <span class="highlight-xml-bracket">/></span> |
| <span class="highlight-xml-bracket"><</span><span class="highlight-xml-tag">eventLogEntryType</span> <span class="highlight-xml-attribute-name">value</span><span class="highlight-xml-attribute-equal">=</span><span class="highlight-xml-attribute-value">"Information"</span> <span class="highlight-xml-bracket">/></span> |
| <span class="highlight-xml-bracket"></</span><span class="highlight-xml-tag">mapping</span><span class="highlight-xml-bracket">></span></pre></div></div></div><script type="text/javascript">AddLanguageTabSet("ID0EABFBA");</script><p> |
| The Level is the standard log4net logging level and eventLogEntryType can be any value |
| from the <a href="http://msdn2.microsoft.com/en-us/library/chx09fy8" target="_blank">EventLogEntryType</a> enum, i.e.: |
| <ul><li><strong>Error</strong> - an error event</li><li><strong>Warning</strong> - a warning event</li><li><strong>Information</strong> - an informational event</li></ul></p><div class="OH_CollapsibleAreaRegion" id="seeAlsoSection"><div class="OH_regiontitle">See Also</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"> </div><h4 class="subHeading">Reference</h4><div class="seeAlsoStyle"><a href="N_log4net_Appender.htm">log4net.Appender Namespace</a></div></div></div></div></div><div id="OH_footer" class="OH_footer">Apache log4net, Apache and log4net are trademarks of The Apache Software Foundation.<p><a href="http://logging.apache.org/log4net/" target="_blank">Copyright 2004-2017 The Apache Software Foundation</a></p><div class="OH_feedbacklink">Send comments on this topic to |
| <a id="HT_MailLink" href="mailto:http%3A%2F%2Flogging.apache.org%2Flog4net%2Fmail-lists.html?Subject=Apache log4net™ SDK Documentation">http://logging.apache.org/log4net/mail-lists.html</a></div><script type="text/javascript"> |
| var HT_mailLink = document.getElementById("HT_MailLink"); |
| var HT_mailLinkText = HT_mailLink.innerHTML; |
| HT_mailLink.href += ": " + document.title + "\u0026body=" + encodeURIComponent("Your feedback is used to improve the documentation and the product. Your e-mail address will not be used for any other purpose and is disposed of after the issue you report is resolved. While working to resolve the issue that you report, you may be contacted via e-mail to get further details or clarification on the feedback you sent. After the issue you report has been addressed, you may receive an e-mail to let you know that your feedback has been addressed."); |
| HT_mailLink.innerHTML = HT_mailLinkText; |
| </script> </div></body></html> |
