IdeaBlade DevForce 2010 Help Reference
Disconnect Method
See Also  Example Send Feedback
IdeaBlade.EntityModel Assembly > IdeaBlade.EntityModel Namespace > EntityManager Class : Disconnect Method



Disconnect from the IdeaBlade.EntityModel.Server.EntityServer.

Syntax

Visual Basic (Declaration) 
Public Sub Disconnect() 
Visual Basic (Usage)Copy Code
Dim instance As EntityManager
 
instance.Disconnect()
C# 
public void Disconnect()
C++/CLI 
public:
void Disconnect(); 

Example

C#Copy Code
private bool Initialize() {
      string runTimeEnv;
#if TEST
      runTimeEnv = "Test";
#else
      runTimeEnv = "Prod";
#endif

      // Initialize an EntityManager for the given data source extension, and set up an error handler.
      IdeaBladeTest1Manager mgr = new IdeaBladeTest1Manager(false, runTimeEnv);
      mgr.EntityServerError += EntityServerErrorHandler;

      // Explicitly connect to the BOS now.
      // Note that no data source connection is made until entities are accessed.
      try {
        mgr.Connect();
      } catch (EntityServerException ese) {
        MessageBox.Show(ese.Message, "EntityServerException");
      } catch (Exception e) {
        MessageBox.Show(e.Message, "Exception");
      }
      return mgr.IsConnected;
    }
    private void EntityServerErrorHandler(object pSender, EntityServerErrorEventArgs e) {
      // Always a good idea to log all exception info.
      Exception ex = e.Exception;
      while (ex != null) {
        TraceFns.WriteLine(ex.ToString());
        ex = ex.InnerException;
      }
      MessageBox.Show("Trying to handle error");
      // Leave e.Handled = false if the Error should be thrown back to the calling code
      e.Handled = true;         // exception will not be thrown
    }

Remarks

Disconnect marks the connection to the EntityServer as closed. Once disconnected, all further queries will be fulfilled using only cached entities, and any EntityManager.SaveChanges call will fail. Note that a "null" entity is returned for any requested object not found in cache.

Disconnect does not explicitly close data source connections.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2013 All Rights Reserved.