<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>IUsersInRoleService2.EnqueueNewOrUpdateEntities Method </title><meta name="Language" content="en-us" /><meta name="System.Keywords" content="EnqueueNewOrUpdateEntities method" /><meta name="System.Keywords" content="IUsersInRoleService2.EnqueueNewOrUpdateEntities method" /><meta name="Microsoft.Help.F1" content="CryptoGateway.RDB.Data.AspNetMember.IUsersInRoleService2.EnqueueNewOrUpdateEntities" /><meta name="Microsoft.Help.Id" content="M:CryptoGateway.RDB.Data.AspNetMember.IUsersInRoleService2.EnqueueNewOrUpdateEntities(CryptoGateway.RDB.Data.AspNetMember.CallContext,CryptoGateway.RDB.Data.AspNetMember.UsersInRoleSet,CryptoGateway.RDB.Data.AspNetMember.UsersInRole[])" /><meta name="Description" content="Queue a set of entities to be added or updated to the entity set in a certain preset future time." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="'true'" /><meta name="container" content="CryptoGateway.RDB.Data.AspNetMember" /><meta name="file" content="1403c6ea-9818-aee3-7181-6c54726dd3e8" /><meta name="guid" content="1403c6ea-9818-aee3-7181-6c54726dd3e8" /><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">IUsersInRoleService2<span id="ID0EBBABAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBBABAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>EnqueueNewOrUpdateEntities Method </td><td class="OH_tdRunningTitleColumn">Service Proxy API for Membership data sources</td></tr></table><div id="mainSection"><div id="mainBody"><span class="introStyle"></span><p style="color: #dc143c; font-size: 8.5pt; font-weight: bold;">[This is preliminary documentation and is subject to change.]</p><div class="summary">
Queue a set of entities to be added or updated to the entity set in a certain preset future time.
</div><p></p><b>Namespace:</b> <a href="9b9992ae-86cf-af3e-5eb6-8fad208413c4.htm" target="">CryptoGateway.RDB.Data.AspNetMember</a><br /><b>Assembly:</b> <span sdata="assembly">AspNetMemberShared</span> (in AspNetMemberShared.dll) Version: 0.0.0.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="ID0EDEDAAAAA" class="OH_CodeSnippetContainer"><div class="OH_CodeSnippetContainerTabs" id="ID0EDEDAAAAA_tabs"><div class="OH_CodeSnippetContainerTabLeftActive" id="ID0EDEDAAAAA_tabimgleft"></div><div id="ID0EDEDAAAAA_tab1" class="OH_CodeSnippetContainerTabActive" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0EDEDAAAAA','C#','1','4');return false;">C#</a></div><div id="ID0EDEDAAAAA_tab2" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0EDEDAAAAA','Visual Basic','2','4');return false;">VB</a></div><div id="ID0EDEDAAAAA_tab3" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0EDEDAAAAA','Visual C++','3','4');return false;">C++</a></div><div id="ID0EDEDAAAAA_tab4" class="OH_CodeSnippetContainerTab" EnableCopyCode="true"><a href="#" onclick="javascript:ChangeTab('ID0EDEDAAAAA','F#','4','4');return false;">F#</a></div><div class="OH_CodeSnippetContainerTabRight" id="ID0EDEDAAAAA_tabimgright"></div></div><div id="ID0EDEDAAAAA_codecollection" class="OH_CodeSnippetContainerCodeCollection"><div class="OH_CodeSnippetToolBar"><div class="OH_CodeSnippetToolBarText"><a id="ID0EDEDAAAAA_ViewColorized" href="#" onclick="javascript:ExchangeTitleContent('ID0EDEDAAAAA','4')" title="View Colorized" style="display: none">View Colorized</a><a id="ID0EDEDAAAAA_copycode" href="#" onclick="javascript:CopyToClipboard('ID0EDEDAAAAA','4')" title="Copy to Clipboard">Copy to Clipboard</a><a id="ID0EDEDAAAAA_PrintText" class="OH_PrintText" href="#" onclick="javascript:Print('ID0EDEDAAAAA','4')" title="Print">Print</a></div></div><div id="ID0EDEDAAAAA_code_Div1" class="OH_CodeSnippetContainerCode" style="display: block"><pre>[<span class="identifier">OperationContractAttribute</span>]
<span class="keyword">void</span> <span class="identifier">EnqueueNewOrUpdateEntities</span>(
<span class="identifier">CallContext</span> <span class="parameter">cntx</span>,
<span class="identifier">UsersInRoleSet</span> <span class="parameter">set</span>,
<span class="identifier">UsersInRole</span>[] <span class="parameter">entities</span>
)</pre></div><div id="ID0EDEDAAAAA_code_Plain_Div1" class="OH_CodeSnippetContainerCode" style="display: none"><pre>[OperationContractAttribute]
void EnqueueNewOrUpdateEntities(
CallContext cntx,
UsersInRoleSet set,
UsersInRole[] entities
)</pre></div><div id="ID0EDEDAAAAA_code_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre><<span class="identifier">OperationContractAttribute</span>>
<span class="keyword">Sub</span> <span class="identifier">EnqueueNewOrUpdateEntities</span> (
<span class="parameter">cntx</span> <span class="keyword">As</span> <span class="identifier">CallContext</span>,
<span class="parameter">set</span> <span class="keyword">As</span> <span class="identifier">UsersInRoleSet</span>,
<span class="parameter">entities</span> <span class="keyword">As</span> <span class="identifier">UsersInRole</span>()
)</pre></div><div id="ID0EDEDAAAAA_code_Plain_Div2" class="OH_CodeSnippetContainerCode" style="display: none"><pre><OperationContractAttribute>
Sub EnqueueNewOrUpdateEntities (
cntx As CallContext,
set As UsersInRoleSet,
entities As UsersInRole()
)</pre></div><div id="ID0EDEDAAAAA_code_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre>[<span class="identifier">OperationContractAttribute</span>]
<span class="keyword">void</span> <span class="identifier">EnqueueNewOrUpdateEntities</span>(
<span class="identifier">CallContext</span>^ <span class="parameter">cntx</span>,
<span class="identifier">UsersInRoleSet</span>^ <span class="parameter">set</span>,
<span class="keyword">array</span><<span class="identifier">UsersInRole</span>^>^ <span class="parameter">entities</span>
)</pre></div><div id="ID0EDEDAAAAA_code_Plain_Div3" class="OH_CodeSnippetContainerCode" style="display: none"><pre>[OperationContractAttribute]
void EnqueueNewOrUpdateEntities(
CallContext^ cntx,
UsersInRoleSet^ set,
array<UsersInRole^>^ entities
)</pre></div><div id="ID0EDEDAAAAA_code_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre>[<<span class="identifier">OperationContractAttribute</span>>]
<span class="keyword">abstract</span> <span class="identifier">EnqueueNewOrUpdateEntities</span> :
<span class="parameter">cntx</span> : <span class="identifier">CallContext</span> *
<span class="parameter">set</span> : <span class="identifier">UsersInRoleSet</span> *
<span class="parameter">entities</span> : <span class="identifier">UsersInRole</span>[] <span class="keyword">-></span> <span class="keyword">unit</span></pre></div><div id="ID0EDEDAAAAA_code_Plain_Div4" class="OH_CodeSnippetContainerCode" style="display: none"><pre>[<OperationContractAttribute>]
abstract EnqueueNewOrUpdateEntities :
cntx : CallContext *
set : UsersInRoleSet *
entities : UsersInRole[] -> unit</pre></div></div></div><script>addSpecificTextLanguageTagSet('ID0EDEDAAAAA');</script></div><div id="parameters"><h4 class="subHeading">Parameters</h4><dl paramName="cntx"><dt><span class="parameter">cntx</span></dt><dd>Type: <a href="1a3658b6-b213-9ff6-572e-f77262c032c5.htm" target="">CryptoGateway.RDB.Data.AspNetMember<span id="ID0EBCACDDAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBCACDDAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>CallContext</a><br /><span>Authenticated caller context object. If cannot be null.</span></dd></dl><dl paramName="set"><dt><span class="parameter">set</span></dt><dd>Type: <a href="8d6a36f9-3d5c-85ed-b7b1-4606701ac0db.htm" target="">CryptoGateway.RDB.Data.AspNetMember<span id="ID0EBCABDDAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBCABDDAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>UsersInRoleSet</a><br /><span>The current entity set.</span></dd></dl><dl paramName="entities"><dt><span class="parameter">entities</span></dt><dd>Type: <span id="ID0EEAADDAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EEAADDAAAAA?vb=|cpp=array<|cs=|fs=|nu=");
</script><a href="52602626-b655-6583-a7c5-2ece984837e7.htm" target="">CryptoGateway.RDB.Data.AspNetMember<span id="ID0EBDAADDAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0EBDAADDAAAAA?vb=.|cpp=::|cs=.|fs=.|nu=.");
</script>UsersInRole</a><span id="ID0ECAADDAAAAA"> </span><script type="text/javascript">
addToLanSpecTextIdSet("ID0ECAADDAAAAA?vb=()|cpp=>|cs=[]|fs=[]|nu=[]");
</script><br /><span>The list of entities to be processed.</span></dd></dl></div><h4 class="subHeading">Return Value</h4>Type: <br /><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 processing will be delayed to be started at a certain future time. If there are any further calls to this method during the wait period, the new sets will be
merged with existing ones inside the queue. This method is useful when there are repetitive updates to the entity set but the actual change history is not of
interest to the client, namely only the last snapshot of the changes are relevent. In this case, the method can reduce the loads on the backend data source
significantly.
</p><p>
The list of entities will be checked against existing ones inside the entity set when the processing starts. An entity is identified by a set of "intrinsic identitfiers" selected
when the system is generated. They are not necessarily the same as primary keys of the set. An auto generated primary key can not be
used as an "intrinsic identitfier". An entity having the same set of "intrinsic identitfiers" can not be added to the database. They will be treated
as an entity update if the client load the entity first before modifying it, otherwise (namely if the client created the entity on the client side),
the update will be rejected unless the client set the <span class="code">OverrideExisting</span> property of "cntx" to <span class="code">true</span>.
</p><p>
Note: entities having no "intrinsic identitfier" will always be treated as different entities in add or update operations, namely they will always be added to the set.
</p><p>
Note 2: A persisted entity (namely the one loaded
from the data set) will be ignored in if none of its editable properties (set before system generation, see
<a href="52602626-b655-6583-a7c5-2ece984837e7.htm" target="">UsersInRole</a>) is modified or its <a href="4b1d9607-1949-2751-84a8-5b52b35f640d.htm" target="">IsEntityChanged</a> property is
not set to <span class="code">true</span>.
</p><p>
Warning: Please do not use this method when new entities are to be added and information about these updated enitities, like auto generated primary keys, are needed for
proceeding to the next steps.
</p><p>
Clients can set some of the member entities in { <a href="be7f665e-4e3a-99b8-c1ef-c5a39c2b4e71.htm" target="">RoleRef</a>, <a href="abe53c7b-4444-ee34-aa93-3e62f00f93ea.htm" target="">UserRef</a> } that an currently added or updated entity depends upon. These additional entities will be
add or updated to the data source following the same logic, all the object relationships will be properly setup if the operation is successful.
</p><p>
In general, a client can construct an object graph of any complexity following the above rules and have it added or updated to the data source in one step.
</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="9b286d34-f3c2-3bcf-e49b-32333248a8d1.htm" target="">IUsersInRoleService2 Interface</a></div><div class="seeAlsoStyle"><a href="5b4c80cc-2105-0615-59f5-8dc93b71d0d7.htm" target="">IUsersInRoleService2 Members</a></div><div class="seeAlsoStyle"><a href="9b9992ae-86cf-af3e-5eb6-8fad208413c4.htm" target="">CryptoGateway.RDB.Data.AspNetMember Namespace</a></div></div></div></div></div><div id="OH_footer" class="OH_footer"><p /><div class="OH_feedbacklink"><a href="mailto:?subject=Service+Proxy+API+for+Membership+data+sources+IUsersInRoleService2.EnqueueNewOrUpdateEntities+Method++100+EN-US&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>