<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:lastBlockDepth="2" MadCap:lastHeight="120" MadCap:lastWidth="624" MadCap:disableMasterStylesheet="true" MadCap:tocPath="Configuration" MadCap:InPreviewMode="false" MadCap:RuntimeFileType="Topic" MadCap:TargetType="WebHelp" MadCap:PathToHelpSystem="../../" MadCap:HelpSystemFileName="index.xml" MadCap:SearchType="Stem">
<head><title>Common Configuration</title>
<script type="text/javascript">/* <![CDATA[ */
window.onload = function(){
var pathToFlash = $('html').attr('MadCap:PathToHelpSystem') + 'Content/Resources/Code/ZeroClipboard.swf';
ZeroClipboard.setMoviePath(pathToFlash);
function bindToClipBord(element,content){
var clip = new ZeroClipboard.Client();
clip.setText(content);
clip.glue(element);
};
if(location.protocol==='file:'){
$('.copylink-marker').remove();
} else{
$('.copylink-marker').each(function(){
var text = $(this).parent().parent().children('.prettyprint').html();
$(this).hover(function(){
bindToClipBord(this,text);
},
function(){});
});
}
prettyPrint();
};
/* ]]> */</script>
<link href="../SkinSupport/MadCap.css" rel="stylesheet" />
<link href="../Resources/TableStyles/Basic.css" rel="stylesheet" />
<link href="../Resources/Stylesheets/OnlineStyle.css" rel="stylesheet" />
<script src="../SkinSupport/MadCapAll.js">
</script>
<script src="../Resources/Code/prettify.js">
</script>
<script src="../Resources/Code/lang-vb.js">
</script>
<script src="../Resources/Code/jquery.min.js">
</script>
<script src="../Resources/Code/ZeroClipboard.js">
</script>
</head>
<body>
<p class="MCWebHelpFramesetLink" style="display: none;"><a href="../../index_CSH.html#configuration/common_configuration.htm" style="">Open topic with navigation</a>
</p>
<div class="MCBreadcrumbsBox"><span class="MCBreadcrumbsPrefix">You are here: </span><a class="MCBreadcrumbsLink" href="../configuration.htm">Configuration</a><span class="MCBreadcrumbsDivider"> > </span><span class="MCBreadcrumbs">Common Configuration</span>
</div>
<p>
<script type="text/javascript">/*<![CDATA[*/document.write('<a href="' + location.href +'">');
document.write("Direct Link");
document.write('</a>');/*]]>*/</script>
</p>
<p>
</p>
<h1><a name="kanchor38"></a>Common Configuration</h1>
<p>The common-configuration applies to the embedded-, client- and the server-mode of db4o. All the common configuration is accessible via the common-<span class="Primarygetter">property</span> on the configuration-object. </p>
<h2>Overview</h2>
<p>Here's a overview over all common configuration-settings which you can change:</p>
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Basic.css');" class="TableStyle_Basic" cellspacing="0">
<col style="width: 80%;" />
<col style="width: 50pt;" />
<col style="width: 50pt;" />
<tbody>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep">Same in <span class="MCPopup"><a href="javascript:void(0);" class="MCPopupSpot" onclick="FMCPopup( event, this ); return false;" MadCap:src="../client-server.htm">C/S<img style="border: none;margin-left: 5px;" src="../SkinSupport/ExpandingClosed.gif" MadCap:altsrc="../SkinSupport/ExpandingOpen.gif" class="MCExpandingIcon" onload="if ( typeof( FMCPreloadImage ) == 'function' ) { FMCPreloadImage( '../SkinSupport/ExpandingOpen.gif' ); }" /></a></span><span class="MCTextPopup"><a href="javascript:void(0);" class="popupHead_0" onclick="FMCTextPopup( event, this ); return false;" style="font-size: 0.9em; vertical-align: super">1</a><span class="MCTextPopupBody" style="display: none; ">This setting needs to be the same on the server and all clients.</span></span></td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd">Can not change <span class="MCTextPopup"><a href="javascript:void(0);" class="popupHead_0" onclick="FMCTextPopup( event, this ); return false;" style="font-size: 0.9em; vertical-align: super">2</a><span class="MCTextPopupBody" style="display: none; ">This setting has to be set the first time when the database is created. You cannot change is for an existing database.</span></span></td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/activation_depth.htm">ActivationDepth</a></strong>: Change globally the activation-depth.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/alias.htm">Aliases</a></strong>: Configure aliases for class and package-names.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/updating_db4o_file_format.htm">AllowVersionUpdates</a></strong>: Allow/Disallow to update the database-format.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep">Yes</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/automatic_shutdown.htm">AutomaticShutDown</a></strong>: Close the database when the application exits.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/btree_node_size.htm">BTreeNodeSize</a></strong>: Tune the size of the B-tree-node which are used for the indexes.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/no_callbacks.htm">Callbacks</a></strong>: Turn object-callbacks on an off.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/calling_constructors.htm">CallConstructors</a></strong>: Use or bypass the constructor for creating objects.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/no_schema_changes.htm">DetectSchemaChanges</a></strong>: Disable/Enable schema changes detection.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/diagnostics.htm">Diagnostic</a></strong>: Add diagnostic-listeners.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/exceptionsonnotstorable.htm">ExceptionsOnNotStorable</a></strong>: Enable/Disable exceptions on not storable objects.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/intern_strings.htm">InternStrings</a></strong>: Will call the intern-method on the retrieved strings. </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/mark_transient.htm">MarkTransient</a></strong>: Configure a <span class="PrimaryAnnotation">Attribute</span> for marking fields as transient.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/message_level.htm">MessageLevel</a></strong>: Configure the logging-message level.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/name_provider.htm">NameProvider</a></strong>: Configure the toString() value of the object-container.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="objectclass_configuration.htm">ObjectClass</a></strong>: Configure class-specific settings.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/disable_optimize_nq.htm">OptimizeNativeQueries</a></strong>: Enable runtime query optimization.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/out_stream.htm">OutStream</a></strong>: Configure the log message output stream</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/query_modes.htm">Queries</a></strong>: Configure query behaviors</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="../advanced_topics/db4o_reflection_api.htm">ReflectWith</a></strong>: Configure a reflector.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="../advanced_topics/type_handling/typehandlers.htm">RegisterTypeHandler</a></strong>: Register a new TypeHandler.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep">Required</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/string_encoding.htm">StringEncoding</a></strong>: Configure the string-encoding.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep">Required</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd">Yes</td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/no_test_instances.htm">TestConstructors</a></strong>: Configure if db4o checks for valid constructors.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/update_depth.htm">UpdateDepth</a></strong>: Change the update-depth.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"><strong><a href="common/weak_reference_collection_interval.htm">WeakReferenceCollectionInterval</a></strong>: Change the weak-reference cleanup interval. Default setting is 1000 milliseconds.</td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowSep_ColEnd"> </td>
</tr>
<tr>
<td class="TableStyle_Basic_Body_0_0_RowEnd_ColSep"><strong><a href="common/disable_weak_references.htm">WeakReferences</a></strong>: Enable/disable weak references.</td>
<td class="TableStyle_Basic_Body_0_0_RowEnd_ColSep"> </td>
<td class="TableStyle_Basic_Body_0_0_RowEnd_ColEnd"> </td>
</tr>
</tbody>
</table>
<h2>Additional Configuration Items</h2>
<p>There are additional configuration items which add for additional features. You can add then on the common-configuration. For example to enable transparent persistence you add the TransparentPersistenceSupport configuration item. Take a look a the available configuration items. <a href="common/configuration_items.htm" target="" title="" alt="" class="MCXref" xrefformat="See "{paratext}"">See "Common Configuration Items"</a></p>
<p> </p>
<script type="text/javascript" src="../SkinSupport/MadCapBodyEnd.js">
</script>
</body>
</html>
