=======================
Element **autoService**
=======================

.. contents::
  :local:
  :depth: 5
     

The XML configuration file has an element **autoService** that can appear in any order under "iocConfiguration/dependencyInjection/autoGeneratedServices" and "iocConfiguration/pluginsSetup/pluginSetup/dependencyInjection/autoGeneratedServices" elements for providing instructions to **IoC.Configuration** to auto-generate an implementation for an interface.

.. note::
    Refer to :doc:`../../sample-files/IoCConfiguration_autoService.generated` and tests in `AutoServiceSuccessfulLoadTests.cs <https://github.com/artakhak/IoC.Configuration/blob/master/IoC.Configuration.Tests/AutoService/AutoServiceSuccessfulLoadTests.cs>`_ for more examples on **autoService** element.

Consider the interface **IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory** below, that extends **IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactoryBase**:

.. code-block:: csharp
    :linenos:

    namespace IoC.Configuration.Tests.AutoService.Services
    {
        public interface IActionValidatorFactoryBase
        {
            IReadOnlyList<IActionValidator> GetValidators(int actionTypeId, string projectGuid);
        }

        public interface IActionValidatorFactory : IActionValidatorFactoryBase
        {
            Guid PublicProjectId { get; }
            IActionValidator DefaultActionValidator { get; }
            IReadOnlyList<IActionValidator> GetValidators(ActionTypes actionType, Guid projectGuid);
            void SomeMethodNotInConfigFile(int param1, string param2);
            int SomePropertyNotInConfigFile { get; }
        }
    }

We want to configure auto-generation of **IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory** in configuration file.

However, we are interested only in specifying the auto-generation of properties **IActionValidatorFactory.DefaultActionValidator** and **IActionValidatorFactory.PublicProjectId**, as well as in auto-generation of two overloaded methods
**IActionValidatorFactory.GetValidators(ActionTypes actionType, Guid projectGuid)** and **IActionValidatorFactoryBase.GetValidators(int actionTypeId, string projectGuid)**.

We can use child elements **autoProperty** and **autoMethod** to specify the implementation of methods and properties in interface **IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory** and its parents (i.e., in this case **IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactoryBase**).

**IoC.Configuration** will generate default implementations for methods and properties, for which no auto-implementation is configured under element **autoService**. For example method **SomeMethodNotInConfigFile()** is not configured in example below, so the generated implementation will return **default(System.Int32)**.

.. note::
    More details on **autoProperty** and **autoMethod** elements  are provided at :doc:`./auto-property` and :doc:`./auto-method`

.. code-block:: xml
    :linenos:

    <dependencyInjection>
        <!--Some other service bindings specified here-->
        <autoGeneratedServices>
            <autoService interface="IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory">

                <autoProperty name="DefaultActionValidator"
                              returnType="SharedServices.Interfaces.IActionValidator">
                    <injectedObject
                            type="IoC.Configuration.Tests.AutoService.Services.ActionValidatorDefault"/>
                </autoProperty>

                <autoProperty name="PublicProjectId" returnType="System.Guid">
                    <object type="System.Guid" value="95E352DD-5C79-49D0-BD51-D62153570B61"/>
                </autoProperty>

                <autoMethod name="GetValidators"
                            returnType="System.Collections.Generic.IReadOnlyList[SharedServices.Interfaces.IActionValidator]"
                            reuseValue="true">
                    <methodSignature>
                        <!--paramName attribute is optional, however it
                        makes the auto-implementation more readable. -->
                        <object paramName="actionType" typeRef="ActionTypes"/>
                        <object paramName="projectGuid" type="System.Guid"/>
                    </methodSignature>

                    <if parameter1="_classMember:SharedServices.DataContracts.ActionTypes.ViewFilesList"
                        parameter2="8663708F-C707-47E1-AEDC-2CD9291AD4CB">
                        <collection>

                            <constructedValue type="SharedServices.Implementations.ActionValidator1">
                                <parameters>
                                    <int32 name="intParam" value="7"/>
                                </parameters>
                            </constructedValue>

                            <injectedObject type="SharedServices.Implementations.ActionValidator3"/>

                            <!--Plugin1ActionValidator belongs to Plugin1. If we disable this plugin,
                                the injectedObject element below will not be included in
                              returned collection.-->
                            <injectedObject type="TestPluginAssembly1.Implementations.Plugin1ActionValidator"/>
                        </collection>
                    </if>

                    <if parameter1="_classMember:SharedServices.DataContracts.ActionTypes.ViewFileContents"
                        parameter2="F981F171-B382-4F15-A8F9-FE3732918D3F">
                        <collection>
                            <injectedObject type="SharedServices.Implementations.ActionValidator1"/>
                        </collection>
                    </if>

                    <!--If none of conditions above are true, the default value will be returned by
                    interface implementation.-->
                    <default>
                        <collection>
                            <!--We can also call a method or property in auto-generated interface, or in
                                one of its base interfaces.-->
                            <classMember class="IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory"
                                         memberName="DefaultActionValidator"/>

                            <injectedObject type="SharedServices.Implementations.ActionValidator3"/>

                            <injectedObject type="DynamicallyLoadedAssembly2.ActionValidator4"/>
                        </collection>
                    </default>
                </autoMethod>

                <!--Overloaded method GetValidators uses parameters of types System.Int32 and System.string,
                    instead of SharedServices.DataContracts.ActionTypes and System.Guid, as in case above.-->
                <autoMethod name="GetValidators"
                            returnType="System.Collections.Generic.IReadOnlyList[SharedServices.Interfaces.IActionValidator]">
                    <methodSignature>
                        <!--paramName attribute is optional, however it makes the auto-implementation
                            more readable. -->
                        <int32 paramName="actionTypeId"/>
                        <string paramName="projectGuid"/>
                    </methodSignature>

                    <!-- Attributes parameter1 and parameter2 map values of parameters param1 and param2 in
                        GetInstances() method to returned values. -->
                    <if parameter1="0" parameter2="8663708F-C707-47E1-AEDC-2CD9291AD4CB">
                        <collection>
                            <injectedObject type="SharedServices.Implementations.ActionValidator3"/>
                            <injectedObject type="IoC.Configuration.Tests.AutoService.Services.ActionValidator4"/>
                        </collection>
                    </if>

                    <default>
                        <collection>
                            <!--We can also call a method or property in auto-generated interface, or
                                in one of its base interfaces.-->
                            <classMember class="IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory"
                                         memberName="DefaultActionValidator"/>
                            <injectedObject type="SharedServices.Implementations.ActionValidator3"/>
                            <classMember class="IoC.Configuration.Tests.AutoService.Services.StaticAndConstMembers"
                                         memberName="GetDefaultActionValidator"/>
                            <classMember class="IoC.Configuration.Tests.AutoService.Services.IActionValidatorValuesProvider"
                                         memberName="AdminLevelActionValidator"/>
                        </collection>
                    </default>
                </autoMethod>
            </autoService>
        </autoGeneratedServices>
    </dependencyInjection>

Explanation of **autoMethod** for method **IActionValidatorFactory.GetValidators(...)** above
---------------------------------------------------------------------------------------------

The **autoMethod** element above for method **System.Collections.Generic.IReadOnlyList<SharedServices.Interfaces.IActionValidator> IActionValidatorFactory.GetValidators(ActionTypes actionType, Guid projectGuid)** instructs **IoC.Configuration** to generate such an implementation that:

 - If actionType==SharedServices.DataContracts.ActionTypes.ViewFilesList.ViewFilesList and projectGuid=="8663708F-C707-47E1-AEDC-2CD9291AD4CB", then collection of three objects will be returned of the following types: **SharedServices.Implementations.ActionValidator1**, **SharedServices.Implementations.ActionValidator3**, and **TestPluginAssembly1.Implementations.Plugin1ActionValidator**.

 - If actionType==SharedServices.DataContracts.ActionTypes.ViewFilesList.ViewFileContents and projectGuid=="F981F171-B382-4F15-A8F9-FE3732918D3F", then collection of one object will be returned of type **SharedServices.Implementations.ActionValidator1**.

 - For all other values of parameters, collection of three objects specified under **default** element will be returned.

