Dryad/html/ee049bec-6bfb-fb7f-3707-a41...

119 lines
20 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<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 { }.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" /><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>DryadLinqQueryable.HashPartition(TSource, TKey, TResult) Method (IQueryable(TSource), Expression(Func(TSource, TKey)), IEqualityComparer(TKey), Expression(Func(TSource, TResult)))</title><meta name="Language" content="en-us" /><meta name="Microsoft.Help.Id" content="M:Microsoft.Research.DryadLinq.DryadLinqQueryable.HashPartition``3(System.Linq.IQueryable{``0},System.Linq.Expressions.Expression{System.Func{``0,``1}},System.Collections.Generic.IEqualityComparer{``1},System.Linq.Expressions.Expression{System.Func{``0,``2}})" /><meta name="Description" content="Hash partition a dataset. The number of resulting partitions is dynamically determined at the runtime." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="'true'" /><meta name="container" content="Microsoft.Research.DryadLinq" /><meta name="file" content="ee049bec-6bfb-fb7f-3707-a411d85f477a" /><meta name="guid" content="ee049bec-6bfb-fb7f-3707-a411d85f477a" /><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">DryadLinqQueryable<span id="ID0E0DB0BABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0E0DB0BABAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>HashPartition<span id="ID0E0BB0BABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0E0BB0BABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="typeparameter">TSource</span>, <span class="typeparameter">TKey</span>, <span class="typeparameter">TResult</span><span id="ID0E2BABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0E2BABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script> Method (IQueryable<span id="ID0EZBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EZBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="typeparameter">TSource</span><span id="ID0EXBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EXBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script>, Expression<span id="ID0EVBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EVBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script>Func<span id="ID0ETBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ETBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="typeparameter">TSource</span>, <span class="typeparameter">TKey</span><span id="ID0EPBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EPBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><span id="ID0EOBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EOBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script>, IEqualityComparer<span id="ID0EMBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EMBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="typeparameter">TKey</span><span id="ID0EKBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EKBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script>, Expression<span id="ID0EIBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EIBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script>Func<span id="ID0EGBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EGBABAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="typeparameter">TSource</span>, <span class="typeparameter">TResult</span><span id="ID0ECBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><span id="ID0EBBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBBABAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script>)</td><td class="OH_tdRunningTitleColumn">DryadLINQ documentation</td></tr></table><div id="mainSection"><div id="mainBody"><span class="introStyle"></span><div class="summary">
Hash partition a dataset. The number of resulting partitions is dynamically determined
at the runtime.
</div><p></p><strong>Namespace:</strong> <a href="efe6507e-9fd8-bbd3-8227-fd6ba9e289c1.htm" target="">Microsoft.Research.DryadLinq</a><br /><strong>Assembly:</strong> <span sdata="assembly">Microsoft.Research.DryadLinq</span> (in Microsoft.Research.DryadLinq.dll) Version: 0.1.2.0 (0.1.2.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="ID0ECVCAAAAA" class="OH_CodeSnippetContainer"><div class="OH_CodeSnippetContainerTabs" id="ID0ECVCAAAAA_tabs"><div class="OH_CodeSnippetContainerTabLeftActive" id="ID0ECVCAAAAA_tabimgleft"></div><div id="ID0ECVCAAAAA_tab1" class="OH_CodeSnippetContainerTabActive" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECVCAAAAA','C#','1','4');return false;">C#</a></div><div id="ID0ECVCAAAAA_tab2" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECVCAAAAA','Visual Basic','2','4');return false;">VB</a></div><div id="ID0ECVCAAAAA_tab3" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0ECVCAAAAA','Visual C++','3','4');return false;">C++</a></div><div id="ID0ECVCAAAAA_tab4" class="OH_CodeSnippetContainerTabDisabledNotFirst" EnableCopyCode="true" disabled="true"><a>F#</a></div><div class="OH_CodeSnippetContainerTabRight" id="ID0ECVCAAAAA_tabimgright"></div></div><div id="ID0ECVCAAAAA_codecollection" class="OH_CodeSnippetContainerCodeCollection"><div class="OH_CodeSnippetToolBar"><div class="OH_CodeSnippetToolBarText"><a id="ID0ECVCAAAAA_ViewColorized" href="#" onclick="javascript:ExchangeTitleContent('ID0ECVCAAAAA','4')" title="View Colorized" style="display: none">View Colorized</a><a id="ID0ECVCAAAAA_copycode" href="#" onclick="javascript:CopyToClipboard('ID0ECVCAAAAA','4')" title="Copy to Clipboard">Copy to Clipboard</a><a id="ID0ECVCAAAAA_PrintText" class="OH_PrintText" href="#" onclick="javascript:Print('ID0ECVCAAAAA','4')" title="Print">Print</a></div></div><div id="ID0ECVCAAAAA_code_Div1" class="OH_CodeSnippetContainerCode" style="display: block"><pre><span class="keyword">public</span> <span class="keyword">static</span> <span class="identifier">IQueryable</span>&lt;TResult&gt; <span class="identifier">HashPartition</span>&lt;TSource, TKey, TResult&gt;(
<span class="keyword">this</span> <span class="identifier">IQueryable</span>&lt;TSource&gt; <span class="parameter">source</span>,
<span class="identifier">Expression</span>&lt;<span class="identifier">Func</span>&lt;TSource, TKey&gt;&gt; <span class="parameter">keySelector</span>,
<span class="identifier">IEqualityComparer</span>&lt;TKey&gt; <span class="parameter">comparer</span>,
<span class="identifier">Expression</span>&lt;<span class="identifier">Func</span>&lt;TSource, TResult&gt;&gt; <span class="parameter">resultSelector</span>
)</pre></div><div id="ID0ECVCAAAAA_code_Plain_Div1" class="OH_CodeSnippetContainerCode" style="display: none"><pre>public static IQueryable&lt;TResult&gt; HashPartition&lt;TSource, TKey, TResult&gt;(
this IQueryable&lt;TSource&gt; source,
Expression&lt;Func&lt;TSource, TKey&gt;&gt; keySelector,
IEqualityComparer&lt;TKey&gt; comparer,
Expression&lt;Func&lt;TSource, TResult&gt;&gt; resultSelector
)</pre></div><div id="ID0ECVCAAAAA_code_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre>&lt;<span class="identifier">ExtensionAttribute</span>&gt;
<span class="keyword">Public</span> <span class="keyword">Shared</span> <span class="keyword">Function</span> <span class="identifier">HashPartition</span>(<span class="keyword">Of</span> TSource, TKey, TResult) (
<span class="parameter">source</span> <span class="keyword">As</span> <span class="identifier">IQueryable</span>(<span class="keyword">Of</span> TSource),
<span class="parameter">keySelector</span> <span class="keyword">As</span> <span class="identifier">Expression</span>(<span class="keyword">Of</span> <span class="identifier">Func</span>(<span class="keyword">Of</span> TSource, TKey)),
<span class="parameter">comparer</span> <span class="keyword">As</span> <span class="identifier">IEqualityComparer</span>(<span class="keyword">Of</span> TKey),
<span class="parameter">resultSelector</span> <span class="keyword">As</span> <span class="identifier">Expression</span>(<span class="keyword">Of</span> <span class="identifier">Func</span>(<span class="keyword">Of</span> TSource, TResult))
) <span class="keyword">As</span> <span class="identifier">IQueryable</span>(<span class="keyword">Of</span> TResult)</pre></div><div id="ID0ECVCAAAAA_code_Plain_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre>&lt;ExtensionAttribute&gt;
Public Shared Function HashPartition(Of TSource, TKey, TResult) (
source As IQueryable(Of TSource),
keySelector As Expression(Of Func(Of TSource, TKey)),
comparer As IEqualityComparer(Of TKey),
resultSelector As Expression(Of Func(Of TSource, TResult))
) As IQueryable(Of TResult)</pre></div><div id="ID0ECVCAAAAA_code_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre><span class="keyword">public</span>:
[<span class="identifier">ExtensionAttribute</span>]
<span class="keyword">generic</span>&lt;<span class="keyword">typename</span> TSource, <span class="keyword">typename</span> TKey, <span class="keyword">typename</span> TResult&gt;
<span class="keyword">static</span> <span class="identifier">IQueryable</span>&lt;TResult&gt;^ <span class="identifier">HashPartition</span>(
<span class="identifier">IQueryable</span>&lt;TSource&gt;^ <span class="parameter">source</span>,
<span class="identifier">Expression</span>&lt;<span class="identifier">Func</span>&lt;TSource, TKey&gt;^&gt;^ <span class="parameter">keySelector</span>,
<span class="identifier">IEqualityComparer</span>&lt;TKey&gt;^ <span class="parameter">comparer</span>,
<span class="identifier">Expression</span>&lt;<span class="identifier">Func</span>&lt;TSource, TResult&gt;^&gt;^ <span class="parameter">resultSelector</span>
)</pre></div><div id="ID0ECVCAAAAA_code_Plain_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre>public:
[ExtensionAttribute]
generic&lt;typename TSource, typename TKey, typename TResult&gt;
static IQueryable&lt;TResult&gt;^ HashPartition(
IQueryable&lt;TSource&gt;^ source,
Expression&lt;Func&lt;TSource, TKey&gt;^&gt;^ keySelector,
IEqualityComparer&lt;TKey&gt;^ comparer,
Expression&lt;Func&lt;TSource, TResult&gt;^&gt;^ resultSelector
)</pre></div><div id="ID0ECVCAAAAA_code_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre /></div><div id="ID0ECVCAAAAA_code_Plain_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre /></div></div></div><script>addSpecificTextLanguageTagSet('ID0ECVCAAAAA');</script></div><div id="parameters"><h4 class="subHeading">Parameters</h4><dl paramName="source"><dt><span class="parameter">source</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/bb351562" target="_blank">System.Linq<span id="ID0EBFADUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBFADUCAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>IQueryable</a><span id="ID0EEADUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EEADUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TSource</span></span><span id="ID0ECADUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECADUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><br /><span>The dataset to be partitioned</span></dd></dl><dl paramName="keySelector"><dt><span class="parameter">keySelector</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/bb335710" target="_blank">System.Linq.Expressions<span id="ID0EBKACUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBKACUCAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>Expression</a><span id="ID0EJACUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EJACUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><a href="http://msdn2.microsoft.com/en-us/library/bb549151" target="_blank">Func</a><span id="ID0EHACUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EHACUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TSource</span></span>, <span class="selflink"><span class="typeparam">TKey</span></span><span id="ID0EDACUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EDACUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><span id="ID0ECACUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECACUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><br /><span>The function to extract the key from a record</span></dd></dl><dl paramName="comparer"><dt><span class="parameter">comparer</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/ms132151" target="_blank">System.Collections.Generic<span id="ID0EBFABUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBFABUCAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>IEqualityComparer</a><span id="ID0EEABUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EEABUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TKey</span></span><span id="ID0ECABUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECABUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><br /><span>An IComparer on TKey to compare keys</span></dd></dl><dl paramName="resultSelector"><dt><span class="parameter">resultSelector</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/bb335710" target="_blank">System.Linq.Expressions<span id="ID0EBKAAUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBKAAUCAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>Expression</a><span id="ID0EJAAUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EJAAUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><a href="http://msdn2.microsoft.com/en-us/library/bb549151" target="_blank">Func</a><span id="ID0EHAAUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EHAAUCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TSource</span></span>, <span class="selflink"><span class="typeparam">TResult</span></span><span id="ID0EDAAUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EDAAUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><span id="ID0ECAAUCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECAAUCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><br /><span>The function to compute output record</span></dd></dl></div><div class="OH_CollapsibleAreaRegion"><div class="OH_regiontitle">Type Parameters</div><div class="OH_CollapsibleArea_HrDiv"><hr class="OH_CollapsibleArea_Hr" /></div></div><div class="OH_clear"></div><dl><dt><span class="parameter">TSource</span></dt><dd>The type of the records in the dataset</dd><dt><span class="parameter">TKey</span></dt><dd>The type of the key on which the partition is based</dd><dt><span class="parameter">TResult</span></dt><dd>The type of the records in the result dataset</dd></dl><h4 class="subHeading">Return Value</h4>Type: <a href="http://msdn2.microsoft.com/en-us/library/bb351562" target="_blank">IQueryable</a><span id="ID0EPCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EPCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TResult</span></span><span id="ID0ENCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ENCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script><br />An IQueryable hash-partitioned according to a key<h4 class="subHeading">Usage Note</h4>In Visual Basic and C#, you can call this method as an instance method on any object of type <a href="http://msdn2.microsoft.com/en-us/library/bb351562" target="_blank">IQueryable</a><span id="ID0EHCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EHCAAAAA?vb=(Of |cpp=&lt;|cs=&lt;|fs=&lt;'|nu=(");
</script><span class="selflink"><span class="typeparam">TSource</span></span><span id="ID0EFCAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EFCAAAAA?vb=)|cpp=&gt;|cs=&gt;|fs=&gt;|nu=)");
</script>. When you use instance method syntax to call this method, omit the first parameter. For more information, see <a href="http://msdn.microsoft.com/en-us/library/bb384936.aspx" target="_blank">Extension Methods (Visual Basic)</a> or <a href="http://msdn.microsoft.com/en-us/library/bb383977.aspx" target="_blank">Extension Methods (C# Programming Guide)</a>.<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="6d67ec6b-96ed-0a8b-0ad4-1c0568c7bf91.htm" target="">DryadLinqQueryable Class</a></div><div class="seeAlsoStyle"><a href="1d3ec0f6-3549-a859-323d-eaa072b59745.htm" target="">HashPartition Overload</a></div><div class="seeAlsoStyle"><a href="efe6507e-9fd8-bbd3-8227-fd6ba9e289c1.htm" target="">Microsoft.Research.DryadLinq Namespace</a></div></div></div></div></div><div id="OH_footer" class="OH_footer"><p /><div class="OH_feedbacklink"><a href="mailto:?subject=DryadLINQ+documentation+DryadLinqQueryable.HashPartition(TSource%2c+TKey%2c+TResult)+Method+(IQueryable(TSource)%2c+Expression(Func(TSource%2c+TKey))%2c+IEqualityComparer(TKey)%2c+Expression(Func(TSource%2c+TResult)))+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.</div></div></body></html>