Share via

CrmCalloutBase.PreCreate Method

  • Article
banner art

Specifies a method called before a create operation.

Syntax

[Visual Basic .NET]
Overridable Public Function PreCreate(
  ByVal userContext As CalloutUserContext,
  ByVal entityContext As CalloutEntityContext,
  ByRef entityXml As String,
  ByRef errorMessage As String
) As PreCalloutReturnValue
[C#]
public virtual PreCalloutReturnValue PreCreate(
  CalloutUserContext  userContext,
  CalloutEntityContext  entityContext,
  ref string  entityXml,
  ref string  errorMessage
);
[JScript]
public virtual function PreCreate(
  userContext : CalloutUserContext,
  entityContext : CalloutEntityContext,
  entityXml : String,
  errorMessage : String
) : PreCalloutReturnValue;

Parameters

userContext

Contains information about the user who is performing the create operation. See CalloutUserContext.

entityContext

Contains information about the entity being created. See CalloutEntityContext.

entityXml

[ref] An XML string that describes the entity to be created. This string may be modified during the execution of this method. This is a serialized version of DynamicEntity.

errorMessage

[ref] A string that contains the error message to be returned to the application. The error message string should not exceed 1,500 characters in length.

Return Value

Returns a PreCalloutReturnValue type that specifies what action to take after this method completes.

Example

The following code example shows how to log an object creation using a pre-callout.

public override PreCalloutReturnValue PreCreate(CalloutUserContext userContext,
                         CalloutEntityContext entityContext,
                         ref string entityXml,
                         ref string errorMessage)
{
   TextWriter log = TextWriter.Synchronized(
     File.AppendText(@"C:\CRM_SDK_Drop\Create.txt"));
   log.WriteLine("PreCreate");
   log.WriteLine("ObjectType: " +
     entityContext.EntityTypeCode.ToString());
   log.WriteLine("ObjectId: " + entityContext.InstanceId.ToString());
   log.WriteLine("CreatorId: " + userContext.UserId.ToString());
   log.WriteLine();
   log.Close();

   return PreCalloutReturnValue.Continue;
}

Requirements

Namespace: Microsoft.Crm.Callout

Assembly: microsoft.crm.platform.callout.base.dll

See Also

© 2007 Microsoft Corporation. All rights reserved.