Draft for Information Only

Content


        ObjectContext Object
 ObjectContext.SetAbort Method
  
        Syntax:
  
  Parameters:
  
        Return Values:
  
        Remarks:
  Examples:
 ObjectContext.SetComplete Method
  
        Syntax:
  
  Parameters:
  
        Return Values:
  
        Remarks:
  Examples:

ObjectContext Object

The key functions of ObjectContext is the transaction control on the server.

ObjectContext.SetAbort Method

ObjectContext.SetAbort Method sets the flag of a transaction during processing scripts in an ASP page to about for the script in a transaction has not completed. Therefore the Component Services should not update those related resources even other participating components in the transaction has completed.

Syntax:

SetAbout(
)

Or in ASP file Imply

<% SetAbout() %>

Parameters:

void

This method has no parameters.

Return Values:

void

This method has no return values.

Remarks:

When an ASP page initiates a SetAbout method to abort a transaction, the related transaction as a whole becomes unsuccessful. Since the transaction ends unsuccessfully, the Component Services should not update those related resources even other participating components in the transaction has completed. And any changes made by the transaction are rolled back.

The @TRANSACTION processing directive should be used to indicate the script should be treated as a transaction.

Examples:

Use ObjectContext.SetAbort Method to abort a transaction

ASP script command:

<%@ TRANSACTION=Required LANGUAGE=ScriptLanguage%>
<%
If reqqty>stock then
ObjectContext.SetAbort
end if
%>

ObjectContext.SetComplete Method

ObjectContext.SetCommit Method sets the flag of a transaction during processing scripts in an ASP page to complete for the script in a transaction has completed. Therefore the Component Services can check with other participating components in the transaction whether these participating components has completed or not. If all participating components in the transaction has completed and call SetComplete then the related resources can be updated.

Syntax:

SetComplete(
)

Or in ASP file Imply

<% SetComplete() %>

Parameters:

void

This method has no parameters.

Return Values:

void

This method has no return values.

Remarks:

When an ASP page initiates a SetComplete method to commit a transaction, only part of the related transaction is completed. Since all related component parts of the transaction must call SetComplete for the related transaction to complete as a whole, the Component Services should not update those related resources until all other participating components in the transaction has completed. And after checking all participating component parts of the transaction are commited by the SetComplete method, the Component Services will then update the related resources.

The @TRANSACTION processing directive should be used to indicate the script should be treated as a transaction.

Examples:

Use ObjectContext.SetAbort Method to abort a transaction

ASP script command:

<%@ TRANSACTION=Required LANGUAGE=ScriptLanguage%>
<%
If reqqty>stock then
ObjectContext.SetAbort
else
ObjectContext.SetComplete
end if
%>

©sideway

ID: 120200054 Last Updated: 2/14/2012 Revision: 0 Ref:

References

Active Server Pages, , http://msdn.microsoft.com/en-us/library/aa286483.aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx
ASP Best Practices, , http://technet.microsoft.com/en-us/library/cc939157.aspx
ASP Built-in Objects, , http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx
Response Object, , http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx
Request Object, , http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx
Server Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx
Application Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx
Session Object (IIS), , http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx
ASPError Object, , http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx
ObjectContext Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx
Debugging Global.asa Files, , http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx
How to: Debug Global.asa files, , http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx
Calling COM Components from ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx
IIS ASP Scripting Reference, , http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx
ASP Keywords, , http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx
Creating Simple ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx
Including Files in ASP Applications, , http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx
FileSystemObject Object, , http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx
http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, , ADO Object Model
ADO Fundamentals, , http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx