Update README.md (oracle#324)

Author: alexkeh

samples/README.md

@@ -26,142 +26,147 @@ Below is the feature list the samples cover. Each feature's sample has its own s
 
 Application Continuity
 ----------------------
-Sample 1: Unmanaged ODP.NET Application Continuity code sample with setup and runtime demo instructions.
+* Sample 1: Unmanaged ODP.NET Application Continuity code sample with setup and runtime demo instructions.
 
 Parameter Array Binding
 ----------------------
-Sample 1: Demonstrates parameter array binding.
+* Sample 1: Demonstrates parameter array binding.
 
 ASP.NET Core
 ------------
-ASP.NET Core 2.x: Demonstrates a simple ASP.NET Core 2.x web app to connect and retrieve data. <br>
-ASP.NET Core 3.x: Demonstrates a simple ASP.NET Core 3.x web app to connect and retrieve data. <br>
-ASP.NET Core 6: Demonstrates a simple ASP.NET Core 6 web app to connect and retrieve data. 
+* ASP.NET Core 2.x: Demonstrates a simple ASP.NET Core 2.x web app to connect and retrieve data. <br>
+* ASP.NET Core 3.x: Demonstrates a simple ASP.NET Core 3.x web app to connect and retrieve data. <br>
+* ASP.NET Core 6: Demonstrates a simple ASP.NET Core 6 web app to connect and retrieve data. 
 
 PL/SQL Associative Array
 ------------------------
-Sample 1: Demonstrates PL/SQL Associative Array binding.
+* Sample 1: Demonstrates PL/SQL Associative Array binding.
+
+Async
+-----
+* Async Sample: Demonstrates using asynchronous ODP.NET (managed or core) and times its execution time.<br>
+* Sync Sample: Demonstrates using synchronous ODP.NET (managed or core) and times its execution time.
 
 Autonomous Database
 -------------------
-ODP.NET Core Samples: Demonstrates how to connect ODP.NET Core to Oracle Autonomous Database via a console and an ASP.NET Core web app. <br>
-Managed ODP.NET Samples: Demonstrates how to connect managed ODP.NET to Oracle Autonomous Database via a console and an ASP.NET web app. <br>
-Unmanaged ODP.NET Sample: Demonstrates how to connect unmanaged ODP.NET to Oracle Autonomous Database via a console app.
+* ODP.NET Core Samples: Demonstrates how to connect ODP.NET Core to Oracle Autonomous Database via a console and an ASP.NET Core web app. <br>
+* Managed ODP.NET Samples: Demonstrates how to connect managed ODP.NET to Oracle Autonomous Database via a console and an ASP.NET web app. <br>
+* Unmanaged ODP.NET Sample: Demonstrates how to connect unmanaged ODP.NET to Oracle Autonomous Database via a console app.
 
 Azure Active Directory
 ----------------------
-Demonstrates connecting to Oracle Autonomous Database using an Azure Active Directory token with ODP.NET Core, managed, and unmanaged.
+* Demonstrates connecting to Oracle Autonomous Database using an Azure Active Directory token with ODP.NET Core, managed, and unmanaged.
 
 Bulk Copy
 ---------
-Sample 1: Demonstrates how to use ODP.NET bulk copy. Sample works for both managed and core ODP.NET.
+* Sample 1: Demonstrates how to use ODP.NET bulk copy. Sample works for both managed and core ODP.NET.
 
 Client Factory
 --------------
-Sample 1: Demonstrates how to use the OracleClientFactory class.
+* Sample 1: Demonstrates how to use the OracleClientFactory class.
 
 Command Builder
 ---------------
-Sample 1: Demonstrates OracleCommandBuilder's SchemaSeparator property. <br>
-Sample 2: Demonstrates OracleCommandBuilders's QuoteIdentifier method. <br>
-Sample 3: Demonstrates OracleCommandBuilders's UnquoteIdentifier method.
+* Sample 1: Demonstrates OracleCommandBuilder's SchemaSeparator property. <br>
+* Sample 2: Demonstrates OracleCommandBuilders's QuoteIdentifier method. <br>
+* Sample 3: Demonstrates OracleCommandBuilders's UnquoteIdentifier method.
 
 Configuration API
 -----------------
-Samples demonstrate how to use the OracleConfiguration, OracleDataSourceCollection, and OracleOnsServerCollection classes.
+* Samples demonstrate how to use the OracleConfiguration, OracleDataSourceCollection, and OracleOnsServerCollection classes.
 
 Connection
 ----------
-Sample 1: Demonstrates OracleConnection's GetSchema() method. <br>
-Sample 2: Demonstrates all variations of OracleConnection's GetSchema(string) method overload. <br>
-Sample 3: Demonstrates all variations of OracleConnection's GetSchema(string, string[]) method overload.
+* Sample 1: Demonstrates OracleConnection's GetSchema() method. <br>
+* Sample 2: Demonstrates all variations of OracleConnection's GetSchema(string) method overload. <br>
+* Sample 3: Demonstrates all variations of OracleConnection's GetSchema(string, string[]) method overload.
 
 Connection String Builder
 -------------------------
-Sample 1: Demonstrates how to use the OracleConnectionStringBuilder class.
+* Sample 1: Demonstrates how to use the OracleConnectionStringBuilder class.
 
 DataReader
 ----------
-Unmanaged ODP.NET Sample: Demonstrates OracleDataReader's VisibleFieldCount and HiddenFieldCount properties. <br>
-ODP.NET Core Sample: Demonstrates how to connect and retrieve data using ODP.NET Core via a console app.
+* Unmanaged ODP.NET Sample: Demonstrates OracleDataReader's VisibleFieldCount and HiddenFieldCount properties. <br>
+* ODP.NET Core Sample: Demonstrates how to connect and retrieve data using ODP.NET Core via a console app.
 
 Data Source Enumerator
 ----------------------
-Sample 1: Demonstrates the functionality of OracleDataSourceEnumerator class.
+* Sample 1: Demonstrates the functionality of OracleDataSourceEnumerator class.
 
 DataSet
 -------
-Sample 1: Demonstrates data manipulation language (DML) operations on a Dataset. <br>
-Sample 2: Demonstrates how to populate a DataSet using C#. <br>
-Sample 3: Demonstrates DML operations on LOB columns. <br>
-Sample 4: Demonstrates how to populate a DataSet from multiple output Ref Cursors from a stored procedure. <br>
-Sample 5: Demonstrates how to populate a DataSet using Visual Basic .NET (VB.NET).
+* Sample 1: Demonstrates data manipulation language (DML) operations on a Dataset. <br>
+* Sample 2: Demonstrates how to populate a DataSet using C#. <br>
+* Sample 3: Demonstrates DML operations on LOB columns. <br>
+* Sample 4: Demonstrates how to populate a DataSet from multiple output Ref Cursors from a stored procedure. <br>
+* Sample 5: Demonstrates how to populate a DataSet using Visual Basic .NET (VB.NET).
 
 Entity Framework Core
 ---------------------
-Autonomous Database Sample: Demonstrates Oracle EF Core connecting to Oracle Autonomous Database. <br>
-Dependency Injection Sample: Demonstrates using dependency injection and ASP.NET Core with Oracle EF Core. <br>
-Getting Started Sample: Demonstrates a basic Oracle EF Core scenario using migrations and scaffolding. <br>
-Keyless Entity Types Sample: Demonstrates Oracle EF Core keyless entity types with relational and materialized views. <br>
-Stored Procedure Result Set Samples: Demonstrates using PL/SQL that returns either an explicitly or implicitly bound REF Cursor. 
+* Autonomous Database Sample: Demonstrates Oracle EF Core connecting to Oracle Autonomous Database. <br>
+* Dependency Injection Sample: Demonstrates using dependency injection and ASP.NET Core with Oracle EF Core. <br>
+* Getting Started Sample: Demonstrates a basic Oracle EF Core scenario using migrations and scaffolding. <br>
+* Keyless Entity Types Sample: Demonstrates Oracle EF Core keyless entity types with relational and materialized views. <br>
+* Stored Procedure Result Set Samples: Demonstrates using PL/SQL that returns either an explicitly or implicitly bound REF Cursor. 
 
 Event Handler
 -------------
-Sample 1: Demonstrates how to trap the OracleRowUpdatingEvent and OracleRowUpdatedEvent using VB.NET.
+* Sample 1: Demonstrates how to trap the OracleRowUpdatingEvent and OracleRowUpdatedEvent using VB.NET.
 
 Oracle Identity and Access Management
 -------------------------------------
-Sample 1: Demonstrates how to use OCI .NET SDK to retrieve, authenticate, and refresh Oracle database tokens.
+* Sample 1: Demonstrates how to use OCI .NET SDK to retrieve, authenticate, and refresh Oracle database tokens.
 
 JSON
 ----
-Select JSON Sample: Demonstrates row insert into and query against a JSON table. <br>
-Select JSON CLOB Sample:  Demonstrates row insert into and query against a JSON table using CLOB storage.
+* Select JSON Sample: Demonstrates row insert into and query against a JSON table. <br>
+* Select JSON CLOB Sample:  Demonstrates row insert into and query against a JSON table using CLOB storage.
 
 LOB 
 ---
-Sample 1: Demonstrates how to populate and obtain LOB data from a DataSet. <br>
-Sample 2: Demonstrates how an OracleClob object is obtained as an output parameter of an anonymous PL/SQL block. <br>
-Sample 3: Demonstrates how an OracleClob object is obtained from an output parameter of a stored procedure. <br>
-Sample 4: Demonstrates how the LOB column data can be read as a .NET type by utilizing stream reads. <br>
-Sample 5: Demonstrates how to bind an OracleClob object as a parameter and refetch the newly updated CLOB data using an OracleDataReader and an OracleClob object. <br>
-Sample 6: Demonstrates LOB updates using row-level locking. <br>
-Sample 7: Demonstrates LOB updates using result set locking. <br>
-BFile Sample: Demonstrates accessing BFILEs through ODP.NET.
+* Sample 1: Demonstrates how to populate and obtain LOB data from a DataSet. <br>
+* Sample 2: Demonstrates how an OracleClob object is obtained as an output parameter of an anonymous PL/SQL block. <br>
+* Sample 3: Demonstrates how an OracleClob object is obtained from an output parameter of a stored procedure. <br>
+* Sample 4: Demonstrates how the LOB column data can be read as a .NET type by utilizing stream reads. <br>
+* Sample 5: Demonstrates how to bind an OracleClob object as a parameter and refetch the newly updated CLOB data using an OracleDataReader and an OracleClob object. <br>
+* Sample 6: Demonstrates LOB updates using row-level locking. <br>
+* Sample 7: Demonstrates LOB updates using result set locking. <br>
+* BFile Sample: Demonstrates accessing BFILEs through ODP.NET.
 
 OpenTelemetry
 -------------
-Sample: Demonstrates using managed ODP.NET or ODP.NET Core with OpenTelemetry
+* Sample: Demonstrates using managed ODP.NET or ODP.NET Core with OpenTelemetry
 
 Performance Counters
 --------------------
-Sample 1: Demonstrates how to programmatically use ODP.NET performance counters.
+* Sample 1: Demonstrates how to programmatically use ODP.NET performance counters.
 
 Ref Cursor
 ----------
-Sample 1: Demonstrates how a REF Cursor is obtained as an OracleDataReader. <br>
-Sample 2: Demonstrates how a REF Cursor is obtained as an OracleDataReader through the use of an OracleRefCursor object. <br>
-Sample 3: Demonstrates how multiple REF Cursors can be accessed by a single OracleDataReader. <br>
-Sample 4: Demonstrates how a DataSet can be populated from a REF Cursor. The sample also demonstrates how a REF Cursor can be updated. <br>
-Sample 5: Demonstrates how a DataSet can be populated from an OracleRefCursor object. <br>
-Sample 6: Demonstrates how to populate a DataSet with multiple REF Cursors selectively. <br>
-Sample 7: Demonstrates how to selectively obtain OracleDataReader objects from REF Cursors.
+* Sample 1: Demonstrates how a REF Cursor is obtained as an OracleDataReader. <br>
+* Sample 2: Demonstrates how a REF Cursor is obtained as an OracleDataReader through the use of an OracleRefCursor object. <br>
+* Sample 3: Demonstrates how multiple REF Cursors can be accessed by a single OracleDataReader. <br>
+* Sample 4: Demonstrates how a DataSet can be populated from a REF Cursor. The sample also demonstrates how a REF Cursor can be updated. <br>
+* Sample 5: Demonstrates how a DataSet can be populated from an OracleRefCursor object. <br>
+* Sample 6: Demonstrates how to populate a DataSet with multiple REF Cursors selectively. <br>
+* Sample 7: Demonstrates how to selectively obtain OracleDataReader objects from REF Cursors.
 
 Statement Cache
 ---------------
-Sample 1: Demonstrates performance improvement when statement caching is enabled.
+* Sample 1: Demonstrates performance improvement when statement caching is enabled.
 
 Transaction
 -----------
-Sample 1: Demonstrates the usage of EnlistTransaction API. <br>
-Sample 2: Demonstrates the usage of TransactionScope. <br>
-Sample 3: Demonstrates nested transactions with savepoints.
+* Sample 1: Demonstrates the usage of EnlistTransaction API. <br>
+* Sample 2: Demonstrates the usage of TransactionScope. <br>
+* Sample 3: Demonstrates nested transactions with savepoints.
 
 User-Defined Types (UDT)
 ------------------------
-Nested Table Sample: Demonstrates how to map, fetch, and manipulate a nested table of UDTs that has an inheritance hierarchy (i.e. parent and child types). <br>
-Object UDT Sample: Demonstrates how to map, fetch, and manipulate an Oracle UDT as a .NET custom object. <br>
-Spatial UDT Sample: Demonstrates how to map and fetch types similar to Oracle Spatial types as custom types. <br>
-Ref Sample: Demonstrates how to fetch UDTs referenced by REFs. <br>
-Ref Inheritance Sample: Demonstrates how to obtain and update Custom Type objects from OracleRef objects. <br>
-VARRAY Sample: Demonstrates how to map, fetch, and manipulate the Oracle VARRAY as a custom object. 
+* Nested Table Sample: Demonstrates how to map, fetch, and manipulate a nested table of UDTs that has an inheritance hierarchy (i.e. parent and child types). <br>
+* Object UDT Sample: Demonstrates how to map, fetch, and manipulate an Oracle UDT as a .NET custom object. <br>
+* Spatial UDT Sample: Demonstrates how to map and fetch types similar to Oracle Spatial types as custom types. <br>
+* Ref Sample: Demonstrates how to fetch UDTs referenced by REFs. <br>
+* Ref Inheritance Sample: Demonstrates how to obtain and update Custom Type objects from OracleRef objects. <br>
+* VARRAY Sample: Demonstrates how to map, fetch, and manipulate the Oracle VARRAY as a custom object.