Some notes:
-----------

 - The service type in **autoService** element that is specified using attribute **interface** or **interfaceRef** should be an interface.
    .. note::
        Attribute **interfaceRef**  is used to reference a type declared in **typeDefinition** element.

 - **IoC.Configuration** will setup a singleton type binding to map the interface specified in **autoService** element to the auto-generated implementation.

 - To use the autogenerated implementation, just inject the interface (in this case **DynamicallyLoadedAssembly2.IActionValidatorFactory1**) using constructor or property injection.

 - **IoC.Configuration** allows configuring auto-implemented properties and methods from the interface specified in **autoService** element, as well as from any of its parent or ancestor interfaces.


Using auto-generated implementation
-----------------------------------

Here is an example of using the auto-generated implementation for **DynamicallyLoadedAssembly2.IActionValidatorFactory1**:

.. code-block:: csharp

    public class TestActionValidatorFactory1
    {
        public TestActionValidatorFactory1(
            IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory actionValidatorFactory)
        {
            var actionValidatorsList = actionValidatorFactory.GetValidators(
                                            ActionTypes.ViewFilesList,
                                            Guid.Parse("95E352DD-5C79-49D0-BD51-D62153570B61"))


            Assert.AreEqual(3, actionValidatorsList.Count);
            Assert.IsInstanceOfType(actionValidatorsList[0],
                                    typeof(SharedServices.Implementations.ActionValidator1));

            Assert.IsInstanceOfType(actionValidatorsList[1],
                                                typeof(SharedServices.Implementations.ActionValidator3));

            Assert.IsInstanceOfType(actionValidatorsList[2],
                                                typeof(TestPluginAssembly1.Implementations.Plugin1ActionValidator));
        }
    }


Element **autoMethod**
----------------------

Element **autoMethod** is used to configure the auto-generated implementation of a method in interface specified in element **autoService**.

An example of **autoMethod** elements is provided in :doc:`index`. In this section some specifics of this element will be provided.

The format of **autoMethod**
============================

Method name and return type in **autoMethod**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Method name is specified using the attribute **name**.
- Method return value type is specified using the attribute **returnType** and optional attribute **assembly**, or alternatively using attribute **returnTypeRef** to reference a type defined in sole **/iocConfiguration/typeDefinitions/typeDefinition** element.
    .. note::
        Even though we only need the method name and signature, to identify the method, the return type makes the configuration more readable. Also, the return type serves as an additional way to identify the method, if a method with similar name and signature exists in multiple extended interfaces.

The example below demonstrates how method name and return type are specified:

.. code-block:: xml
    :linenos:

    <autoMethod name="GetValidators"
                returnType="System.Collections.Generic.IReadOnlyList[SharedServices.Interfaces.IActionValidator]">

        <!--method signature and return value elements go here...-->
    </autoMethod>

Method signature
~~~~~~~~~~~~~~~~

Child element **methodSignature** is used to specify the auto-implemented method signature.

If the method has no parameters, no **methodSignature** element is necessary. Otherwise, this element should be present, which should list the method parameters.

The example below demonstrates how method signature is specified:

.. code-block:: xml
    :linenos:

    <!--autoMethod below is a configuration for a C# method
    System.Collections.Generic.IReadOnlyList[SharedServices.Interfaces.IActionValidator] GetValidators(
                            SharedServices.DataContracts.ActionTypes actionType,
                            System.Guid projectGuid,
                            int someIntParam)-->
    <autoMethod name="GetValidators"
                returnType="System.Collections.Generic.IReadOnlyList[SharedServices.Interfaces.IActionValidator]">

        <methodSignature>
            <!--paramName attribute is optional, however it
                makes the auto-implementation more readable. -->
            <object paramName="actionType" typeRef="ActionTypes"/>
            <object paramName="projectGuid" type="System.Guid"/>
            <int32 paramName="someIntParam" />
        </methodSignature>

        <!--return value elements go here..-->
    </autoMethod>


Specifying the return values
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Return values are specified by using any number of optional **if** elements, followed by required **default** element.

