diff --git a/doc/reference/src/objects.xml b/doc/reference/src/objects.xml index 23a9a54d..5faa9a11 100644 --- a/doc/reference/src/objects.xml +++ b/doc/reference/src/objects.xml @@ -4969,11 +4969,10 @@ cfg.PostProcessObjectFactory(factory); of the box, Spring.NET supports a number of variable sources that allow users to obtain variable values from .NET config files, java-style property files, environment variables, command line - arguments and the registry and the new connection strings - configuration section in .NET 2.0. It is possible to add your own - variable sources to a VariablePlaceholderConfigurer - by implementing the IVariableSource - interface. + arguments, the registry and the new connection strings configuration + section in .NET 2.0. It is possible to add your own variable sources + to a VariablePlaceholderConfigurer by implementing + the IVariableSource interface. You use this by defining an instance of Spring.Objects.Factory.Config.VariablePlaceholderConfigurer @@ -5043,19 +5042,18 @@ cfg.PostProcessObjectFactory(factory); By simply configuring the appropriate section, you can use the ConfigSectionVariableSource to retrieve variables from application settings and user settings. Assuming your - application's root namespace is - Spring.IocQuickStart, then your application- and - user settings can be loaded as variables by configuring the - following variable sources: + application's root namespace is MyApp, then your + application- and user settings can be loaded as variables by + configuring the following variable sources: <!-- From .net's ApplicationSettings: --> <object type="Spring.Objects.Factory.Config.ConfigSectionVariableSource, Spring.Core"> - <property name="SectionNames" value="applicationSettings/Spring.IocQuickStart.Properties.Settings" /> + <property name="SectionNames" value="applicationSettings/MyApp.Properties.Settings" /> </object> <!-- From .net's UserSettings: --> <object type="Spring.Objects.Factory.Config.ConfigSectionVariableSource, Spring.Core"> - <property name="SectionNames" value="userSettings/Spring.IocQuickStart.Properties.Settings" /> + <property name="SectionNames" value="userSettings/MyApp.Properties.Settings" /> </object> @@ -5076,7 +5074,7 @@ cfg.PostProcessObjectFactory(factory); A PropertyFileVariableSource allows to read properties defined in a Java-style property file as variables. Assume a file named application.properties in - your application folder containing: + your application folder containing the following lines: joan_name=Joan Harris joan_age=35 @@ -5147,16 +5145,15 @@ joan_age=35 <literal>EnvironmentVariableSource</literal> You can configure an - EnvironmentVariableSource an to retrieve - variables from environment variables available through EnvironmentVariableSource to retrieve variables + from environment variables available through .NET's System.Environment class: <object type="Spring.Objects.Factory.Config.EnvironmentVariableSource, Spring.Core" /> - To retrieve a value for a variable named - ken_name, the + To resolve a variable named ken_name, the EnvironmentVariableSource will directly call System.Environment.GetEnvironmentVariable("ken_name"). @@ -5164,15 +5161,15 @@ joan_age=35 <literal>ConnectionStringsVariableSource</literal> - Visual Studio has good support for configuring database - connection strings in a connectionStrings section - in you application configuration file. You can retrieve these - connections as variables by configuring a + Visual Studio has support for configuring database connection + strings in a connectionStrings section in your + application configuration file. You can retrieve these connections + as variables by configuring a ConnectionStringsVariableSource: <object type="Spring.Objects.Factory.Config.ConnectionStringsVariableSource, Spring.Core" /> - Assume the following connection string section in your + Assuming the following connection strings section in your application configuration file: <connectionStrings> @@ -5182,7 +5179,7 @@ joan_age=35 </connectionStrings> Then you would use the variables as in following object - definition: + definition: <object type="Example.MyClass, MyAssembly"> <property name="ConnectionString" value="${myConnection.connectionString}" /> @@ -5195,12 +5192,11 @@ joan_age=35 connection name to get the provider name. When adding a connection using Visual Studio's application - settings, your connection will be named similar to - MyNamespace.Properties.Settings.myConnection - and the corresponding variable name for the connection string - would become - MyNamespace.Properties.Settings.myConnection.connectionString. - + settings user interface, your connection will be named similar + to MyApp.Properties.Settings.myConnection and + the corresponding variable name for the connection string would + become + MyApp.Properties.Settings.myConnection.connectionString. @@ -5224,7 +5220,7 @@ joan_age=35 Any entry in the System.Environment.SpecialFolder - enumeration can be used as a variable name. + enumeration can be used as a variable name. @@ -5233,8 +5229,8 @@ joan_age=35 The IVariableSource is the base interface for providing the ability to get the value of property placeholders - (name-value) pairs from a variety of sources. The IVariableSource - interface is shown below: + (name-value) pairs from a variety of sources. The + IVariableSource interface is shown below: public interface IVariableSource {