/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<T></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<T></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