- Specifying a return value using element **if**

    Element **if** is used to specify a return value by providing values for up to 10 parameters using attributes **parameter1**, **parameter2**, ..., **parameter10**.

    Attribute **parameter1**  corresponds to the first parameter in **methodSignature** element, attribute **parameter2** corresponds to the second parameter in **methodSignature** element, and so on.

    The number of parameter attributes should be the same as the number of parameters in element **methodSignature**.

    The method auto-implemented by **IoC.Configuration** will return the value specified in child element of **if** element, if parameters in method call are equal to the values in attributes **parameter1**, **parameter2**, etc.
        .. note::
            The child of **if** element should be a value initializer element, such as **collection**, **int32**, **constructedValue**, **injectedObject**, etc. Refer to :doc:`../value-initialization-elements/index` for more details on value initializer elements.

    The value of parameter attribute is one of the following:

        - A value that will be de-serialized by a parameter serializer to a value of the parameter (example <if parameter1="15.3">).

            .. note::
                Refer to :doc:`../parameter-serializers` for more details on parameter serializers.

            Example (see **parameter2** with value "**8663708F-C707-47E1-AEDC-2CD9291AD4CB**"):

            .. code-block:: xml

                <!--The generated code will return a collection with two items of types
                    SharedServices.Implementations.ActionValidator1 and SharedServices.Implementations.ActionValidator3
                    if the first parameter value is SharedServices.DataContracts.ActionTypes.ViewFilesList, and the second parameter
                    value is a Guid "8663708F-C707-47E1-AEDC-2CD9291AD4CB" (note, this value will be serialized to System.Guid,
                    if the parameter is of type System.Guid).
                -->
                <if parameter1="_classMember:SharedServices.DataContracts.ActionTypes.ViewFilesList"
                    parameter2="8663708F-C707-47E1-AEDC-2CD9291AD4CB">
                    <collection>
                        <injectedObject type="SharedServices.Implementations.ActionValidator1" />
                        <injectedObject type="SharedServices.Implementations.ActionValidator3" />
                    </collection>
                </if>

        - A class member specified by using prefix **_classMember** followed by class member path. Class member path is the full name of the type (or the type alias for some type defined in **iocConfiguration/typeDefinitions/typeDefinition** element), followed by class member name.

            .. note::
                Refer to :doc:`../value-initialization-elements/class-member` for more details on how class members are resolved.

            .. note::
                Class member can be can be a member in the auto-generated service as well.

            Example (see **parameter1** with value "**_classMember:ActionTypes.ViewFileContents**"):

            .. code-block:: xml

                <!--The generated code will return a collection with one items of type
                    SharedServices.Implementations.ActionValidator1, if the first parameter
                    value is SharedServices.DataContracts.ActionTypes.ViewFileContents, and the second parameter
                    value is a Guid "F981F171-B382-4F15-A8F9-FE3732918D3F" (note, this value will be serialized to
                    System.Guid, if the parameter is of type System.Guid).
                -->
                <if parameter1="_classMember:ActionTypes.ViewFileContents"
                    parameter2="F981F171-B382-4F15-A8F9-FE3732918D3F">
                    <collection>
                        <injectedObject type="SharedServices.Implementations.ActionValidator1" />
                    </collection>
                </if>

        - A setting value specified by using prefix **_settings** followed by a setting name. A general, or plugin setting with specified name should exist in configuration file.

            .. note::
                Refer to :doc:`../settings` or :doc:`../plugins` for more details on general and plugin settings.

            Example (see **parameter2** with value "_settings:Project1Guid"):

            .. code-block:: xml

                <!--The generated code will return a collection with one item of type
                    SharedServices.Implementations.ActionValidator3, if the first parameter
                    value is SharedServices.DataContracts.ActionTypes.ViewFileContents, and the second parameter
                    is equal to the value of setting named **Project1Guid**.
                -->
                <if parameter1="_classMember:ActionTypes.ViewFileContents"
                    parameter2="_settings:Project1Guid">
                    <collection>
                        <injectedObject type="SharedServices.Implementations.ActionValidator3" />
                    </collection>
                </if>


- Specifying a return value using element **default**

    Element **default** is is used to specify a value to return, if none of the conditions specified in **if** elements is **true**, or if no **if** element is present.

    **IoC.Configuration** will return the value specified in child of **default** element.
        .. note::
            The child of **default** element should be a value initializer element, such as **collection**, **int32**, **constructedValue**, **injectedObject**, etc. Refer to :doc:`../value-initialization-elements/index` for more details on value initializer elements.

    **Example:**

    .. code-block:: xml

        <autoService interface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo">
            <!--GetIntValues(): IReadOnlyList<int> GetIntValues(int param1, string param2)-->
            <autoMethod name="GetIntValues" returnType="System.Collections.Generic.IReadOnlyList[System.Int32]" >
                <methodSignature>
                    <int32 paramName="param1"/>
                    <string paramName="param2"/>
                </methodSignature>
                <if parameter1="1" parameter2="str1">
                    <collection>
                        <int32 value="17"/>
                    </collection>
                </if>
                <default>
                    <collection>
                        <int32 value="18"/>
                        <int32 value="19"/>
                    </collection>
                </default>
            </autoMethod>
            <!--Some other autoMethod and autoproperty elements go here-->
        </autoService>

