blob: 126ba90b381f361561c2429249d8238796896886 [file] [log] [blame]
<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>RemotingAppender.SendBuffer Method </title><meta name="Language" content="en-us" /><meta name="System.Keywords" content="SendBuffer method" /><meta name="System.Keywords" content="RemotingAppender.SendBuffer method" /><meta name="Microsoft.Help.F1" content="log4net.Appender.RemotingAppender.SendBuffer" /><meta name="Microsoft.Help.Id" content="M:log4net.Appender.RemotingAppender.SendBuffer(log4net.Core.LoggingEvent[])" /><meta name="Description" content="Send the contents of the buffer to the remote sink." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="true" /><meta name="container" content="log4net.Appender" /><meta name="file" content="M_log4net_Appender_RemotingAppender_SendBuffer" /><meta name="guid" content="M_log4net_Appender_RemotingAppender_SendBuffer" /></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">RemotingAppender<span id="LST2FA0C3F7_0"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST2FA0C3F7_0?cpp=::|nu=.");</script>SendBuffer Method </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">
Send the contents of the buffer to the remote sink.
</div><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">protected</span> <span class="keyword">override</span> <span class="keyword">void</span> <span class="identifier">SendBuffer</span>(
<span class="identifier">LoggingEvent</span>[] <span class="parameter">events</span>
)</pre></div><div id="ID0EDCA_code_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">Protected</span> <span class="keyword">Overrides</span> <span class="keyword">Sub</span> <span class="identifier">SendBuffer</span> (
<span class="parameter">events</span> <span class="keyword">As</span> <span class="identifier">LoggingEvent</span>()
)</pre></div><div id="ID0EDCA_code_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">protected</span>:
<span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">SendBuffer</span>(
<span class="keyword">array</span>&lt;<span class="identifier">LoggingEvent</span>^&gt;^ <span class="parameter">events</span>
) <span class="keyword">override</span></pre></div><div id="ID0EDCA_code_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">abstract</span> <span class="identifier">SendBuffer</span> :
<span class="parameter">events</span> : <span class="identifier">LoggingEvent</span>[] <span class="keyword">-&gt;</span> <span class="keyword">unit</span>
<span class="keyword">override</span> <span class="identifier">SendBuffer</span> :
<span class="parameter">events</span> : <span class="identifier">LoggingEvent</span>[] <span class="keyword">-&gt;</span> <span class="keyword">unit</span> </pre></div></div></div><script type="text/javascript">AddLanguageTabSet("ID0EDCA");</script><h4 class="subHeading">Parameters</h4><dl><dt><span class="parameter">events</span></dt><dd>Type: <span id="LST2FA0C3F7_1"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST2FA0C3F7_1?cpp=array&lt;");</script><a href="T_log4net_Core_LoggingEvent.htm">log4net.Core<span id="LST2FA0C3F7_2"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST2FA0C3F7_2?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>LoggingEvent</a><span id="LST2FA0C3F7_3"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST2FA0C3F7_3?cpp=&gt;|vb=()|nu=[]");</script><br />The events to send.</dd></dl><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>
The events are not sent immediately. They are scheduled to be sent
using a pool thread. The effect is that the send occurs asynchronously.
This is very important for a number of non obvious reasons. The remoting
infrastructure will flow thread local variables (stored in the <a href="http://msdn2.microsoft.com/en-us/library/c9tkcy8b" target="_blank">CallContext</a>),
if they are marked as <a href="http://msdn2.microsoft.com/en-us/library/39fsck47" target="_blank">ILogicalThreadAffinative</a>, across the
remoting boundary. If the server is not contactable then
the remoting infrastructure will clear the <a href="http://msdn2.microsoft.com/en-us/library/39fsck47" target="_blank">ILogicalThreadAffinative</a>
objects from the <a href="http://msdn2.microsoft.com/en-us/library/c9tkcy8b" target="_blank">CallContext</a>. To prevent a logging failure from
having side effects on the calling application the remoting call must be made
from a separate thread to the one used by the application. A <a href="http://msdn2.microsoft.com/en-us/library/y5htx827" target="_blank">ThreadPool</a>
thread is used for this. If no <a href="http://msdn2.microsoft.com/en-us/library/y5htx827" target="_blank">ThreadPool</a> thread is available then
the events will block in the thread pool manager until a thread is available.
<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="T_log4net_Appender_RemotingAppender.htm">RemotingAppender Class</a></div><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-2016 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>