blob: a3ef2e72bbb0c3c22f2b310058a244084f7ab766 [file] [log] [blame]
<html xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:mshelp="http://msdn.microsoft.com/mshelp"><head><link rel="SHORTCUT ICON" href="./../icons/favicon.ico" /><style type="text/css">.OH_CodeSnippetContainerTabLeftActive, .OH_CodeSnippetContainerTabLeft,.OH_CodeSnippetContainerTabLeftDisabled { backgroundImageName: tabLeftBG.gif; }.OH_CodeSnippetContainerTabRightActive, .OH_CodeSnippetContainerTabRight,.OH_CodeSnippetContainerTabRightDisabled { backgroundImageName: tabRightBG.gif; }.OH_footer { backgroundImageName: footer_slice.gif; background-position: top; background-repeat: repeat-x; }</style><link rel="stylesheet" type="text/css" href="./../styles/branding.css" /><link rel="stylesheet" type="text/css" href="./../styles/branding-en-US.css" /><style type="text/css">
body
{
border-left:5px solid #e6e6e6;
overflow-x:scroll;
overflow-y:scroll;
}
</style><script src="./../scripts/branding.js" type="text/javascript"><!----></script><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>TraceAppender.ImmediateFlush Property </title><meta name="Language" content="en-us" /><meta name="System.Keywords" content="ImmediateFlush property" /><meta name="System.Keywords" content="TraceAppender.ImmediateFlush property" /><meta name="Microsoft.Help.F1" content="log4net.Appender.TraceAppender.ImmediateFlush" /><meta name="Microsoft.Help.F1" content="log4net.Appender.TraceAppender.get_ImmediateFlush" /><meta name="Microsoft.Help.F1" content="log4net.Appender.TraceAppender.set_ImmediateFlush" /><meta name="Microsoft.Help.Id" content="P:log4net.Appender.TraceAppender.ImmediateFlush" /><meta name="Description" content="Gets or sets a value that indicates whether the appender will flush at the end of each write." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="'true'" /><meta name="container" content="log4net.Appender" /><meta name="file" content="P_log4net_Appender_TraceAppender_ImmediateFlush" /><meta name="guid" content="P_log4net_Appender_TraceAppender_ImmediateFlush" /><link type="text/css" rel="stylesheet" href="ms-help://Hx/HxRuntime/HxLink.css" /><meta name="SelfBranded" content="true" /></head><body onload="onLoad()" class="primary-mtps-offline-document"><div class="OH_outerDiv"><div class="OH_outerContent"><table class="TitleTable"><tr><td class="OH_tdTitleColumn">TraceAppender<span id="ID0EBBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBBABAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>ImmediateFlush Property </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">
Gets or sets a value that indicates whether the appender will
flush at the end of each write.
</div><p></p><b>Namespace:</b> <a href="N_log4net_Appender.htm" target="">log4net.Appender</a><br /><b>Assembly:</b> <span sdata="assembly">log4net</span> (in log4net.dll) Version: 1.2.15.0 (1.2.15.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 id="snippetGroup_Syntax" class="code"><div id="ID0ECDDAAAAA" class="OH_CodeSnippetContainer"><div class="OH_CodeSnippetContainerTabs" id="ID0ECDDAAAAA_tabs"><div class="OH_CodeSnippetContainerTabLeftActive" id="ID0ECDDAAAAA_tabimgleft"></div><div id="ID0ECDDAAAAA_tab1" class="OH_CodeSnippetContainerTabActive" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECDDAAAAA','C#','1','4');return false;">C#</a></div><div id="ID0ECDDAAAAA_tab2" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECDDAAAAA','Visual Basic','2','4');return false;">VB</a></div><div id="ID0ECDDAAAAA_tab3" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECDDAAAAA','Visual C++','3','4');return false;">C++</a></div><div id="ID0ECDDAAAAA_tab4" class="OH_CodeSnippetContainerTabDisabledNotFirst" EnableCopyCode="true" disabled="true"><a>F#</a></div><div class="OH_CodeSnippetContainerTabRight" id="ID0ECDDAAAAA_tabimgright"></div></div><div id="ID0ECDDAAAAA_codecollection" class="OH_CodeSnippetContainerCodeCollection"><div class="OH_CodeSnippetToolBar"><div class="OH_CodeSnippetToolBarText"><a id="ID0ECDDAAAAA_ViewColorized" href="#" onclick="javascript:ExchangeTitleContent('ID0ECDDAAAAA','4')" title="View Colorized" style="display: none">View Colorized</a><a id="ID0ECDDAAAAA_copycode" href="#" onclick="javascript:CopyToClipboard('ID0ECDDAAAAA','4')" title="Copy to Clipboard">Copy to Clipboard</a><a id="ID0ECDDAAAAA_PrintText" class="OH_PrintText" href="#" onclick="javascript:Print('ID0ECDDAAAAA','4')" title="Print">Print</a></div></div><div id="ID0ECDDAAAAA_code_Div1" class="OH_CodeSnippetContainerCode" style="display: block"><pre><span class="keyword">public</span> <span class="identifier">bool</span> <span class="identifier">ImmediateFlush</span> { <span class="keyword">get</span>; <span class="keyword">set</span>; }</pre></div><div id="ID0ECDDAAAAA_code_Plain_Div1" class="OH_CodeSnippetContainerCode" style="display: none"><pre>public bool ImmediateFlush { get; set; }</pre></div><div id="ID0ECDDAAAAA_code_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre><span class="keyword">Public</span> <span class="keyword">Property</span> <span class="identifier">ImmediateFlush</span> <span class="keyword">As</span> <span class="identifier">Boolean</span> 
<span class="keyword">Get</span> 
<span class="keyword">Set</span></pre></div><div id="ID0ECDDAAAAA_code_Plain_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre>Public Property ImmediateFlush As Boolean 
Get 
Set</pre></div><div id="ID0ECDDAAAAA_code_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre><span class="keyword">public</span>:
<span class="keyword">property</span> <span class="identifier">bool</span> <span class="identifier">ImmediateFlush</span> {
<span class="identifier">bool</span> <span class="keyword">get</span> ();
<span class="keyword">void</span> <span class="keyword">set</span> (<span class="identifier">bool</span> <span class="parameter">value</span>);
}</pre></div><div id="ID0ECDDAAAAA_code_Plain_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre>public:
property bool ImmediateFlush {
bool get ();
void set (bool value);
}</pre></div><div id="ID0ECDDAAAAA_code_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre /></div><div id="ID0ECDDAAAAA_code_Plain_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre /></div></div></div><script>addSpecificTextLanguageTagSet('ID0ECDDAAAAA');</script></div><h4 class="subHeading">Property Value</h4>Type: <img src="./../icons/online_icon.gif" class="OH_offlineIcon" alt="Online" title="Online" /><a href="http://msdn2.microsoft.com/en-us/library/a28wyd50" target="_blank">Boolean</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 default behavior is to flush at the end of each
write. If the option is set to<span class="code">false</span>, then the underlying
stream can defer writing to physical medium to a later time.
</p><p>
Avoiding the flush operation at the end of each append results
in a performance gain of 10 to 20 percent. However, there is safety
trade-off involved in skipping flushing. Indeed, when flushing is
skipped, then it is likely that the last few log events will not
be recorded on disk when the application exits. This is a high
price to pay even for a 20% performance gain.
</p><a name="seeAlsoSection"><!----></a><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">See Also</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"></div><div class="seeAlsoStyle"><a href="T_log4net_Appender_TraceAppender.htm" target="">TraceAppender Class</a></div><div class="seeAlsoStyle"><a href="AllMembers_T_log4net_Appender_TraceAppender.htm" target="">TraceAppender Members</a></div><div class="seeAlsoStyle"><a href="N_log4net_Appender.htm" target="">log4net.Appender Namespace</a></div></div></div></div></div><div id="OH_footer" class="OH_footer"><p>Apache log4net, Apache and log4net are trademarks of The Apache Software Foundation.</p><p><a href="http://logging.apache.org/log4net/" target="_blank"><img src="./../icons/online_icon.gif" class="OH_offlineIcon" alt="Online" title="Online" /> 
Copyright 2004-2015 The Apache Software Foundation (http://logging.apache.org/log4net/)</a></p><div class="OH_feedbacklink"><a href="mailto:http://logging.apache.org/log4net/mail-lists.html?subject=Apache+log4net%e2%84%a2+SDK+Documentation+TraceAppender.ImmediateFlush+Property++100+EN-US&amp;body=Your%20feedback%20is%20used%20to%20improve%20the%20documentation%20and%20the%20product.%20Your%20e-mail%20address%20will%20not%20be%20used%20for%20any%20other%20purpose%20and%20is%20disposed%20of%20after%20the%20issue%20you%20report%20is%20resolved.%20While%20working%20to%20resolve%20the%20issue%20that%20you%20report%2c%20you%20may%20be%20contacted%20via%20e-mail%20to%20get%20further%20details%20or%20clarification%20on%20the%20feedback%20you%20sent.%20After%20the%20issue%20you%20report%20has%20been%20addressed%2c%20you%20may%20receive%20an%20e-mail%20to%20let%20you%20know%20that%20your%20feedback%20has%20been%20addressed.">Send Feedback</a> on this topic to http://logging.apache.org/log4net/mail-lists.html.</div></div></body></html>