{"id":1673,"date":"2009-09-03T21:09:00","date_gmt":"2009-09-03T21:09:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/odatateam\/2009\/09\/03\/using-the-ado-net-data-services-silverlight-client-in-x-domain-and-out-of-browser-scenarios-i\/"},"modified":"2018-09-04T18:02:42","modified_gmt":"2018-09-04T18:02:42","slug":"using-the-ado-net-data-services-silverlight-client-in-x-domain-and-out-of-browser-scenarios-i","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/odata\/using-the-ado-net-data-services-silverlight-client-in-x-domain-and-out-of-browser-scenarios-i\/","title":{"rendered":"Using the ADO.NET Data Services Silverlight client in x-domain and out of browser scenarios \u2013 I"},"content":{"rendered":"

With the release of ADO.NET Data Services v1.5 CTP2<\/a>, you can now use the Silverlight Astoria client library to access Cross-Domain services
and applications written with the new client library can go out of browser. <\/p>\n

The new Client Http networking stack introduced in SL3 supports the standard and custom HTTP Verbs(GET\/PUT\/POST\/DELETE\/MERGE)
as well as access to the response status codes required for a full fidelity REST-based client experience in Silverlight.
Working with the SL networking team, we modified the Astoria client library to use the networking stack
in cross-domain and out-of-browser scenarios.
With this change, we are now able to support Cross-Domain calls allowed by ClientAccessPolicy.xml<\/a> files
and applications written with the Silverlight Astoria client library can go Out Of Browser. <\/p>\n

I have an existing SL app based on the Astoria client library , what do I need to do to enable my application to
access X-Domain Data Services and go Out Of Browser ?<\/h5>\n

1. Recompile your application with a reference to the new Silverlight client library .
2. Update the URI of the Data Service to point to the absolute URI of the Data Service in its new location.
3. Drop a ClientAccessPolicy.xml<\/a> file into the root of the Webserver Hosting your Data Service.
4. Deploy the newly created application to the Webserver.
5. In your Silverlight application code, find all the places that you call EndExecute\/EndSaveChanges\/EndExecuteBatch
and check if the call is being marshaled back to the UI thread , else Silverlight will throw an invalid Cross-Thread Access Exception.
To fix this, always dispatch the call to EndExecute to the UI thread using Dispatcher.BeginInvoke.
As an example: <\/p>\n

nwContext.BeginExecute<Customers>(new<\/span> Uri("Customers"<\/span>),\n(asResult) =>\n{\n Dispatcher.BeginInvoke(\n   () =>{\n   CustomersGrid.ItemsSource = nwContext.EndExecute<Customers>(asResult).ToList();\n   }\n   );                     \n}, someUserState);<\/pre>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
Now , let\u2019s walk through a demo application that illustrates how to build a Silverlight application \n  
that accesses an ADO.NET Data Service from a different domain than the Silverlight application and can also run Out-Of-Browser.<\/p>\n
We have a sample Silverlight application that looks like this :<\/p>\n
Now , let\u2019s walk through a demo application that illustrates how to build a Silverlight application \n  
that accesses an ADO.NET Data Service from a different domain than the Silverlight application and can also run Out-Of-Browser.<\/p>\n
We have a sample Silverlight application that looks like this :<\/p>\n
\"clip_image002\"<\/a><\/p>\n
1. SilverlightApplicationHost is the Web application hosting your Silverlight XAP , think of this as UI.Foo.Com. \n  
2. DataServiceHost is the web application hosting the ADO.NET Data Service , think of this as API.Foo.Com <\/p>\n
3. DataServicesXDomainSLClient is the Silverlight application that runs in UI.Foo.Com and consumes the Data Service from API.Foo.Com.<\/p>\n
Since the DataServiceHost site hosts the Data Service, it also hosts the ClientAccessPolicy.xml file which allows apps from the \n  
domain hosting the Silverlight app to access resources hosted at API.Foo.com<\/p>\n
\"clip_image002[8]\"<\/a><\/p>\n
The Silverlight application, DataServicesXDomainSLClient, has a Service Reference to the Data Service hosted at DataServiceHost. \n  
It has two buttons which download an Entity Set called \u201cPublications\u201d from the Data Service and looks like this.<\/p>\n
\"clip_image001\"<\/a><\/p>\n
The \u201cLoad Publications Via Uri\u201d downloads Entities from the \u201cPublications\u201d entity set and the Click handler looks like this : <\/p>\n
void<\/span> btnLoadPublications_Click(object<\/span> sender, RoutedEventArgs e)\n{\nobject<\/span> userState = null<\/span>;\n\/\/download the Publications and sort the Publications in descending order of Name<\/span>\npublicationContext.BeginExecute<Publication>(\n  new<\/span> Uri("\/Publications?$expand=PublishedFrom&$orderby= Name desc"<\/span>, UriKind.Relative),\n(asResult) =>\n  {\n  \/\/Dispatch the EndExecute call to the UI thread<\/span>\n  Dispatcher.BeginInvoke(\n   () =>\n   {\n     var IEnumerableOfPublications = publicationContext.EndExecute<Publication>(asResult);\n     PublicationsGrid.ItemsSource = IEnumerableOfPublications.ToList();\n   }\n   );\n   }, userState);\n}<\/pre>\n
The \u201cLoad Publications Via Linq\u201d downloads entities via a Linq Query and the Click Handler looks like this : <\/p>\n
void<\/span> btnLoadPublicationsLinq_Click(object<\/span> sender, RoutedEventArgs e)\n{\n object<\/span> userState = null<\/span>;\n \/\/download the Publications and sort the Publications in ascending order of Name<\/span>\n var publicationLinqQuery = (from pub in<\/span> 
                       publicationContext.CreateQuery<Publication>("Publications"<\/span>)
                                                .Expand("PublishedFrom"<\/span>)\n                            orderby pub.Name ascending\n                            select pub) as<\/span> DataServiceQuery<Publication>;\npublicationLinqQuery.BeginExecute(\n (asResult) =>\n {\n  \/\/Dispatch the EndExecute call to the UI thread<\/span>\n    Dispatcher.BeginInvoke(\n     () =>\n     {\n      var IEnumerableOfPublications = publicationLinqQuery.EndExecute(asResult);\n      PublicationsGrid.ItemsSource =  IEnumerableOfPublications.ToList();\n      });\n      }, userState);\n  }<\/pre>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
Clicking the \u201cInstall Me\u201d button installs the app and launches it Out Of Browser. \n  
Here is what the \u201cInstall Me\u201d button click handler looks like : <\/p>\n
<\/p>\n
\/\/\/ <summary><\/span>\n\/\/\/ Installs the Silverlight application as an Out Of Browser application<\/span>\n\/\/\/ <\/summary><\/span>\nvoid<\/span> InstallApplication(object<\/span> sender, RoutedEventArgs e)\n{\n  \/\/Install the app<\/span>\n  App.Current.Install();\n  \/\/Hide the "Install Me" button<\/span>\n  btnInstallOOBApp.Visibility = Visibility.Collapsed;\n }<\/pre>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
.csharpcode, .csharpcode pre\n{\n\tfont-size: small;\n\tcolor: black;\n\tfont-family: consolas, “Courier New”, courier, monospace;\n\tbackground-color: #ffffff;\n\t\/*white-space: pre;*\/\n}\n.csharpcode pre { margin: 0em; }\n.csharpcode .rem { color: #008000; }\n.csharpcode .kwrd { color: #0000ff; }\n.csharpcode .str { color: #006080; }\n.csharpcode .op { color: #0000c0; }\n.csharpcode .preproc { color: #cc6633; }\n.csharpcode .asp { background-color: #ffff00; }\n.csharpcode .html { color: #800000; }\n.csharpcode .attr { color: #ff0000; }\n.csharpcode .alt \n{\n\tbackground-color: #f4f4f4;\n\twidth: 100%;\n\tmargin: 0em;\n}\n.csharpcode .lnum { color: #606060; }<\/p>\n
The buttons which do a Linq Query and a URI query still work , without any changes to the code . \n  
\"clip_image001[8]\"<\/a><\/p>\n
Debugging Out Of Browser Silverlight Applications<\/h4>\n
To debug your Out Of Browser Silverlight apps , follow these steps.<\/p>\n
1.  Open the properties of the Silverlight application.<\/p>\n
\"clip_image002[10]\"<\/a><\/p>\n
2. Select the Out Of Browser application which has the name of the project with the Page hosting the SL application. \n  
Which , in this case , is SilverlightApplicationHost.<\/p>\n
\"clip_image002[12]\"<\/a><\/p>\n
3. Hit F5 and select yes when this prompt comes up. \n  
This prompt is warning you that you have a Service Reference to a Data Service. <\/p>\n
In In-Browser Silverlight apps , running the SL app directly will launch it off of the file system ( i.e c:ProjectsyourProjectPath), <\/p>\n
and you wont be able to make calls to data services  as this would constitute a Cross-Scheme request and isn\u2019t allowed.<\/p>\n
While debugging your Out Of Browser Silverlight application, you can ignore this prompt.<\/p>\n
\"clip_image004\"<\/a><\/p>\n
<\/h4>\n
Is the SL3 Client HTTP stack used by the ADO.NET Data Services v1.5 CTP2 client library for all requests?<\/h5>\n
No, the SL3 Client Http Stack is only used for Out-Of-Browser and Cross-domain network access. \n  
The XmlHttp based stack is still used for In Browser, Same Domain network access to preserve backward compatibility. <\/p>\n
You can customize this by setting a new property on the client library called HttpStack. <\/p>\n
HttpStack which has 3 possible values: <\/p>\n
1. <\/b>Auto: <\/b>Client library decides when to switch networking stacks. <\/p>\n
2. <\/b>XmlHttp: <\/b>The classic networking stack based on XmlHttpRequest <\/p>\n
3. <\/b>ClientHttp: <\/b>The new SL3 Client HTTP  stack <\/p>\n
The Default value is Auto, and you should leave it as it is, unless you need to customize the networking stack we use. \n  
When the HttpStack is set to Auto, the client library automatically switches the networking stack it uses to talk to <\/p>\n
the Data Service. <\/p>\n
Should I set the HttpStack on the DataServiceContext instance so that I get X-Domain and OOB data access?<\/h5>\n
Nope, you can just leave the HttpStack property at Auto and we will figure out which stack to use and when. <\/p>\n
We use XmlHttp only in a scenario where the Silverlight XAP and the Data Service are hosted in the same domain. <\/p>\n
For other scenarios we use the ClientHttpStack. The below table is helpful in understanding when we automatically switch stacks. <\/p>\n
 <\/p>\n\n\n\n\n\n\n
\n
Silverlight App<\/b><\/p>\n<\/td>\n
\n
Data Service<\/b><\/p>\n<\/td>\n
\n
Out Of Browser<\/i><\/b><\/p>\n<\/td>\n
\n
Networking stack<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
http:\/\/foo.com<\/a><\/b><\/b><\/p>\n<\/td>\n
\n
http:\/\/foo.com<\/a><\/p>\n<\/td>\n
\n
False<\/i><\/p>\n<\/td>\n
\n
XmlHttp                     <\/p>\n<\/td>\n<\/tr>\n
\n
http:\/\/foo.com<\/a><\/b><\/b><\/p>\n<\/td>\n
\n
http:\/\/foo.com<\/a><\/p>\n<\/td>\n
\n
True<\/i><\/p>\n<\/td>\n
\n
ClientHttp<\/p>\n<\/td>\n<\/tr>\n
\n
http:\/\/UI.foo.com<\/a><\/b><\/b><\/p>\n<\/td>\n
\n
http:\/\/API.foo.com<\/a><\/p>\n<\/td>\n
\n
False\/True<\/i><\/p>\n<\/td>\n
\n
ClientHttp<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Features VS Networking Stack <\/b><\/p>\n
<\/strong><\/p>\n\n\n\n\n\n\n\n\n\n
\n
Feature<\/b><\/p>\n<\/td>\n
\n
XmlHttp<\/b><\/p>\n<\/td>\n
\n
ClientHttp<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Cross Domain Data Access<\/p>\n<\/td>\n
\n
No<\/b><\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Out Of Browser Data Access<\/p>\n<\/td>\n
\n
No<\/b><\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
NTLM Based Authentication<\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n
\n
No<\/b>*<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Same Domain Data Access<\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Cookie Based Authentication<\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Cookie store shared with browser<\/p>\n<\/td>\n
\n
Yes<\/b><\/p>\n<\/td>\n
\n
No<\/b>*<\/b><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
*We are working over the next few releases of Silverlight to extend the ClientHttp stack such that it supports \n  
all possible scenarios.<\/p>\n
Authentication Schemes supported<\/h4>\n
With the new networking stack, in X-Domain and OOB scenarios, the client library is now restricted to the same options as any other application that uses the SL3 networking stack. \n  
The main concern is that NTLM based authentication schemes such as Windows Authentication or BASIC Authentication are not supported in X-Domain and Out Of Browser scenarios<\/i><\/b>. <\/p>\n
The only authentication schemes that are supported are cookie-based authentication schemes such as ASP.NET Forms Authentication. <\/p>\n
An example of using the new client library with ASP.NET Forms Authentication will be shown in Part II of this blog post.<\/p>\n
You can download the sample application shown here at the bottom of the post.<\/p>\n
Phani Raj \n  
Engineer, ADO.NET Data Services .<\/p>\n","protected":false},"excerpt":{"rendered":"
With the release of ADO.NET Data Services v1.5 CTP2, you can now use the Silverlight Astoria client library to access Cross-Domain services and applications written with the new client library can go out of browser. The new Client Http networking stack introduced in SL3 supports the standard and custom HTTP Verbs(GET\/PUT\/POST\/DELETE\/MERGE) as well as access […]<\/p>\n","protected":false},"author":512,"featured_media":3253,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1673","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-odata"],"acf":[],"blog_post_summary":"
With the release of ADO.NET Data Services v1.5 CTP2, you can now use the Silverlight Astoria client library to access Cross-Domain services and applications written with the new client library can go out of browser. The new Client Http networking stack introduced in SL3 supports the standard and custom HTTP Verbs(GET\/PUT\/POST\/DELETE\/MERGE) as well as access […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts\/1673","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/users\/512"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/comments?post=1673"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts\/1673\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/media\/3253"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/media?parent=1673"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/categories?post=1673"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/tags?post=1673"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}