LoadOperation Class

WCF RIA Services

[WCF RIA Services Version 1 Service Pack 2 is compatible with either .NET framework 4 or .NET Framework 4.5, and with either Silverlight 4 or Silverlight 5.]

Represents an asynchronous load operation.

Namespace:  System.ServiceModel.DomainServices.Client
Assembly:  System.ServiceModel.DomainServices.Client (in System.ServiceModel.DomainServices.Client.dll)

public abstract class LoadOperation : OperationBase

The LoadOperation type exposes the following members.

Public propertyAllEntitiesGets all the entities loaded by the operation, including any entities referenced by the top-level entities.
Public propertyCanCancelGets a value that indicates whether this OperationBase is currently in a state that enables it to be canceled. (Inherited from OperationBase.)
Public propertyEntitiesGets all the top-level entities loaded by the operation.
Public propertyEntityQueryGets the System.ServiceModel.DomainServices.Client.EntityQuery for this load operation.
Public propertyErrorGets the operation error if the operation failed. (Inherited from OperationBase.)
Public propertyHasErrorGets a value that indicates whether the operation failed. (Inherited from OperationBase.)
Public propertyIsCanceledGets a value that indicates whether this operation has been canceled. (Inherited from OperationBase.)
Public propertyIsCompleteGets a value that indicates whether this operation has completed. (Inherited from OperationBase.)
Public propertyIsErrorHandledGets or sets a value that indicates whether the operation error has been handled. (Inherited from OperationBase.)
Public propertyLoadBehaviorGets the System.ServiceModel.DomainServices.Client.LoadBehavior for this load operation.
Protected propertyResultGets the DomainClientResult for this operation.
Protected propertySupportsCancellationGets a value that indicates whether this operation supports cancellation. (Inherited from OperationBase.)
Public propertyTotalEntityCountGets the total server entity count for the query used by this operation.
Public propertyUserStateGets the optional user state for this operation. (Inherited from OperationBase.)
Public propertyValidationErrorsGets the validation errors.

Public methodCancelCancels the operation. (Inherited from OperationBase.)
Protected methodCancelCoreWhen overridden in a derived class, provides the logic to cancel the operation. (Inherited from OperationBase.)
Protected methodComplete(Exception)Completes a failed operation with the specified error. (Inherited from OperationBase.)
Protected methodComplete(Object)Completes a successful operation with the specified result. (Inherited from OperationBase.)
Public methodEquals (Inherited from Object.)
Protected methodFinalize (Inherited from Object.)
Public methodGetHashCode (Inherited from Object.)
Public methodGetType (Inherited from Object.)
Protected methodInvokeCompleteActionInvokes the completion callback. (Inherited from OperationBase.)
Public methodMarkErrorAsHandledSpecifies that an error encountered in an operation is handled. (Inherited from OperationBase.)
Protected methodMemberwiseClone (Inherited from Object.)
Protected methodOnPropertyChangedCalled when the value of a property changes. (Inherited from OperationBase.)
Protected methodRaisePropertyChangedRaises the System#ComponentModel#INotifyPropertyChanged#PropertyChanged() event. (Inherited from OperationBase.)
Public methodToString (Inherited from Object.)
Protected methodUpdateResultsUpdates the observable result collections.

Public eventCompletedOccurs when the operation completes. (Inherited from OperationBase.)

Explicit interface implemetationPrivate eventINotifyPropertyChanged.PropertyChangedOccurs when a property value changes. (Inherited from OperationBase.)

// Create an EntityQuery of type Customer
EntityQuery<Customer> query =
    from c in _customerContext.GetCustomersQuery()
    where c.Phone.StartsWith("583")
    orderby c.LastName
    select c;

// Create and execute a LoadOperation of type Customer and load 'query'
LoadOperation<Customer> loadOp = this._customerContext.Load(query);

// Create a new DomainOperationException for a Validation Error
DomainOperationException opEx = new DomainOperationException(
    "Validation Error",

// Check if there are any ValidationErrors when loadOp was executed
// Then throw the DomainOperationException opEx
if (loadOp.ValidationErrors != null)
    throw opEx;

// Populate the CustomerGrid with the Entities in loadOp
CustomerGrid.ItemsSource = loadOp.Entities;

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.