Referencing the auto-implemented method parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Element **parameterValue** is used to reference a parameter value in auto-implemented method of auto-generated service.

This element can be used only under elements **if** or **default** under element **autoMethod**.

The element uses an attribute **paramName** to reference the parameter of auto-generated method.
A parameter with this name should be declared under element **../autoService/autoMethod/methodSignature**.

**Example:**

.. code-block:: xml
    :linenos:

    <autoGeneratedServices>
      <!--Demo of referencing auto-implemented method parameters using
          parameterValue element-->
      <autoService
        interface="IoC.Configuration.Tests.AutoService.Services.IAppInfoFactory">

        <autoMethod name="CreateAppInfo"
                    returnType="IoC.Configuration.Tests.AutoService.Services.IAppInfo">

          <methodSignature>
            <int32 paramName="appId"/>
            <string paramName="appDescription"/>
          </methodSignature>

          <default>
            <constructedValue
                type="IoC.Configuration.Tests.AutoService.Services.AppInfo">
              <parameters>
                <!--The value of name attribute is the name of constructor parameter
                    in AppInfo-->
                <!--
                The value of paramName attribute is the name of parameter in
                IAppInfoFactory.CreateAppInfo.
                This parameter should be present under autoMethod/methodSignature element.
                -->
                <!--In this example the values of name and paramName are similar, however
                    they don't have to be.-->
                <parameterValue name="appId" paramName="appId" />
                <parameterValue name="appDescription" paramName="appDescription" />
              </parameters>
            </constructedValue>
          </default>
        </autoMethod>
      </autoService>
    </autoGeneratedServices>


Caching the returned values
~~~~~~~~~~~~~~~~~~~~~~~~~~~

If constructing the object returned by the function is time consuming, an optional attribute **reuseValue** in element **autoMethod** can be used to cache the returned values.

**Example:**

.. code-block:: xml
    :linenos:

    <autoService
        interface="TestPluginAssembly1.Interfaces.IResourceAccessValidatorFactory">
        <autoMethod name="GetValidators"
                    returnTypeRef="IEnumerableOfIResourceAccessValidator"
                    reuseValue="true" >
          <!--method signature and return value elements go here...-->
        </autoMethod>
        <!--Some other autoMethod and autoProperty elements go here -->
    </autoService>

Resolving conflicts by using **declaringInterface** in **autoMethod**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If the auto-implemented method with the specified name, signature, and return type is not in auto-implemented interface, but is present in multiple parent interfaces, **IoC.Configuration** will report an error, since it will not know which method the configuration refers to.

In such rare cases an attribute **declaringInterface** can be used to specify explicitly the parent interface, where the method is declared.

**Example:**

    .. code-block:: xml
        :linenos:

        <!--
        IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo demonstrates cases
        when there are multiple occurrences of auto-generated methods and properties with
        same signatures and return types in its base interfaces.
        -->
        <autoService interface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo">

            <!--GetIntValues(): IReadOnlyList<int> GetIntValues(int param1, string param2)-->
            <autoMethod name="GetIntValues"
                        returnType="System.Collections.Generic.IReadOnlyList[System.Int32]" >
                <methodSignature>
                    <int32 paramName="param1"/>
                    <string paramName="param2"/>
                </methodSignature>
                <if parameter1="1" parameter2="str1">
                    <collection>
                      <int32 value="17"/>
                    </collection>
                </if>
                <default>
                    <collection>
                        <int32 value="18"/>
                        <int32 value="19"/>
                    </collection>
                </default>
            </autoMethod>

            <!--
            This method is declared in IMemberAmbiguityDemo_Parent3, which is a base interface for
            IMemberAmbiguityDemo.
            We can provide implementation for this interface, even though it has a similar signature
            and return type as the method
            IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo.GetIntValues.
            By using the attribute 'declaringInterface', we make a distinction between these two.
            -->
            <autoMethod name="GetIntValues"
                        returnType="System.Collections.Generic.IReadOnlyList[System.Int32]"
                        declaringInterface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo_Parent3">
                <methodSignature>
                    <int32 paramName="param1"/>
                    <string paramName="param2"/>
                </methodSignature>
                <default>
                    <collection>
                        <int32 value="3"/>
                    </collection>
                </default>
            </autoMethod>
        </autoService>


