PageRenderTime 54ms CodeModel.GetById 13ms RepoModel.GetById 1ms app.codeStats 1ms

/TimeSheetReporting/TimeSheetReporting/Bin/Debug/System.Windows.Ria.xml

#
XML | 6328 lines | 6328 code | 0 blank | 0 comment | 0 complexity | b5147454a6904ebc83e140a51b601cbc MD5 | raw file

Large files files are truncated, but you can click here to view the full file

  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Windows.Ria</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Web.Ria.Data.CompositionAttribute">
  8. <summary>
  9. Attribute applied to an association member to indicate that the
  10. association is a compositional relationship.
  11. </summary>
  12. </member>
  13. <member name="T:System.Windows.Ria.ApplicationServices.AuthenticationEventArgs">
  14. <summary>
  15. Event args for events raised by the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/> class.
  16. </summary>
  17. </member>
  18. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationEventArgs.#ctor(System.Security.Principal.IPrincipal)">
  19. <summary>
  20. Initiailizes a new instance of the AuthenticationEventArgs class.
  21. </summary>
  22. <param name="user">The user at the time the event occurred</param>
  23. <exception cref="T:System.ArgumentNullException"> is thrown if <paramref name="user"/> is null.
  24. </exception>
  25. </member>
  26. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationEventArgs.User">
  27. <summary>
  28. Gets the user at the time the event occurred
  29. </summary>
  30. </member>
  31. <member name="T:System.Windows.Ria.ApplicationServices.AuthenticationOperation">
  32. <summary>
  33. Abstract subclass of the <see cref="T:System.Windows.Ria.OperationBase"/> class
  34. that is the base operation type for all the operations supported
  35. by <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/>.
  36. </summary>
  37. </member>
  38. <member name="T:System.Windows.Ria.OperationBase">
  39. <summary>
  40. Class representing an asynchronous operation.
  41. </summary>
  42. </member>
  43. <member name="M:System.Windows.Ria.OperationBase.#ctor(System.Delegate,System.Object)">
  44. <summary>
  45. Initializes a new instance of the <see cref="T:System.Windows.Ria.OperationBase"/> class.
  46. </summary>
  47. <param name="completeAction">Optional action to execute when the operation completes.
  48. The callback must be a delegate taking a single parameter that can accept an instance
  49. of the operation Type.</param>
  50. <param name="userState">Optional user state.</param>
  51. <exception cref="T:System.ArgumentException">is thrown if the <paramref name="completeAction"/> specified
  52. has an incorrect signature.</exception>
  53. </member>
  54. <member name="M:System.Windows.Ria.OperationBase.MarkErrorAsHandled">
  55. <summary>
  56. For an operation in error, this method marks the error as handled. If this method is
  57. not called for a failed operation, an exception will be thrown.
  58. </summary>
  59. <exception cref="T:System.InvalidOperationException"> is thrown if <see cref="P:System.Windows.Ria.OperationBase.HasError"/> <c>false</c>.</exception>
  60. </member>
  61. <member name="M:System.Windows.Ria.OperationBase.Cancel">
  62. <summary>
  63. Cancels the operation.
  64. </summary>
  65. <remarks>
  66. Upon completion of the operation, check the IsCanceled property to determine whether
  67. or not the operation was successfully canceled. Note that successful cancellation
  68. does not guarantee state changes were prevented from happening on the server.
  69. </remarks>
  70. <exception cref="T:System.NotSupportedException"> is thrown when <see cref="P:System.Windows.Ria.OperationBase.SupportsCancellation"/>
  71. is <c>false</c>.
  72. </exception>
  73. </member>
  74. <member name="M:System.Windows.Ria.OperationBase.CancelCore">
  75. <summary>
  76. Override this method to provide a Cancel implementation
  77. for operations that support cancellation.
  78. </summary>
  79. </member>
  80. <member name="M:System.Windows.Ria.OperationBase.Complete(System.Object)">
  81. <summary>
  82. Successfully completes the operation.
  83. </summary>
  84. <param name="result">The operation result.</param>
  85. </member>
  86. <member name="M:System.Windows.Ria.OperationBase.Complete(System.Exception)">
  87. <summary>
  88. Completes the operation with the specified error.
  89. </summary>
  90. <param name="error">The error.</param>
  91. </member>
  92. <member name="M:System.Windows.Ria.OperationBase.InvokeCompleteAction">
  93. <summary>
  94. Invoke the completion callback if present.
  95. </summary>
  96. </member>
  97. <member name="M:System.Windows.Ria.OperationBase.EnsureNotCompleted">
  98. <summary>
  99. Ensures an operation has not been completed or canceled. If
  100. it has been completed, an exception is thrown.
  101. </summary>
  102. </member>
  103. <member name="M:System.Windows.Ria.OperationBase.ValidateCallbackSignature(System.String,System.Delegate)">
  104. <summary>
  105. Verifies that the specified callback has a valid signature and
  106. throws an exception if it is not.
  107. </summary>
  108. <param name="paramName">The name of the callback parameter being validated.</param>
  109. <param name="callback">The callback.</param>
  110. </member>
  111. <member name="M:System.Windows.Ria.OperationBase.OnPropertyChanged(System.ComponentModel.PropertyChangedEventArgs)">
  112. <summary>
  113. Called when an property has changed on the operation.
  114. </summary>
  115. <param name="e">The event arguments</param>
  116. </member>
  117. <member name="M:System.Windows.Ria.OperationBase.RaisePropertyChanged(System.String)">
  118. <summary>
  119. Called to raise the PropertyChanged event
  120. </summary>
  121. <param name="propertyName">The name of the property that has changed</param>
  122. </member>
  123. <member name="P:System.Windows.Ria.OperationBase.IsErrorHandled">
  124. <summary>
  125. Gets or sets a value indicating whether the operation error has been marked as
  126. handled by calling <see cref="M:System.Windows.Ria.OperationBase.MarkErrorAsHandled"/>.
  127. </summary>
  128. </member>
  129. <member name="E:System.Windows.Ria.OperationBase.Completed">
  130. <summary>
  131. Event raised when the operation completes.
  132. </summary>
  133. </member>
  134. <member name="P:System.Windows.Ria.OperationBase.SupportsCancellation">
  135. <summary>
  136. Gets a value indicating whether this operation supports cancellation.
  137. If overridden to return true, <see cref="M:System.Windows.Ria.OperationBase.CancelCore"/> must also be overridden.
  138. </summary>
  139. </member>
  140. <member name="P:System.Windows.Ria.OperationBase.CanCancel">
  141. <summary>
  142. Gets a value indicating whether this operation is currently in a state
  143. where it can be canceled.
  144. <remarks>If <see cref="P:System.Windows.Ria.OperationBase.SupportsCancellation"/> is false,
  145. this operation doesn't support cancellation, and <see cref="P:System.Windows.Ria.OperationBase.CanCancel"/>
  146. will always return false.</remarks>
  147. </summary>
  148. </member>
  149. <member name="P:System.Windows.Ria.OperationBase.IsCanceled">
  150. <summary>
  151. Gets a value indicating whether this operation has been canceled.
  152. </summary>
  153. <remarks>
  154. Note that successful cancellation of this operation does not guarantee
  155. state changes were prevented from happening on the server.
  156. </remarks>
  157. </member>
  158. <member name="P:System.Windows.Ria.OperationBase.Error">
  159. <summary>
  160. Gets the operation error if the operation failed.
  161. </summary>
  162. </member>
  163. <member name="P:System.Windows.Ria.OperationBase.HasError">
  164. <summary>
  165. Gets a value indicating whether the operation has failed. If
  166. true, inspect the Error property for details.
  167. </summary>
  168. </member>
  169. <member name="P:System.Windows.Ria.OperationBase.IsComplete">
  170. <summary>
  171. Gets a value indicating whether this operation has completed.
  172. </summary>
  173. </member>
  174. <member name="P:System.Windows.Ria.OperationBase.Result">
  175. <summary>
  176. Gets the result of the async operation.
  177. </summary>
  178. </member>
  179. <member name="P:System.Windows.Ria.OperationBase.UserState">
  180. <summary>
  181. Gets the optional user state for this operation.
  182. </summary>
  183. </member>
  184. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.#ctor(System.Windows.Ria.ApplicationServices.AuthenticationService,System.Delegate,System.Object)">
  185. <summary>
  186. Initializes a new instance of the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationOperation"/> class.
  187. </summary>
  188. <param name="service">The service this operation will use to implement Begin, Cancel, and End</param>
  189. <param name="completeAction">The action to execute when the operation completes.</param>
  190. <param name="userState">Optional user state.</param>
  191. </member>
  192. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.Start">
  193. <summary>
  194. Starts the operation.
  195. </summary>
  196. <remarks>
  197. This method will invoke <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/> and will allow all
  198. exceptions thrown from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/> to pass through.
  199. </remarks>
  200. </member>
  201. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)">
  202. <summary>
  203. Template method for invoking the corresponding Begin method in the
  204. underlying async result implementation.
  205. </summary>
  206. <remarks>
  207. This method is invoked from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.Start"/>. Any exceptions thrown
  208. will be passed through.
  209. </remarks>
  210. <param name="callback">The <see cref="T:System.AsyncCallback"/> to invoke when the
  211. async call has completed. This can be passed directly to the underlying
  212. Begin method.
  213. </param>
  214. <returns>The async result returned by the underlying Begin call</returns>
  215. </member>
  216. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.HandleAsyncCompleted(System.IAsyncResult)">
  217. <summary>
  218. Handles completion of the underlying async call.
  219. </summary>
  220. <remarks>
  221. If <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.AsyncResult"/> is null (as in the case of a synchronous
  222. completion), it will be set to <paramref name="asyncResult"/>.
  223. </remarks>
  224. <param name="asyncResult">The async result returned by the underlying Begin call</param>
  225. </member>
  226. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.End(System.IAsyncResult)">
  227. <summary>
  228. Completes the operation.
  229. </summary>
  230. <remarks>
  231. This method will invoke <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.EndCore(System.IAsyncResult)"/> and will funnel all
  232. exceptions throw from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.EndCore(System.IAsyncResult)"/> into the operation.
  233. </remarks>
  234. <param name="result">The async result returned by the underlying Begin call</param>
  235. </member>
  236. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.EndCore(System.IAsyncResult)">
  237. <summary>
  238. Template method for invoking the corresponding End method in the
  239. underlying async result implementation.
  240. </summary>
  241. <remarks>
  242. This method is invoked by the callback passed into <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/>.
  243. Any exceptions thrown will be captured in the <see cref="P:System.Windows.Ria.OperationBase.Error"/>.
  244. </remarks>
  245. <param name="asyncResult">The async result returned by the underlying Begin call</param>
  246. <returns>The result of the End call to store in <see cref="P:System.Windows.Ria.OperationBase.Result"/></returns>
  247. </member>
  248. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.RunInSynchronizationContext(System.Threading.SendOrPostCallback,System.Object)">
  249. <summary>
  250. Runs the callback in the synchronization context the operation was created in.
  251. </summary>
  252. <param name="callback">The callback to run in the synchronization context</param>
  253. <param name="state">The optional state to pass to the callback</param>
  254. </member>
  255. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.RaiseCompletionPropertyChanges">
  256. <summary>
  257. Raises property changes after the operation has completed.
  258. </summary>
  259. <remarks>
  260. This method is invoked by the callback passed into <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/> once
  261. <see cref="P:System.Windows.Ria.OperationBase.Result"/> and <see cref="P:System.Windows.Ria.OperationBase.Error"/> have
  262. been set. Change notifications for any properties that have been affected by the
  263. state changes should occur here.
  264. </remarks>
  265. </member>
  266. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.AsyncResult">
  267. <summary>
  268. Gets the async result returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/>.
  269. </summary>
  270. <remarks>
  271. If <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationOperation.BeginCore(System.AsyncCallback)"/> has not been called, this may be null.
  272. </remarks>
  273. </member>
  274. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.Service">
  275. <summary>
  276. Gets the service this operation will use to implement Begin, Cancel, and End.
  277. </summary>
  278. </member>
  279. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.SupportsCancellation">
  280. <summary>
  281. Gets a value that indicates whether the operation supports cancellation.
  282. </summary>
  283. </member>
  284. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.Result">
  285. <summary>
  286. Gets the result as an <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationResult"/>.
  287. </summary>
  288. </member>
  289. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationOperation.User">
  290. <summary>
  291. Gets the user principal.
  292. </summary>
  293. <remarks>
  294. This value will be <c>null</c> before the operation completes, if the operation
  295. is canceled, or if the operation has errors.
  296. </remarks>
  297. </member>
  298. <member name="T:System.Windows.Ria.ApplicationServices.AuthenticationResult">
  299. <summary>
  300. Abstract base type for all the results returned by End calls for
  301. asynchronous operations in <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/>.
  302. </summary>
  303. </member>
  304. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationResult.#ctor(System.Security.Principal.IPrincipal)">
  305. <summary>
  306. Initializes a new instance of the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationResult"/> class.
  307. </summary>
  308. <param name="user">The user principal.</param>
  309. </member>
  310. <member name="P:System.Windows.Ria.ApplicationServices.AuthenticationResult.User">
  311. <summary>
  312. Gets the user
  313. </summary>
  314. </member>
  315. <member name="T:System.Windows.Ria.ApplicationServices.FormsAuthentication">
  316. <summary>
  317. <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/> that performs Forms authentication using
  318. a <see cref="T:System.Windows.Ria.DomainContext"/> generated from a domain service
  319. implementing <c>System.Web.Ria.ApplicationServices.IAuthentication&lt;T&gt;</c>.
  320. </summary>
  321. <remarks>
  322. This implementation sets the user authentication type to <c>"Forms"</c>.
  323. </remarks>
  324. </member>
  325. <member name="T:System.Windows.Ria.ApplicationServices.WebAuthenticationService">
  326. <summary>
  327. Abstract extension of the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/> that
  328. interacts with a <see cref="P:System.Windows.Ria.ApplicationServices.WebAuthenticationService.DomainContext"/> generated from a domain
  329. service implementing
  330. <c>System.Web.Ria.ApplicationServices.IAuthentication&lt;T&gt;</c>.
  331. </summary>
  332. </member>
  333. <member name="T:System.Windows.Ria.ApplicationServices.AuthenticationService">
  334. <summary>
  335. Service that is responsible for authenticating, loading, and saving the current user.
  336. </summary>
  337. <remarks>
  338. This abstract base exposes <c>Login</c>, <c>Logout</c>, <c>LoadUser</c>, and
  339. <c>SaveUser</c> as asynchronous operations. It also provides a number of properties
  340. that can be bound to including <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.IsBusy"/> and <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  341. <para>
  342. Concrete implementations will have a much different view of this class through a
  343. number of abstract template methods. These methods follow the async result pattern
  344. and are presented in Begin/End pairs for each operation. Optionally, cancel methods
  345. for each operation can also be implemented.
  346. </para>
  347. </remarks>
  348. </member>
  349. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.#ctor">
  350. <summary>
  351. Initializes a new instance of the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/> class.
  352. </summary>
  353. </member>
  354. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.Login(System.String,System.String)">
  355. <summary>
  356. Asynchronously authenticates and logs in to the server with the specified parameters.
  357. </summary>
  358. <remarks>
  359. This method starts an operation with no complete action or user state. If this method
  360. returns normally, a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/> event may be raised. Also, successful
  361. completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  362. </remarks>
  363. <param name="userName">The username associated with the user to authenticate</param>
  364. <param name="password">the password associated with the user to authenticate</param>
  365. <returns>Returns the login operation.</returns>
  366. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  367. another asynchronous operation is still being processed.
  368. </exception>
  369. <seealso cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/>
  370. </member>
  371. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.Login(System.Windows.Ria.ApplicationServices.LoginParameters)">
  372. <summary>
  373. Asynchronously authenticates and logs in to the server with the specified parameters.
  374. </summary>
  375. <remarks>
  376. This method starts an operation with no complete action or user state. If this method
  377. returns normally, a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/> event may be raised. Also, successful
  378. completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  379. </remarks>
  380. <returns>Returns the login operation.</returns>
  381. <param name="parameters">Login parameters that specify the user to authenticate</param>
  382. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  383. another asynchronous operation is still being processed.
  384. </exception>
  385. <seealso cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/>
  386. </member>
  387. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.Login(System.Windows.Ria.ApplicationServices.LoginParameters,System.Action{System.Windows.Ria.ApplicationServices.LoginOperation},System.Object)">
  388. <summary>
  389. Asynchronously authenticates and logs in to the server with the specified parameters.
  390. </summary>
  391. <remarks>
  392. If this method returns normally, a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/> event may be raised. Also,
  393. successful completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  394. </remarks>
  395. <param name="parameters">Login parameters that specify the user to authenticate</param>
  396. <param name="completeAction">This action will be invoked immediately after the operation
  397. completes and is called in all cases including success, cancellation, and error. This
  398. parameter is optional.
  399. </param>
  400. <param name="userState">This state will be set into
  401. <see cref="P:System.Windows.Ria.OperationBase.UserState"/>. This parameter is optional.
  402. </param>
  403. <returns>Returns the login operation.</returns>
  404. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  405. another asynchronous operation is still being processed.
  406. </exception>
  407. <seealso cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/>
  408. </member>
  409. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.Logout(System.Boolean)">
  410. <summary>
  411. Asynchronously logs an authenticated user out from the server.
  412. </summary>
  413. <remarks>
  414. This method starts an operation with no complete action or user state. If this method
  415. returns normally, a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedOut"/> event may be raised. Also, successful
  416. completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  417. </remarks>
  418. <param name="throwOnError">True if an unhandled error should result in an exception, false otherwise.
  419. To handle an operation error, <see cref="M:System.Windows.Ria.OperationBase.MarkErrorAsHandled"/> can be called from the
  420. operation completion callback or from a <see cref="E:System.Windows.Ria.OperationBase.Completed"/> event handler.
  421. </param>
  422. <returns>Returns the logout operation.</returns>
  423. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  424. another asynchronous operation is still being processed.
  425. </exception>
  426. <seealso cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedOut"/>
  427. </member>
  428. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.Logout(System.Action{System.Windows.Ria.ApplicationServices.LogoutOperation},System.Object)">
  429. <summary>
  430. Asynchronously logs an authenticated user out from the server.
  431. </summary>
  432. <remarks>
  433. If this method returns normally, a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedOut"/> event may be raised. Also,
  434. successful completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  435. </remarks>
  436. <param name="completeAction">This action will be invoked immediately after the operation
  437. completes and is called in all cases including success, cancellation, and error. This
  438. parameter is optional.
  439. </param>
  440. <param name="userState">This state will be set into
  441. <see cref="P:System.Windows.Ria.OperationBase.UserState"/>. This parameter is optional.
  442. </param>
  443. <returns>Returns the logout operation.</returns>
  444. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  445. another asynchronous operation is still being processed.
  446. </exception>
  447. <seealso cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedOut"/>
  448. </member>
  449. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.LoadUser">
  450. <summary>
  451. Asynchronously loads the authenticated user from the server.
  452. </summary>
  453. <remarks>
  454. This method starts an operation with no complete action or user state. Successful
  455. completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  456. </remarks>
  457. <returns>Returns the load user operation.</returns>
  458. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  459. another asynchronous operation is still being processed.
  460. </exception>
  461. </member>
  462. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.LoadUser(System.Action{System.Windows.Ria.ApplicationServices.LoadUserOperation},System.Object)">
  463. <summary>
  464. Asynchronously loads the authenticated user from the server.
  465. </summary>
  466. <remarks>
  467. Successful completion of this operation will update the <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/>.
  468. </remarks>
  469. <param name="completeAction">This action will be invoked immediately after the operation
  470. completes and is called in all cases including success, cancellation, and error. This
  471. parameter is optional.
  472. </param>
  473. <param name="userState">This state will be set into
  474. <see cref="P:System.Windows.Ria.OperationBase.UserState"/>. This parameter is optional.
  475. </param>
  476. <returns>Returns the load user operation.</returns>
  477. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  478. another asynchronous operation is still being processed.
  479. </exception>
  480. </member>
  481. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.SaveUser(System.Boolean)">
  482. <summary>
  483. Asynchronously saves the authenticated user to the server.
  484. </summary>
  485. <remarks>
  486. This method starts an operation with no complete action or user state.
  487. </remarks>
  488. <param name="throwOnError">True if an unhandled error should result in an exception, false otherwise.
  489. To handle an operation error, <see cref="M:System.Windows.Ria.OperationBase.MarkErrorAsHandled"/> can be called from the
  490. operation completion callback or from a <see cref="E:System.Windows.Ria.OperationBase.Completed"/> event handler.
  491. </param>
  492. <returns>Returns the save user operation.</returns>
  493. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  494. another asynchronous operation is still being processed.
  495. </exception>
  496. </member>
  497. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.SaveUser(System.Action{System.Windows.Ria.ApplicationServices.SaveUserOperation},System.Object)">
  498. <summary>
  499. Asynchronously saves the authenticated user to the server.
  500. </summary>
  501. <param name="completeAction">This action will be invoked immediately after the operation
  502. completes and is called in all cases including success, cancellation, and error. This
  503. parameter is optional.
  504. </param>
  505. <param name="userState">This state will be set into
  506. <see cref="P:System.Windows.Ria.OperationBase.UserState"/>. This parameter is optional.
  507. </param>
  508. <returns>Returns the save user operation.</returns>
  509. <exception cref="T:System.InvalidOperationException"> is thrown if this method is called while
  510. another asynchronous operation is still being processed.
  511. </exception>
  512. </member>
  513. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.WrapCompleteAction(System.Delegate)">
  514. <summary>
  515. Wraps the specified action so the <see cref="T:System.Windows.Ria.ApplicationServices.AuthenticationService"/> can complete
  516. processing of the operation before invoking the <paramref name="completeAction"/>.
  517. </summary>
  518. <param name="completeAction">The action to invoke once the service finishes
  519. processing the operation. This parameter is optional.
  520. </param>
  521. <returns>An action that will complete processing of the operation before invoking
  522. the wrapped action.
  523. </returns>
  524. </member>
  525. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.StartOperation(System.Windows.Ria.ApplicationServices.AuthenticationOperation)">
  526. <summary>
  527. Starts an asynchronous operation if one is not already in progress
  528. </summary>
  529. <param name="operation">The operation to start</param>
  530. <exception cref="T:System.InvalidOperationException"> is returned if this method is called while
  531. another asynchronous operation is still being processed.
  532. </exception>
  533. </member>
  534. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.GetBusyPropertyName(System.Windows.Ria.ApplicationServices.AuthenticationOperation)">
  535. <summary>
  536. Returns the name of the "busy" property for the specified operation
  537. </summary>
  538. <param name="operation">The operation to get the property name for</param>
  539. <returns>The name of the "busy" property for the operation</returns>
  540. <seealso cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.IsLoggingIn"/>
  541. <seealso cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.IsLoggingOut"/>
  542. <seealso cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.IsLoadingUser"/>
  543. <seealso cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.IsSavingUser"/>
  544. </member>
  545. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.RunInSynchronizationContext(System.Threading.SendOrPostCallback,System.Object)">
  546. <summary>
  547. Runs the callback in the synchronization context
  548. </summary>
  549. <param name="callback">The callback to run</param>
  550. <param name="state">The state to pass to the callback</param>
  551. </member>
  552. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.RaisePropertyChanged(System.String)">
  553. <summary>
  554. Raises a <see cref="E:System.ComponentModel.INotifyPropertyChanged.PropertyChanged"/> event for the specified property.
  555. </summary>
  556. <param name="propertyName">The property to raise an event for</param>
  557. <exception cref="T:System.ArgumentNullException"> is thrown if the <paramref name="propertyName"/>
  558. is null.
  559. </exception>
  560. </member>
  561. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.OnPropertyChanged(System.ComponentModel.PropertyChangedEventArgs)">
  562. <summary>
  563. Raises a <see cref="E:System.ComponentModel.INotifyPropertyChanged.PropertyChanged"/> event.
  564. </summary>
  565. <param name="e">The event to raise</param>
  566. </member>
  567. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.OnLoggedIn(System.Windows.Ria.ApplicationServices.AuthenticationEventArgs)">
  568. <summary>
  569. Raises a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedIn"/> event.
  570. </summary>
  571. <param name="e">The event to raise</param>
  572. </member>
  573. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.OnLoggedOut(System.Windows.Ria.ApplicationServices.AuthenticationEventArgs)">
  574. <summary>
  575. Raises a <see cref="E:System.Windows.Ria.ApplicationServices.AuthenticationService.LoggedOut"/> event.
  576. </summary>
  577. <param name="e">The event to raise</param>
  578. </member>
  579. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.HandleOperationError(System.Windows.Ria.ApplicationServices.AuthenticationOperation)">
  580. <summary>
  581. Marks an operation in error as handled.
  582. </summary>
  583. <param name="ao">The operation in error.</param>
  584. </member>
  585. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CreateDefaultUser">
  586. <summary>
  587. Creates a default user.
  588. </summary>
  589. <remarks>
  590. This method will be invoked by <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/> when it is accessed before the value
  591. is set. The returned value is then stored and return on all subsequent gets until a
  592. <c>Login</c>, <c>Logout</c>, or <c>LoadUser</c> operation completes successfully.
  593. </remarks>
  594. <returns>A default user. This value may not be null.</returns>
  595. <exception cref="T:System.InvalidOperationException"> is thrown from <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.User"/> if
  596. this operation returns null.
  597. </exception>
  598. </member>
  599. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)">
  600. <summary>
  601. Begins an asynchronous <c>Login</c> operation.
  602. </summary>
  603. <remarks>
  604. This method is invoked from <c>Login</c>. Exceptions thrown from this method will
  605. prevent the operation from starting and then be thrown from <c>Login</c>.
  606. </remarks>
  607. <param name="parameters">Login parameters that specify the user to authenticate. This
  608. parameter is optional.</param>
  609. <param name="callback">This callback should be invoked when the asynchronous call completes.
  610. If the asynchronous call is canceled, the callback should not be invoked. This parameter
  611. is optional.
  612. </param>
  613. <param name="state">The state should be set into the <see cref="T:System.IAsyncResult"/> this
  614. method returns. This parameter is optional.
  615. </param>
  616. <returns>An <see cref="T:System.IAsyncResult"/> that represents the asynchronous call and
  617. will be passed to the cancel and end methods.
  618. </returns>
  619. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogin(System.IAsyncResult)"/>
  620. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogin(System.IAsyncResult)"/>
  621. </member>
  622. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogin(System.IAsyncResult)">
  623. <summary>
  624. Cancels an asynchronous <c>Login</c> operation.
  625. </summary>
  626. <remarks>
  627. The default implementation throws a <see cref="T:System.NotSupportedException"/> when
  628. <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.SupportsCancellation"/> is <c>false</c> and does not need to be called from
  629. overridden implementations. This method is invoked when a <c>Login</c> operation is
  630. canceled. Either this or <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogin(System.IAsyncResult)"/> will be invoked to conclude the operation
  631. but not both. After <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogin(System.IAsyncResult)"/> is called, the callback passed in to
  632. <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/> should not be invoked. Exceptions thrown from this method will
  633. be available in <see cref="P:System.Windows.Ria.OperationBase.Error"/>.
  634. </remarks>
  635. <param name="asyncResult">A result returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/> that represents
  636. the asynchronous call to cancel.
  637. </param>
  638. <exception cref="T:System.InvalidOperationException"> is thrown if <paramref name="asyncResult"/>
  639. was not returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/> or the asynchronous call has already been
  640. concluded with a previous call to cancel or end.
  641. </exception>
  642. <seealso cref="M:System.Windows.Ria.OperationBase.Cancel"/>
  643. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/>
  644. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogin(System.IAsyncResult)"/>
  645. </member>
  646. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogin(System.IAsyncResult)">
  647. <summary>
  648. Ends an asynchronous <c>Login</c> operation.
  649. </summary>
  650. <remarks>
  651. This method is invoked when a <c>Login</c> operation completes. Either this or
  652. <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogin(System.IAsyncResult)"/> will be invoked to conclude the operation but not both.
  653. Exceptions thrown from this method will be available in
  654. <see cref="P:System.Windows.Ria.OperationBase.Error"/>.
  655. </remarks>
  656. <param name="asyncResult">A result returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/> that represents
  657. the asynchronous call to conclude.
  658. </param>
  659. <returns>The result of the asynchronous <c>Login</c> call</returns>
  660. <exception cref="T:System.InvalidOperationException"> is thrown if <paramref name="asyncResult"/>
  661. was not returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/> or the asynchronous call has already been
  662. concluded with a previous call to cancel or end.
  663. </exception>
  664. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogin(System.Windows.Ria.ApplicationServices.LoginParameters,System.AsyncCallback,System.Object)"/>
  665. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogin(System.IAsyncResult)"/>
  666. </member>
  667. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)">
  668. <summary>
  669. Begins an asynchronous <c>Logout</c> operation.
  670. </summary>
  671. <remarks>
  672. This method is invoked from <c>Logout</c>. Exceptions thrown from this method will
  673. prevent the operation from starting and then be thrown from <c>Logout</c>.
  674. </remarks>
  675. <param name="callback">This callback should be invoked when the asynchronous call completes.
  676. If the asynchronous call is canceled, the callback should not be invoked. This parameter
  677. is optional.
  678. </param>
  679. <param name="state">The state should be set into the <see cref="T:System.IAsyncResult"/> this
  680. method returns. This parameter is optional.
  681. </param>
  682. <returns>An <see cref="T:System.IAsyncResult"/> that represents the asynchronous call and
  683. will be passed to the cancel and end methods.
  684. </returns>
  685. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogout(System.IAsyncResult)"/>
  686. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogout(System.IAsyncResult)"/>
  687. </member>
  688. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogout(System.IAsyncResult)">
  689. <summary>
  690. Cancels an asynchronous <c>Logout</c> operation.
  691. </summary>
  692. <remarks>
  693. The default implementation throws a <see cref="T:System.NotSupportedException"/> when
  694. <see cref="P:System.Windows.Ria.ApplicationServices.AuthenticationService.SupportsCancellation"/> is <c>false</c> and does not need to be called from
  695. overridden implementations. This method is invoked when a <c>Logout</c> operation is
  696. canceled. Either this or <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogout(System.IAsyncResult)"/> will be invoked to conclude the operation
  697. but not both. After <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogout(System.IAsyncResult)"/> is called, the callback passed in to
  698. <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/> should not be invoked. Exceptions thrown from this method will
  699. be available in <see cref="P:System.Windows.Ria.OperationBase.Error"/>.
  700. </remarks>
  701. <param name="asyncResult">A result returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/> that represents
  702. the asynchronous call to cancel.
  703. </param>
  704. <exception cref="T:System.InvalidOperationException"> is thrown if <paramref name="asyncResult"/>
  705. was not returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/> or the asynchronous call has already been
  706. concluded with a previous call to cancel or end.
  707. </exception>
  708. <seealso cref="M:System.Windows.Ria.OperationBase.Cancel"/>
  709. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/>
  710. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogout(System.IAsyncResult)"/>
  711. </member>
  712. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLogout(System.IAsyncResult)">
  713. <summary>
  714. Ends an asynchronous <c>Logout</c> operation.
  715. </summary>
  716. <remarks>
  717. This method is invoked when a <c>Logout</c> operation completes. Either this or
  718. <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogout(System.IAsyncResult)"/> will be invoked to conclude the operation but not both.
  719. Exceptions thrown from this method will be available in
  720. <see cref="P:System.Windows.Ria.OperationBase.Error"/>.
  721. </remarks>
  722. <param name="asyncResult">A result returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/> that represents
  723. the asynchronous call to conclude.
  724. </param>
  725. <returns>The result of the asynchronous <c>Logout</c> call</returns>
  726. <exception cref="T:System.InvalidOperationException"> is thrown if <paramref name="asyncResult"/>
  727. was not returned from <see cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/> or the asynchronous call has already been
  728. concluded with a previous call to cancel or end.
  729. </exception>
  730. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLogout(System.AsyncCallback,System.Object)"/>
  731. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLogout(System.IAsyncResult)"/>
  732. </member>
  733. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.BeginLoadUser(System.AsyncCallback,System.Object)">
  734. <summary>
  735. Begins an asynchronous <c>LoadUser</c> operation.
  736. </summary>
  737. <remarks>
  738. This method is invoked from <c>LoadUser</c>. Exceptions thrown from this method will
  739. prevent the operation from starting and then be thrown from <c>LoadUser</c>.
  740. </remarks>
  741. <param name="callback">This callback should be invoked when the asynchronous call completes.
  742. If the asynchronous call is canceled, the callback should not be invoked. This parameter
  743. is optional.
  744. </param>
  745. <param name="state">The state should be set into the <see cref="T:System.IAsyncResult"/> this
  746. method returns. This parameter is optional.
  747. </param>
  748. <returns>An <see cref="T:System.IAsyncResult"/> that represents the asynchronous call and
  749. will be passed to the cancel and end methods.
  750. </returns>
  751. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLoadUser(System.IAsyncResult)"/>
  752. <seealso cref="M:System.Windows.Ria.ApplicationServices.AuthenticationService.EndLoadUser(System.IAsyncResult)"/>
  753. </member>
  754. <member name="M:System.Windows.Ria.ApplicationServices.AuthenticationService.CancelLoadUser(System.IAsyncResult)">
  755. <summary>
  756. Cancels an asynchronous <c>LoadUser</c> operation.
  757. </summary>
  758. <rem

Large files files are truncated, but you can click here to view the full file