Element **autoProperty**
------------------------

Element **autoProperty** is used to configure the auto-generated implementation of a property in interface specified in element **autoService**.

An example of **autoProperty** elements is provided in :doc:`index`. In this section some specifics of this element will be provided.

The Format of **autoProperty**
==============================

Property name and return type in **autoProperty**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Property name is specified using the attribute **name**.
- Property return value type is specified using the attribute **returnType** and optional attribute **assembly**, or alternatively using attribute **returnTypeRef** to reference a type defined in some **/iocConfiguration/typeDefinitions/typeDefinition** element.
    .. note::
        Even though we only need the property name, to identify the property, the return type makes the configuration more readable. Also, the return type serves as an additional way to identify the property, if a property with similar name exists in multiple extended interfaces.

Specifying the returned value
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The property auto-generated by **IoC.Configuration** will return the value specified in child of **autoProperty** element.

The child of **autoProperty** element should be a value initializer element, such as **collection**, **int32**, **constructedValue**, **injectedObject**, etc.
    .. note::
       Refer to :doc:`../value-initialization-elements/index` for more details on value initializer elements.

**Example:**

.. code-block:: xml
    :linenos:

    <autoService interface="IoC.Configuration.Tests.AutoService.Services.IActionValidatorFactory">
        <autoProperty name="PublicProjectId" returnType="System.Guid" >
            <object type="System.Guid" value="95E352DD-5C79-49D0-BD51-D62153570B61"/>
        </autoProperty>
    </autoService>


Resolving conflicts by using **declaringInterface** in **autoProperty**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If the auto-implemented property with the specified name, and return type is not in auto-implemented interface, but is present in multiple parent interfaces, **IoC.Configuration** will report an error, since it will not know which property the configuration refers to.

In such rare cases an attribute **declaringInterface** can be used to specify explicitly the parent interface, where the property is declared.

Example:

    .. code-block:: xml
        :linenos:

        <!--
        IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo demonstrates
        cases when there are multiple occurrences of auto-generated methods and properties
        with same signatures and return types in base interfaces of
        IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo.
        -->
        <autoService interface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo">
            <!--
            Both IMemberAmbiguityDemo_Parent1 and IMemberAmbiguityDemo_Parent2 have properties called DefaultDbConnection
            with the same return types. We can auto-implement this property for each of these interfaces by using
            declaringInterface attribute in autoProperty element to explicitly specify the interface that own
            the property (declaringInterface can be used in autoMethod as well as demonstrated above)
            -->
            <!--Auto-implementation of IMemberAmbiguityDemo_Parent1.DefaultDbConnection-->
            <autoProperty name="DefaultDbConnection"
                          returnType="SharedServices.Interfaces.IDbConnection"
                          declaringInterface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo_Parent1">
                <constructedValue type="SharedServices.Implementations.SqliteDbConnection">
                    <parameters>
                        <string name="filePath" value="c:\IMemberAmbiguityDemo_Parent1_Db.sqlite"/>
                    </parameters>
                </constructedValue>
            </autoProperty>

            <!--Auto-implementation of IMemberAmbiguityDemo_Parent2.DefaultDbConnection-->
            <autoProperty name="DefaultDbConnection"
                          returnType="SharedServices.Interfaces.IDbConnection"
                          declaringInterface="IoC.Configuration.Tests.AutoService.Services.IMemberAmbiguityDemo_Parent2">
                <constructedValue type="SharedServices.Implementations.SqliteDbConnection">
                    <parameters>
                        <string name="filePath" value="c:\IMemberAmbiguityDemo_Parent2_Db.sqlite"/>
                    </parameters>
                </constructedValue>
            </autoProperty>
        </autoService>